# Resolve how ingest routes device serials

Canonical page: https://docs.ovok.com/slim-apis/device/resolve-how-ingest-routes-device-serials

| Method | Path |
| --- | --- |
| `POST` | `/v1/slim/device/routing` |

[Authentication](/authentication) · [Access policies](/access-policies)

For each serial you send, returns the manufacturer and model that ingest files it under, and whether ingest accepts the serial at all. Use it to check serials before you create devices or send data.

**Auth:** bearer token. The caller must be a practitioner, an admin or a System Owner, and needs `Device:read`.

## Request [#request]

### Body [#body]

The body is strict: a field that is not listed here fails validation.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `serials` | `string[]` | Yes | Serials to check. 1 to 500 entries, each at most 64 characters. |

## Behaviour [#behaviour]

- Send 1 to 500 serials, each at most 64 characters.
- Rows come back in the order you sent them.
- `routable: false` means ingest rejects the serial with `400`. `manufacturer` and `model` are then `null`.
- The serial alone decides the result. A manufacturer that ingest only accepts when named explicitly, such as Masimo, is never inferred from a serial.
- Nothing is read or written. The result is computed from the serial only.

## Example [#example]

```bash
curl -X POST 'https://api.sandbox.ovok.com/v1/slim/device/routing' \
  -H "Authorization: Bearer ${OVOK_TOKEN}" \
  -H 'Content-Type: application/json' \
  -d '{"serials": ["3001000", "12,34"]}'
```


## Successful response [#successful-response]

`200` — Manufacturer, model and routability per serial.

```json
{
  "resources": [
    { "serial": "3001000", "manufacturer": "Sleepiz", "model": "OnePlus", "routable": true },
    { "serial": "12,34", "manufacturer": null, "model": null, "routable": false }
  ]
}
```

| Field | Type | Description |
| --- | --- | --- |
| `resources` | `object[]` | One result per serial, in the order you sent them. |
| `resources[].serial` | `string` | The serial you sent. |
| `resources[].manufacturer` | `string \| null` | Manufacturer ingest files the serial under: `Sleepiz`, `Maifar` or `Withings`. `null` when not routable. |
| `resources[].model` | `string \| null` | Model ingest files the serial under: `OnePlus`, `60SP` or `SleepAnalyzer`. `null` when not routable. |
| `resources[].routable` | `boolean` | `false` when ingest refuses the serial. A serial is accepted when it has 1 to 64 letters, digits, `.`, `_` or `-`. |

## Errors [#errors]

| Status | Meaning |
| --- | --- |
| [`401`](/errors/unauthenticated) | Bearer token is missing, invalid or expired. |
| [`403`](/errors/forbidden) | You are not a practitioner, admin or System Owner, you lack `Device:read`, or your session has no project. |
| [`422`](/errors/validation-failed) | The body fails validation. |
