Get todo

Returns the details of a single todo.

Note: This endpoint returns the todo even if it has been deleted (deleted: true).

Request

GET /api/oauth/v2/resource/todos/{uuid}

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

Parameter	Type	Required	Description
uuid	string	Yes	Unique todo ID

Response

Success (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "number": "A-0001",
    "name": "Call back patient",
    "description": "Call back about rescheduling the appointment",
    "priority": "normal",
    "dueDate": "2026-06-10T00:00:00+02:00",
    "status": "c3d4e5f6-a7b8-9012-cdef-345678901234",
    "tags": ["e5f6a7b8-9012-3456-ef01-567890123456"],
    "assignedTo": "d4c5b6a7-8901-2345-6789-0abcdef12345",
    "customer": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
    "createdAt": "2026-06-01T08:15:00+02:00",
    "updatedAt": "2026-06-08T11:42:00+02:00",
    "createdBy": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "updatedBy": "1a2b3c4d-5e6f-7890-abcd-ef1234567890",
    "deleted": false,
    "deletedAt": null
  }
}

Response fields

Field	Type	Description
data.id	string (UUID)	Unique todo ID
data.number	string	Sequential todo number (e.g. A-0001)
data.name	string	Title of the todo
data.description	string | null	Description
data.priority	string	Priority (low, medium, normal, high, critical)
data.dueDate	string | null	Due date (ISO 8601, time of day is always 00:00:00)
data.status	string (UUID) | null	Assigned status. Look up via Get status
data.tags	Array (string, UUID)	UUIDs of the assigned tags. Look up via Get tag
data.assignedTo	string (UUID) | null	Assigned staff member. Look up via GET /users/{uuid}
data.customer	string (UUID) | null	Assigned customer. Look up via GET /customers/{uuid}
data.createdAt	string	Creation timestamp (ISO 8601)
data.updatedAt	string	Timestamp of the last change (ISO 8601)
data.createdBy	string (UUID) | null	User who created the todo. Look up via GET /users/{uuid}
data.updatedBy	string (UUID) | null	User who made the last change
data.deleted	boolean	true if the todo has been deleted
data.deletedAt	string (ISO 8601) | null	Deletion timestamp, null if not deleted

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/todos/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope todos not present
404	not_found	Todo not found