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

# List supported countries

> Returns countries supported across live providers with flag URLs and supported subdivision codes, optionally filtered by category and partners. Provider scope rules:
- No Basic Auth and no `Meld-Account-Id`: results come from the global dataset.
- Basic Auth only: results are restricted to the authenticated identity's `providers` claim.
- `Meld-Account-Id` only: results are restricted to providers configured for that account.
- Both Basic Auth and `Meld-Account-Id`: results are restricted to the intersection of both provider sets.
- Explicit partner filters are intersected with the resolved provider scope.

Explicit `partners` filtering is intersected with the resolved provider scope.
If the effective provider scope contains no providers, this collection endpoint returns `200` with an empty result.



## OpenAPI

````yaml /openapi/networkpartner-20260203.json get /network-partner/supported/countries
openapi: 3.1.0
info:
  title: Network Partners
  version: '2026-02-03'
servers:
  - url: https://api.meld.io
security: []
paths:
  /network-partner/supported/countries:
    get:
      tags:
        - Supported
      summary: List supported countries
      description: >-
        Returns countries supported across live providers with flag URLs and
        supported subdivision codes, optionally filtered by category and
        partners. Provider scope rules:

        - No Basic Auth and no `Meld-Account-Id`: results come from the global
        dataset.

        - Basic Auth only: results are restricted to the authenticated
        identity's `providers` claim.

        - `Meld-Account-Id` only: results are restricted to providers configured
        for that account.

        - Both Basic Auth and `Meld-Account-Id`: results are restricted to the
        intersection of both provider sets.

        - Explicit partner filters are intersected with the resolved provider
        scope.


        Explicit `partners` filtering is intersected with the resolved provider
        scope.

        If the effective provider scope contains no providers, this collection
        endpoint returns `200` with an empty result.
      operationId: list-supported-countries
      parameters:
        - description: Provider category
          example: CRYPTO_ONRAMP
          name: category
          in: query
          schema:
            $ref: '#/components/schemas/Category'
        - description: Comma-separated partner ids
          example: BANXA,MOONPAY
          name: partners
          in: query
          schema:
            type: string
        - description: >-
            Optional. Base58 encoded account id. Restricts results to providers
            configured for the account. If Basic Auth is also present, the
            effective scope is the intersection of authenticated providers and
            account providers.
          name: Meld-Account-Id
          in: header
          schema:
            type: string
      responses:
        '200':
          description: Supported country list
          content:
            application/json:
              examples:
                supportedCountries:
                  summary: Matching supported countries
                  value:
                    countries:
                      - countryCode: US
                        name: United States
                        flag: https://cdn.meld.io/images-country/US/flag.svg
                        subdivisions:
                          - US-CA
                          - US-NY
                scopedSupportedCountries:
                  summary: >-
                    Account-scoped request returning only countries served by
                    the account's providers
                  value:
                    countries:
                      - countryCode: GB
                        name: United Kingdom
                        flag: https://cdn.meld.io/images-country/GB/flag.svg
                        subdivisions: []
              schema:
                $ref: '#/components/schemas/CountryResponse'
components:
  schemas:
    Category:
      type: string
      enum:
        - CRYPTO_ONRAMP
        - CRYPTO_OFFRAMP
        - CRYPTO_TRANSFER
        - BANK_LINKING
        - FIAT_PAYMENTS
        - CRYPTO_VIRTUAL_ACCOUNT_ONRAMP
        - CRYPTO_VIRTUAL_ACCOUNT_OFFRAMP
        - CUSTOMER_KYC
        - CRYPTO_ONRAMP_SWAP
        - CRYPTO_OFFRAMP_SWAP
      description: Categories of functionality offered by a service provider
    CountryResponse:
      type: object
      description: Response wrapper for countries
      properties:
        countries:
          type: array
          items:
            $ref: '#/components/schemas/Country'
          description: List of countries
    Country:
      type: object
      description: Country representation used in country and supported-country lists
      properties:
        countryCode:
          type: string
          examples:
            - US
          description: ISO 3166-1 alpha-2 country code
        name:
          type: string
          examples:
            - United States
          description: Country display name
        flag:
          type: string
          examples:
            - https://cdn.meld.io/images-country/US/flag.svg
          description: Country flag URL
        subdivisions:
          type: array
          examples:
            - - US-CA
              - US-NY
          items:
            type: string
          description: ISO 3166-2 subdivision codes supported for this country

````