> ## Documentation Index > Fetch the complete documentation index at: https://developer.fin.com/llms.txt > Use this file to discover all available pages before exploring further. # List Generic Country Codes > Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard. ## OpenAPI ````yaml GET /v1/countries openapi: 3.1.0 info: title: Fin.com API version: 1.0.0 description: >- A simple API specification for Fin.com, a financial services platform that provides a range of banking and payment solutions for businesses and individuals. This API allows developers to integrate Fin.com's services into their applications, enabling functionalities such as customer management, transaction processing, and access to financial data. servers: - url: https://sandbox.api.fin.com description: Sandbox server - url: https://api.fin.com description: Production server security: [] tags: - name: Authentication description: A modified OAuth 2.0 Client Credential Flow - name: Customers description: Customer management and document upload operations - name: Balances description: Retrieve wallet balance information - name: Catalogue description: | A set of endpoints to retrieve contextual data to assemble requests to fin.com's API - name: Beneficiaries description: Manage beneficiary accounts for payments and transfers - name: Transactions description: Transaction history and management for beneficiaries - name: Virtual Accounts description: Create and manage virtual accounts for USD to USDC conversions - name: Fees & FX Rates description: Retrieve fees and foreign exchange rates - name: Crypto Orchestration description: >- Accept crypto deposits from exchange and external wallets and settle them to a destination wallet paths: /v1/countries: get: tags: - Catalogue summary: List Generic Country Codes description: >- Retrieve a list of country specific codes following ISO 3166-1 alpha-3 standard parameters: - $ref: '#/components/parameters/PerPageParam' - $ref: '#/components/parameters/CurrentPageParam' responses: '200': description: List of countries retrieved successfully content: application/json: schema: type: object properties: data: type: object properties: pagination: $ref: '#/components/schemas/Pagination' countries: type: array items: type: object properties: code: type: string example: BLR name: type: string example: Belarus currency_code: type: string example: BYN phone_code: type: string example: '+375' flag_url: type: string format: uri example: https://flagcdn.com/by.svg postal_code: type: object properties: required: type: boolean example: true regex: type: string nullable: true example: \A\d{6}\Z example: data: pagination: current_page: 1 per_page: 20 total_page: 13 total: 248 countries: - code: AFG name: Afghanistan currency_code: AFN phone_code: '+93' flag_url: https://flagcdn.com/af.svg postal_code: required: true regex: \A\d{4}\Z - code: ALA name: Åland Islands currency_code: EUR phone_code: '+358' flag_url: https://flagcdn.com/ax.svg postal_code: required: true regex: \A22\d{3}\Z - code: ALB name: Albania currency_code: ALL phone_code: '+355' flag_url: https://flagcdn.com/al.svg postal_code: required: true regex: \A\d{4}\Z - code: DZA name: Algeria currency_code: DZD phone_code: '+213' flag_url: https://flagcdn.com/dz.svg postal_code: required: true regex: \A\d{5}\Z - code: ASM name: American Samoa currency_code: USD phone_code: +1-684 flag_url: https://flagcdn.com/as.svg postal_code: required: true regex: \A(96799)(?:[ \-](\d{4}))?\Z - code: AND name: Andorra currency_code: EUR phone_code: '+376' flag_url: https://flagcdn.com/ad.svg postal_code: required: true regex: \AAD[1-7]0\d\Z - code: AGO name: Angola currency_code: AOA phone_code: '+244' flag_url: https://flagcdn.com/ao.svg postal_code: required: false regex: null - code: AIA name: Anguilla currency_code: XCD phone_code: +1-264 flag_url: https://flagcdn.com/ai.svg postal_code: required: true regex: \A(?:AI-)?2640\Z - code: ATA name: Antarctica flag_url: https://flagcdn.com/aq.svg postal_code: required: false regex: null - code: ATG name: Antigua and Barbuda currency_code: XCD phone_code: +1-268 flag_url: https://flagcdn.com/ag.svg postal_code: required: false regex: null - code: ARG name: Argentina currency_code: ARS phone_code: '+54' flag_url: https://flagcdn.com/ar.svg postal_code: required: true regex: \A((?:[A-HJ-NP-Z])?\d{4})([A-Z]{3})?\Z - code: ARM name: Armenia currency_code: AMD phone_code: '+374' flag_url: https://flagcdn.com/am.svg postal_code: required: true regex: \A(?:37)?\d{4}\Z - code: ABW name: Aruba currency_code: AWG phone_code: '+297' flag_url: https://flagcdn.com/aw.svg postal_code: required: false regex: null - code: AUS name: Australia currency_code: AUD phone_code: '+61' flag_url: https://flagcdn.com/au.svg postal_code: required: true regex: \A\d{4}\Z - code: AUT name: Austria currency_code: EUR phone_code: '+43' flag_url: https://flagcdn.com/at.svg postal_code: required: true regex: \A\d{4}\Z - code: AZE name: Azerbaijan currency_code: AZN phone_code: '+994' flag_url: https://flagcdn.com/az.svg postal_code: required: true regex: \A\d{4}\Z - code: BHS name: Bahamas currency_code: BSD phone_code: +1-242 flag_url: https://flagcdn.com/bs.svg postal_code: required: false regex: null - code: BHR name: Bahrain currency_code: BHD phone_code: '+973' flag_url: https://flagcdn.com/bh.svg postal_code: required: true regex: \A(?:\d|1[0-2])\d{2}\Z - code: BGD name: Bangladesh currency_code: BDT phone_code: '+880' flag_url: https://flagcdn.com/bd.svg postal_code: required: true regex: \A\d{4}\Z - code: BRB name: Barbados currency_code: BBD phone_code: +1-246 flag_url: https://flagcdn.com/bb.svg postal_code: required: true regex: \ABB\d{5}\Z '401': $ref: '#/components/responses/AuthenticationError' security: - bearerAuth: [] components: parameters: PerPageParam: name: per_page in: query description: Number of items to return per page required: false schema: type: integer default: 10 minimum: 1 maximum: 512 CurrentPageParam: name: current_page in: query description: The page number to retrieve required: false schema: type: integer default: 1 minimum: 1 schemas: Pagination: type: object properties: current_page: type: integer example: 1 per_page: type: integer example: 10 total_page: type: integer example: 1 total: type: integer example: 10 responses: AuthenticationError: description: Authentication failed due to invalid credentials content: application/json: schema: type: object properties: message: type: string example: Authentication failed securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Bearer token authentication. Obtain token from [Issue a Token](https://developer.fin.com/api-reference/authentication/issue-a-token) endpoint ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.