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

# List countries

> Lists active countries. Inactive countries are excluded.



## OpenAPI

````yaml /openapi/nimbo_public.yml get /api/v1/countries
openapi: 3.1.0
info:
  title: Nimbo catalogs and sites
  version: 0.1.0
  description: >-
    Nimbo API reference. Use the API host and integration access provided by
    Nimbo.
servers:
  - url: https://api.example.test
    description: Reference only; not a live API host
security: []
tags:
  - name: Countries
  - name: Catalogs
  - name: SAT Catalogs
  - name: Sites
  - name: Public Portals
  - name: Telehealth
paths:
  /api/v1/countries:
    get:
      tags:
        - Countries
      summary: List countries
      description: Lists active countries. Inactive countries are excluded.
      operationId: listCountries
      responses:
        '200':
          description: Active countries with the response root and state links.
          content:
            application/json:
              schema:
                type: object
                required:
                  - countries
                additionalProperties: false
                properties:
                  countries:
                    type: array
                    items:
                      type: object
                      required:
                        - abbrv
                        - country_code
                        - default_locale
                        - default_vademecum
                        - id
                        - links
                        - name_en
                        - name_es
                        - nationality_en
                        - nationality_es
                      additionalProperties: false
                      properties:
                        id:
                          type: integer
                          example: 1
                        name_en:
                          type: string
                          example: Mexico
                        name_es:
                          type: string
                          example: Mexico
                        abbrv:
                          type: string
                          example: MX
                        links:
                          type: object
                          required:
                            - states
                          additionalProperties: false
                          properties:
                            states:
                              type: string
                              example: /api/v1/countries/1/states
                        country_code:
                          type:
                            - string
                            - 'null'
                          example: '52'
                        default_locale:
                          type:
                            - string
                            - 'null'
                          example: es
                        nationality_es:
                          type:
                            - string
                            - 'null'
                          example: Mexicana
                        nationality_en:
                          type:
                            - string
                            - 'null'
                          example: Mexican
                        default_vademecum:
                          type:
                            - boolean
                            - 'null'
                          example: true
              examples:
                countries:
                  value:
                    countries:
                      - id: 1
                        name_en: Mexico
                        name_es: Mexico
                        abbrv: MX
                        links:
                          states: /api/v1/countries/1/states
                        country_code: '52'
                        default_locale: es
                        nationality_es: Mexicana
                        nationality_en: Mexican
                        default_vademecum: MX

````