---
title: "List all payment institutions"
method: GET
path: "/payments/br/institutions/"
tags: ["Payment Institutions (Brazil)"]
---

# List all payment institutions

`GET /payments/br/institutions/`

List all available payment institutions.

## Query parameters

- `page` integer
- `page_size` integer
- `name` string
- `institution_type` 'INDIVIDUAL' | 'BUSINESS'
- `id__in` string[]

## Response `200`

OK

- object
  - `count` integer — The total number of results in your Belvo account.
  - `next` string, uri, nullable — The URL to next page of results. Each page consists of up to 100 items. If there are not enough results for an additional page, the value is `null`. In our documentation example, we use `{endpoint}` as a placeholder value. In production, this value will be replaced by the actual endpoint you are currently using (for example, `accounts` or `owners`).
  - `previous` string, uri, nullable — The URL to the previous page of results. If there is no previous page, the value is `null`.
  - `results` PaymentInstitutionBR[] — Array of institution objects.
    - `id` string, uuid, required — Belvo's unique ID to reference the institution.
    - `code` string — The ISPB code of the institution.
    - `active` boolean, required — Indicates whether this institution is available for use or not.
    - `institution_type` 'BUSINESS' | 'INDIVIDUAL' — The type of institution. Can be either `BUSINESS` or `INDIVIDUAL`.
    - `name` string, required — The name of the institution, as designated by Belvo.
    - `display_name` string, required — The customer-facing name of the institution.
    - `legal_entity_name` string, nullable, required — The name of the legal entity of the institution, as registered with the relevant regulatory authority. Only applicable for 🇧🇷 Brazil OFPI.
    - `website` string, required — The URL of the institution's website.
    - `logo` string, required — The URL of the institution's logo.
    - `icon_logo` string, required — The URL of the institution's icon logo.
    - `text_logo` string, required — The URL of the institution's text logo.
    - `primary_color` string, required — The primary color on the institution's website.
    - `country` string, required — The country that the institution is located in. For Brazil, this is always set to `BRA`.
    - `form_fields` unknown[], nullable, required — This field is not applicable for OFPI and will return an empty array.
      - unknown
    - `sort_priority` integer, required — Number that represents the order in which the institution should be displayed in an application, with `1` being the highest.
    - `description` string, nullable, required — A brief description of the insitution.

## Other responses

- `401` — Unauthorized
- `403` — Access to Belvo API denied
- `404` — Not Found Error
- `408` — Request Timeout
- `500` — Unexpected Error

---

[API](https://skmtc.net/belvo/apis/belvo-api-docs.md) · [All operations](https://skmtc.net/belvo/apis/belvo-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/belvo/belvo-api-docs/revisions/e82dca4a4b97/schema)