API REFERENCE
List own driver push-device registrations
GET
/api/v1/driver/push-devicesList active push-device registrations owned by this driver session. Tokens registered for other drivers or businesses are not returned.
Authentication
Requires a driver bearer session. Administrator sessions and integration keys cannot perform this driver action.
Parameters
No path or query parameters.
Request
No JSON request body is required.
Example request
Replace synthetic identifiers and credentials. Example dates, coordinates, revisions, and IDs are not production defaults. Read the workflow guide before making a write.
curl --request GET 'https://route-api.okok.space/api/v1/driver/push-devices' \
--header 'Authorization: Bearer REPLACE_WITH_DRIVER_TOKEN'Responses
Examples illustrate the documented shape; optional fields and current state can differ. JSON extraction/body-limit errors may be plain text.
200 · Successful response
application/json
| Field | Type | Description & constraints |
|---|---|---|
items | array<object> | Records visible in the authorized context. |
items[] fields
| Field | Type | Description & constraints |
|---|---|---|
items.id | string | Identifier unique within its authorized business. Some create operations generate it when omitted. |
items.created_at | string | RFC3339 UTC instant or explicit offset; business wall times are resolved separately.Format: date-time |
items.updated_at | string | RFC3339 UTC instant or explicit offset; business wall times are resolved separately.Format: date-time |
items.revision | integer | Current version used to detect stale edits or publication. |
items.deleted_at | string | null | System-managed UTC soft-deletion instant; null for active records.Format: date-time |
items.deleted_by | string | null | Deletion actor retained for history.Format: uuid |
Illustrative response
{
"items": [
{
"id": "example-id",
"created_at": "2026-11-02T09:00:00Z",
"updated_at": "2026-11-02T09:00:00Z",
"revision": 1,
"deleted_at": "2026-11-02T09:00:00Z",
"deleted_by": "11111111-1111-4111-8111-111111111111"
}
]
}Response schema
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Record"
}
}
}
}401 · Invalid/revoked driver session
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "unauthorized",
"message": "Invalid/revoked driver session"
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}403 · Required driver permission denied
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "unauthorized",
"message": "Required driver permission denied"
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}404 · Not found in own business
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "not_found",
"message": "Not found in own business"
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}422 · Validation failed
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "validation",
"message": "Validation failed"
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}503 · Required infrastructure unavailable
application/json
| Field | Type | Description & constraints |
|---|---|---|
errorRequired | object | Resource-specific value; see the related workflow and schema. |
error fields
| Field | Type | Description & constraints |
|---|---|---|
error.codeRequired | validation | unauthorized | not_found | conflict | unavailable | rate_limited | Private activation or recovery code supplied to the driver. |
error.messageRequired | string | Resource-specific value; see the related workflow and schema. |
Illustrative response
{
"error": {
"code": "unavailable",
"message": "Required infrastructure unavailable"
}
}Response schema
{
"$ref": "#/components/schemas/Error"
}