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

# List supported countries

> Returns the list of countries currently supported by MoonPay.



## OpenAPI

````yaml GET /v3/countries
openapi: 3.0.0
info:
  title: Ramps & Swaps
  version: 1.0.0
servers:
  - url: https://api.moonpay.com
security: []
tags:
  - name: Account details
    description: >-
      Get your account details, including the verification status and the
      current fees.
  - name: On-ramp
    description: Get quotes and transaction details for buying cryptocurrencies.
  - name: Off-ramp
    description: Get quotes and transaction details for selling cryptocurrencies.
  - name: Swaps
    description: Get quotes and transaction details for swapping cryptocurrencies.
  - name: Data
    description: >-
      Get currently supported countries, currencies, and payment methods. Also
      check the customers's IP address restrictions.
  - name: DefiToken
    description: Retrieve token data and token lists for DeFi assets.
paths:
  /v3/countries:
    get:
      tags:
        - Data
      summary: List supported countries
      description: Returns the list of countries currently supported by MoonPay.
      operationId: getCountries
      responses:
        '200':
          description: Successful response — List of Countries
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Country'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Country:
      type: object
      properties:
        alpha2:
          type: string
          example: GB
          description: The country's ISO 3166-1 alpha-2 code.
        alpha3:
          type: string
          example: GBR
          description: The country's ISO 3166-1 alpha-3 code.
        isAllowed:
          type: boolean
          example: true
          description: Whether residents of this country can use the service.
        isBuyAllowed:
          type: boolean
          example: true
          description: Whether residents of this country can buy cryptocurrencies.
        isSellAllowed:
          type: boolean
          example: true
          description: Whether residents of this country can sell cryptocurrencies.
        name:
          type: string
          description: The country's name.
          example: United Kingdom
        supportedDocuments:
          type: array
          items:
            type: string
            enum:
              - additional_proof_of_income
              - driving_licence
              - national_identity_card
              - passport
              - proof_of_address
              - proof_of_income
              - residence_permit
              - selfie
          description: >
            A list of supported identity documents for the country.


            Possible values are: `additional_proof_of_income`,
            `driving_licence`, `national_identity_card`, `passport`,
            `proof_of_address`, `proof_of_income`, `residence_permit`, `selfie`
          example:
            - additional_proof_of_income
            - driving_licence
            - national_identity_card
            - passport
            - proof_of_address
            - proof_of_income
            - residence_permit
            - selfie
    Error:
      type: object
      properties:
        message:
          type: string
          description: A descriptive error message.
        type:
          type: string
          description: An error type.

````