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

# GET /api/v2/requisitions/{id}/

`GET /api/v2/requisitions/{id}/`

## Request

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

Retrieve a requisition by ID

## Path parameters

- `id` string, uuid, required

## Response `200`

Get requisition by ID

- Requisition: RequisitionSerializer.
  - `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`: Invalid ID
- `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)