---
title: "List collection instructions"
method: GET
path: "/api/collection-instructions/"
tags: ["Collection Instructions (Brazil)"]
---

# List collection instructions

`GET /api/collection-instructions/`

## Request

- Base URL: `https://sandbox.belvo.com`
- URL: `https://sandbox.belvo.com/api/collection-instructions/`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/belvo/apis/belvo-api-docs/docs/api/collection-instructions/get.ts> (a function with typed inputs; its response is checked against the schema)

List the collection instructions of your organization. The response is an array of summaries without the items. To see the items and their statuses, get the instruction's details.

The response is **not paginated**: it returns every instruction that matches your filters, in no guaranteed order. Use `status`, `consent_id`, `created_after`, and `created_before` to keep the response small. Belvo ignores any other query parameter.

**Errors:** A filter value that is not valid (for example, an unknown `status` or a date that is not `YYYY-MM-DD`) returns a `500` error.

## Query parameters

- `status` 'PROCESSING' | 'COMPLETED' | 'CANCELLED': The status of the collection instruction. Can be one of: - `PROCESSING`: The instruction was created. It stays in this status until you cancel it, even after every item has reached a final status. Check each item's `status` to see how monitoring ended. - `COMPLETED`: Reserved for future use. Belvo does not currently set this status. - `CANCELLED`: You cancelled the instruction. Any items that were still `PENDING` or `PROCESSING` were cancelled too.
- `consent_id` string
- `created_after` string, date
- `created_before` string, date

## Response `200`

Ok

- CollectionInstructionSummary[]
  - `id` string, uuid, required: The unique identifier of the collection instruction.
  - `link_id` string, uuid, required: The `link.id` whose accounts Belvo monitors for this instruction.
  - `consent_id` string, nullable, required: The ID of the Open Finance data consent that Belvo found for the Link when you created the instruction. You can use this value in the `consent_id` filter.
  - `status` 'PROCESSING' | 'COMPLETED' | 'CANCELLED', required: The status of the collection instruction. Can be one of: - `PROCESSING`: The instruction was created. It stays in this status until you cancel it, even after every item has reached a final status. Check each item's `status` to see how monitoring ended. - `COMPLETED`: Reserved for future use. Belvo does not currently set this status. - `CANCELLED`: You cancelled the instruction. Any items that were still `PENDING` or `PROCESSING` were cancelled too.
  - `created_at` string, date-time, required: The date and time, in ISO-8601 format (UTC), when Belvo created the instruction.
  - `updated_at` string, date-time, required: The date and time, in ISO-8601 format (UTC), when the instruction's status last changed.

## Other responses

- `401`: Unauthorized
- `403`: Permission denied
- `408`: Request Timeout
- `500`: Server error

## Changes

- **2026-10-21** `acb784e42ca0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/belvo/apis/belvo-api-docs/changes/api/collection-instructions/get.md)

---

[API](https://skmtc.dev/belvo/apis/belvo-api-docs.md) - [All operations](https://skmtc.dev/belvo/apis/belvo-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/belvo/apis/belvo-api-docs/revisions/acb784e42ca0?raw)