---
title: "Get the fields a currency needs"
method: GET
path: "/gateway/bank-accounts/requirements"
tags: ["Bank Accounts"]
---

# Get the fields a currency needs

`GET /gateway/bank-accounts/requirements`

## Request

- Base URL: `https://api.agentaos.ai/api/v1`
- URL: `https://api.agentaos.ai/api/v1/gateway/bank-accounts/requirements`
- Auth: API key in header `x-api-key`

The form schema for a bank account in this currency. Render it, then send the answers to `POST /gateway/bank-accounts`. Works with a test or a live key.

## Query parameters

- `currency` string, required

## Response `200`

The fields.

- BankAccountRequirements: The fields a bank account in this currency needs, as a form schema: one entry per account type (`iban` for EUR, `aba` for USD), each with its fields, their validation and whether changing one refreshes the rest.
  - `quoteId` string, required: Pass back to `requirements/refresh` when a field marked `refreshRequirementsOnChange` changes.
  - `requirements` object[], required

## Other responses

- `401`: Missing or invalid `x-api-key`.
- `403`: The key does not manage the business named in `AgentaOS-Account`.

---

[API](https://skmtc.dev/agentaos/apis/agentaos-gateway-api.md) · [All operations](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentaos/apis/agentaos-gateway-api/revisions/3a8ad3c6b965?raw)