> ## Documentation Index
> Fetch the complete documentation index at: https://nayax-44d6e37b-docs-marshall-faq-redistribution.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Countries

> Retrieves a list of countries, optionally filtered by `CountryID` or `DialCode`.



## OpenAPI

````yaml /openapi/lynx.yaml get /v1/countries
openapi: 3.0.1
info:
  title: Nayax Operational Lynx API
  version: v1
servers:
  - url: https://qa-lynx.nayax.com/operational
security:
  - Authorization: []
paths:
  /v1/countries:
    get:
      tags:
        - Lookups
      summary: Get Countries
      description: >-
        Retrieves a list of countries, optionally filtered by `CountryID` or
        `DialCode`.
      operationId: get-countries
      parameters:
        - name: CountryID
          in: query
          description: The unique identifier of the country to filter the results.
          schema:
            type: integer
            format: int32
        - name: DialCode
          in: query
          description: The dialing code of the country to filter the results.
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: A list of countries matching the specified criteria.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/CountryCodes'
components:
  schemas:
    CountryCodes:
      type: object
      description: >-
        Represents detailed information about a country, including its
        identifiers, name, and dialing code.
      properties:
        CountryID:
          type: integer
          format: int32
          nullable: true
          description: The unique identifier of the country.
        CountryCode:
          type: string
          nullable: true
          description: >-
            The ISO 3166-1 alpha-2 code of the country (e.g., "US" for the
            United States).
        CountryName:
          type: string
          nullable: true
          description: The full name of the country.
        CountryDialingCode:
          type: integer
          format: int32
          nullable: true
          description: >-
            The international dialing code for the country (e.g., 1 for the
            United States).
        CountryReference:
          type: integer
          format: int32
          nullable: true
          description: An internal reference number associated with the country.
        CountryISONumericCode:
          type: integer
          format: int32
          nullable: true
          description: >-
            The ISO 3166-1 numeric code of the country (e.g., 840 for the United
            States).
      additionalProperties: false
  securitySchemes:
    Authorization:
      type: http
      scheme: bearer
      description: Enter your Bearer token. It's required to authenticate API requests.

````