> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tabsglobal.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Corridor Requirements

> Retrieve required beneficiary recipient schema and field rules across payout corridors.

Returns dynamic validation requirements and field definitions for each supported payment corridor (e.g. Nigerian NIP, US ACH/Wire, UK Faster Payments, SEPA).

### Scopes required

`beneficiaries:read` or `*`

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer API secret key formatted as `Bearer sk_live_...` or `Bearer sk_test_...`.
</ParamField>

### Response

<ResponseField name="corridors" type="object">
  Map of corridor codes and their required recipient parameters.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.tabsglobal.co/v1/beneficiaries/requirements" \
    -H "Authorization: Bearer sk_live_..."
  ```

  ```javascript Node.js theme={null}
  const response = await fetch("https://api.tabsglobal.co/v1/beneficiaries/requirements", {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.TABS_SECRET_KEY}`,
    },
  });

  const requirements = await response.json();
  console.log(requirements);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://api.tabsglobal.co/v1/beneficiaries/requirements",
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "NGN_NIP": {
      "currency": "NGN",
      "country": "NGA",
      "requiredFields": [
        { "field": "accountNumber", "type": "string", "length": 10 },
        { "field": "bankCode", "type": "string", "length": 3 },
        { "field": "accountName", "type": "string" }
      ]
    },
    "USD_WIRE": {
      "currency": "USD",
      "country": "USA",
      "requiredFields": [
        { "field": "routingNumber", "type": "string", "length": 9 },
        { "field": "accountNumber", "type": "string" },
        { "field": "recipientName", "type": "string" },
        { "field": "recipientAddress", "type": "string" }
      ]
    },
    "GBP_FPS": {
      "currency": "GBP",
      "country": "GBR",
      "requiredFields": [
        { "field": "sortCode", "type": "string", "length": 6 },
        { "field": "accountNumber", "type": "string", "length": 8 },
        { "field": "recipientName", "type": "string" }
      ]
    }
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.