> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Deprecated Endpoints

> List of deprecated API endpoints and their replacement endpoints. Please migrate to the new endpoints as deprecated endpoints may be removed in future versions.

## Overview

This page lists all deprecated API endpoints and their recommended replacements. Deprecated endpoints remain functional but may be removed in future API versions. We strongly recommend migrating to the new endpoints as soon as possible.

<Warning>
  Deprecated endpoints will continue to work but may be removed in a future API version. Please migrate to the new endpoints to ensure your integration continues to work.
</Warning>

## Deprecated Endpoints

### QR Code Management

| Deprecated Endpoint        | Replacement Endpoint   | Method                  | Notes                                 |
| :------------------------- | :--------------------- | :---------------------- | :------------------------------------ |
| `/qrcode/`                 | `/qr/`                 | GET, POST               | List and create QR codes              |
| `/qrcode/{qrid}/`          | `/qr/{qrid}/`          | GET, PUT, PATCH, DELETE | Retrieve, update, or delete a QR code |
| `/qrcode/{qrid}/download/` | `/qr/{qrid}/download/` | GET                     | Download QR code image                |
| `/qrcode/category/`        | `/qr/category/`        | GET                     | List QR code categories               |
| `/qrcode/validate-info/`   | `/qr/validate-info/`   | POST                    | Validate QR code info payload         |
| `/qrcode/trash/`           | `/qr/trash/`           | GET                     | List trashed QR codes                 |
| `/qrcode/trash/restore/`   | `/qr/trash/restore/`   | POST                    | Restore trashed QR codes              |
| `/qrcode/trash/delete/`    | `/qr/trash/delete/`    | POST                    | Permanently delete trashed QR codes   |

### Analytics

| Deprecated Endpoint  | Replacement Endpoint    | Method | Notes                      |
| :------------------- | :---------------------- | :----- | :------------------------- |
| `/analytics/qrcode/` | `/analytics/qr/`        | POST   | Get QR code analytics data |
| `/analytics/export/` | `/analytics/qr/export/` | POST   | Export analytics data      |

### User Management

| Deprecated Endpoint  | Replacement Endpoint          | Method                  | Notes                                   |
| :------------------- | :---------------------------- | :---------------------- | :-------------------------------------- |
| `/user/`             | `/auth/user/`                 | GET, PUT, PATCH         | Get or update user details              |
| `/shared-user/`      | `/multi-users/`               | GET, POST               | List or create shared users             |
| `/shared-user/{pk}/` | `/multi-users/{pk}/`          | GET, PUT, PATCH, DELETE | Retrieve, update, or delete shared user |
| `/access-level/`     | `/multi-users/access-levels/` | GET, POST               | List or create access levels            |

### Account & Stats

| Deprecated Endpoint | Replacement Endpoint | Method | Notes                    |
| :------------------ | :------------------- | :----- | :----------------------- |
| `/stats/`           | `/auth/stats/`       | GET    | Get account statistics   |
| `/current/`         | `/plans/current/`    | GET    | Get current plan details |

### Tags

| Deprecated Endpoint | Replacement Endpoint | Method | Notes     |
| :------------------ | :------------------- | :----- | :-------- |
| `/tags/`            | `/tag/list/`         | GET    | List tags |

## Migration Examples

### QR Code Endpoints

**Before (Deprecated):**

```bash theme={null}
# List QR codes
curl -X GET "https://management.scanova.io/qrcode/" \
  -H "Authorization: YOUR_API_KEY"

# Create QR code
curl -X POST "https://management.scanova.io/qrcode/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My QR Code", "category": 1, ...}'

# Get QR code details
curl -X GET "https://management.scanova.io/qrcode/Qf94b25d768294148/" \
  -H "Authorization: YOUR_API_KEY"
```

**After (New):**

```bash theme={null}
# List QR codes
curl -X GET "https://management.scanova.io/qr/" \
  -H "Authorization: YOUR_API_KEY"

# Create QR code
curl -X POST "https://management.scanova.io/qr/" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "My QR Code", "category": 1, ...}'

# Get QR code details
curl -X GET "https://management.scanova.io/qr/Qf94b25d768294148/" \
  -H "Authorization: YOUR_API_KEY"
```

### Analytics Endpoints

**Before (Deprecated):**

```bash theme={null}
# Get analytics
curl -X POST "https://management.scanova.io/analytics/qrcode/?from=2025-01-01&to=2025-01-31" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter_by": "qrid", "q": ["Qf94b25d768294148"]}'

# Export analytics
curl -X POST "https://management.scanova.io/analytics/export/?from=2025-01-01&to=2025-01-31&file_format=xlsx" \
  -H "Authorization: YOUR_API_KEY" \
  -F "filter_by=qrid" \
  -F "q=Qf94b25d768294148"
```

**After (New):**

```bash theme={null}
# Get analytics
curl -X POST "https://management.scanova.io/analytics/qr/?from=2025-01-01&to=2025-01-31" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"filter_by": "qrid", "q": ["Qf94b25d768294148"]}'

# Export analytics
curl -X POST "https://management.scanova.io/analytics/qr/export/?from=2025-01-01&to=2025-01-31&file_format=xlsx" \
  -H "Authorization: YOUR_API_KEY" \
  -F "filter_by=qrid" \
  -F "q=Qf94b25d768294148"
```

### User Management Endpoints

**Before (Deprecated):**

```bash theme={null}
# List shared users
curl -X GET "https://management.scanova.io/shared-user/" \
  -H "Authorization: YOUR_API_KEY"

# Get access levels
curl -X GET "https://management.scanova.io/access-level/" \
  -H "Authorization: YOUR_API_KEY"

# Get user details
curl -X GET "https://management.scanova.io/user/" \
  -H "Authorization: YOUR_API_KEY"
```

**After (New):**

```bash theme={null}
# List shared users
curl -X GET "https://management.scanova.io/multi-users/" \
  -H "Authorization: YOUR_API_KEY"

# Get access levels
curl -X GET "https://management.scanova.io/multi-users/access-levels/" \
  -H "Authorization: YOUR_API_KEY"

# Get user details
curl -X GET "https://management.scanova.io/auth/user/" \
  -H "Authorization: YOUR_API_KEY"
```

## Migration Checklist

* [ ] Update all API calls to use new endpoint paths
* [ ] Update any hardcoded endpoint URLs in your codebase
* [ ] Test all endpoints after migration
* [ ] Update any documentation or scripts that reference deprecated endpoints
* [ ] Monitor for any deprecation warnings in API responses

## Support

If you need help migrating to the new endpoints, please contact our support team at [support@scanova.io](mailto:support@scanova.io).

<Note>
  The deprecated endpoints will continue to work for a transition period, but we recommend migrating as soon as possible to avoid any disruption when they are eventually removed.
</Note>