---
title: "GET /api/v2/requisitions/"
method: GET
path: "/api/v2/requisitions/"
tags: ["requisitions"]
---

# GET /api/v2/requisitions/

`GET /api/v2/requisitions/`

## Request

- Base URL: `https://bankaccountdata.gocardless.com`
- URL: `https://bankaccountdata.gocardless.com/api/v2/requisitions/`
- Auth: HTTP bearer

Retrieve all requisitions belonging to the company

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Retrieve all requisitions

- PaginatedRequisitionList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` Requisition[], required
    - `id` string, uuid
    - `created` string, date-time, nullable: The date & time at which the requisition was created.
    - `redirect` string, uri, nullable, required: redirect URL to your application after end-user authorization with ASPSP
    - `status` 'CR' | 'ID' | 'LN' | 'RJ' | 'ER' | 'SU' | 'EX' | 'GC' | 'UA' | 'GA' | 'SA'
    - `institution_id` string, required: an Institution ID for this Requisition
    - `agreement` string, uuid: EUA associated with this requisition
    - `reference` string: additional ID to identify the end user
    - `accounts` string[]: array of account IDs retrieved within a scope of this requisition
    - `user_language` string: A two-letter country code (ISO 639-1)
    - `link` string, uri: link to initiate authorization with Institution
    - `ssn` string: optional SSN field to verify ownership of the account
    - `account_selection` boolean: option to enable account selection view for the end user
    - `redirect_immediate` boolean: enable redirect back to the client after account list received

## Other responses

- `400`: Unknown Fields
- `401`: Token is invalid or expired
- `403`: IP address not whitelisted
- `404`: Not found error
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api.md) - [All operations](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gocardless/apis/gocardless-bank-account-data-api/revisions/01fd14b88051?raw)