BObokio
agency-todos

Retrieve todos for an agency user

Retrieve the current-state worklist for the specified agency user across all active client companies assigned to that user. Results are globally ordered and limited to 100 items.

Availability: When the service is under heavy load the request can return 503 with error code service-busy and a Retry-After header. Retry after the number of seconds given in the header.

Localization: Todo titles are localized based on the Accept-Language request header (sv or en). When the header is missing or the language is not supported, Swedish is used. The resolved language is returned in the Content-Language response header.

Scope: agency-todos:read

get/agencies/{agencyId}/users/{userId}/todos

Request

  • Base URL
    https://api.bokio.se/v1
  • URL
    https://api.bokio.se/v1/agencies/{agencyId}/users/{userId}/todos
  • Auth
    HTTP bearer

Headers

Accept-Language'sv' | 'en'

Preferred language for localized todo titles. Supported values are sv and en. Defaults to Swedish when omitted or unsupported.

Response

Todos found

companyIdstring uuid required

Unique identifier of the client company from which the todo originates

companyNamestring required

Name of the client company from which the todo originates

resourceType'none' | 'vat' | 'supplierInvoice' | 'invoice' | 'payment' | 'receipt' | 'expense' | 'inbox' | 'draftVerification' | 'assetDepreciation' | 'dailyTakings' | 'salary' | 'vacation'

Type of resource represented by the todo item

actionType'none' | 'toApprove' | 'toRecord' | 'toPay' | 'toSchedulePay' | 'getPaid' | 'toReview' | 'toComplete'

Action represented by the todo item

titlestring

Title shown for the todo item

totalAmountnumber double nullable

Amount associated with the todo item when applicable

datestring date

Primary date associated with the todo item

Example response

[
  {
    "companyId": "17c72e33-77d4-467d-8fe3-f9bd35b303f3",
    "companyName": "Example Company AB",
    "resourceType": "supplierInvoice",
    "actionType": "toPay",
    "title": "Match supplier payment",
    "totalAmount": 1500,
    "date": "2026-06-20"
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.