---
title: "List institutions for Billing Request"
method: GET
path: "/billing_requests/{billing_request_id}/institutions"
tags: ["Institution"]
---

# List institutions for Billing Request

`GET /billing_requests/{billing_request_id}/institutions`

## Request

- Base URL: `https://api.gocardless.com`
- URL: `https://api.gocardless.com/billing_requests/{billing_request_id}/institutions`
- Auth: HTTP bearer

Returns all institutions valid for a Billing Request.

This endpoint is currently supported only for FasterPayments.

<p class="restricted-notice"><strong>Restricted</strong>: this endpoint is restricted to [GoCardless Pro](https://gocardless.com/pricing) and [GoCardless Enterprise](https://gocardless.com/pricing) accounts with the [custom payment pages upgrade](https://hub.gocardless.com/s/article/Custom-payment-pages).</p>

## Path parameters

- `billing_request_id` string, required

## Query parameters

- `search` string
- `ids` string
- `country_code` string, required: [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) alpha-2 code. The country code of the institution. If nothing is provided, institutions with the country code 'GB' are returned by default.
- `include_disabled` 'true' | 'false': Indicates whether to include temporarily disabled institutions in the response. If not provided or set to false, only enabled institutions will be returned.

## Headers

- `GoCardless-Version` string, required

## Response `200`

Successful response

- object
  - `institutions` object[]
    - `id` string: The unique identifier for this institution
    - `name` string: A human readable name for this institution
    - `icon_url` string: A URL pointing to the icon for this institution
    - `logo_url` string: A URL pointing to the logo for this institution
    - `country_code` string: [ISO 3166-1](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) alpha-2 code. The country code of the institution. If nothing is provided, institutions with the country code 'GB' are returned by default.
    - `autocompletes_collect_bank_account` boolean: Flag to show if selecting this institution in the select_institution action can auto-complete the collect_bank_account action. The bank can return the payer's bank account details to GoCardless.
    - `status` 'enabled' | 'disabled' | 'temporarily_disabled': The status of the institution
  - `meta` InstitutionPaginationMeta: Cursor pagination information
    - `limit` integer, required
    - `cursors` object, required
      - `before` string, nullable, required: Cursor pointing to the end of the desired set.
      - `after` string, nullable, required: Cursor pointing to the start of the desired set.

## Other responses

- `400`: Bad Request
- `401`: Unauthorised
- `404`: Not found
- `422`: Validation Error
- `500`: Internal Error

---

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