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

# POST /api/v2/requisitions/

`POST /api/v2/requisitions/`

## Request

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

Create a new requisition

## Request body

- RequisitionRequest: RequisitionSerializer.
  - `redirect` string, uri, nullable, required: redirect URL to your application after end-user authorization with ASPSP
  - `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
  - `user_language` string: A two-letter country code (ISO 639-1)
  - `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

## Response `201`

Requisition has been successfully created

- SpectacularRequisition: Create requisition.
  - `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` unknown[]: array of account IDs retrieved within a scope of this requisition
    - unknown
  - `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`: Field is required
- `401`: Token is invalid or expired
- `402`: Free usage limit exceeded
- `403`: IP address not whitelisted
- `404`: Errors related to 'agreement' field.
- `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)