---
title: "Fetch country codes"
method: GET
path: "/api/country"
tags: ["Onboarding"]
---

# Fetch country codes

`GET /api/country`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/api/country`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/api/country/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetch list of all countries and associated ISO codes.

## Query parameters

- `max` integer

## Response `200`

Successful operation

- CountryCodeDto[]
  - `allowRegistration` boolean: Indicates if registration is allowed.
  - `code` string: Country code.
  - `defaultCurrency` string: Default currency code.
  - `documents` object[]
    - `code` string: Document code.
    - `description` string: Description of the document.
    - `id` integer: Document identifier.
    - `required` boolean: Indicates if the document is required.
  - `id` integer: Unique identifier.
  - `name` string: Country name.
  - `options` object: Options related to transactions.
    - `minimumOrderValue` integer: Minimum order value.
    - `limitValue` integer: Limit value for transactions.
    - `minimumTransferValue` integer: Minimum value for transfers.
    - `minimumPartnerValue` integer: Minimum value for partner transactions.
    - `requireProofOfPayment` string: Indicates if proof of payment is required.
    - `supportInstantTransfer` boolean: Indicates if instant transfers are supported.
    - `unverifiedMaximum` string: Maximum value for unverified accounts.
    - `orderMinimumValue` string: Minimum value for orders.
    - `transferMinimumValue` string: Minimum value for transfers.
    - `withdrawalMaximum` string: Maximum withdrawal amount.
    - `withdrawalThreshold` string: Threshold for withdrawal transactions.
  - `region` string: Geographical region if applicable.

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)