---
title: "Retrieve todos for an agency user"
method: GET
path: "/agencies/{agencyId}/users/{userId}/todos"
tags: ["agency-todos"]
---

# Retrieve todos for an agency user

`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

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`

## Headers

- `Accept-Language` 'sv' | 'en'

## Response `200`

Todos found

- AgencyTodoItemGet[]
  - `companyId` string, uuid, required: Unique identifier of the client company from which the todo originates
  - `companyName` string, 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
  - `title` string: Title shown for the todo item
  - `totalAmount` number, double, nullable: Amount associated with the todo item when applicable
  - `date` string, date: Primary date associated with the todo item

## Other responses

- `404`: Agency or user not found
- `503`: The service is busy loading todos. Retry after the number of seconds in the `Retry-After` header.

---

[API](https://skmtc.dev/bokio/apis/agency-api.md) - [All operations](https://skmtc.dev/bokio/apis/agency-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/agency-api/revisions/2ec5b299f1d5?raw)