Distritos

Por último, una vez que ya tenemos nuestra provincia y nuestro cantón, podemos consultar los distritos. Para esto, usaremos el endpoint /distritos y le pasaremos el identificador de la provincia y del cantón que queremos consultar.

En este caso, usaremos el identificador 1 para limitar los cantones a San José. Y el identificador 02 para consultar los distritos de Escazú.

Es necesario incluir el identificador de la provincia para evitar ambigüedades. Por ejemplo, el cantón de San José (1) tiene un cantón con el identificador (02) y el cantón de Alajuela (2) también tiene un cantón con el identificador (02).

La concatenación de los identificadores de provincia, cantón y distrito conforman un código postal, en el caso de San Rafael de Escazú sería 10203.

Distritos por provincia y cantón

Obtén una lista de distritos filtrados por provincia y cantón.

Parámetros

Name
provincia
Type
string
Description
Identificador de provincia de 1 dígito.
Name
canton
Type
string
Description
Identificador de cantón de 2 dígitos.

Request

GET

/distritos/[provincia]/[canton]

curl https://territorios.fetchcr.com/distritos/1/02

Respuesta

[
  {
    "value": "01",
    "label": "Escazú"
  },
  {
    "value": "02",
    "label": "San Antonio"
  },
  {
    "value": "03",
    "label": "San Rafael"
  }
]

Concatenar provincia y cantón

Obtén una lista de distritos filtrados concatenando los identificadores territoriales.

Este ejemplo es equivalente al anterior, pero en este caso, concatenamos los identificadores de provincia y cantón para obtener el mismo resultado.

Parámetros

Name
concatenacion
Type
string
Description
Valor de 3 dígitos. Identificador de provincia de 1 dígito junto al identificador de cantón de 2 dígitos.

Request

GET

/distritos/[concatenacion]

curl https://territorios.fetchcr.com/distritos/102

Respuesta

[
  {
    "value": "01",
    "label": "Escazú"
  },
  {
    "value": "02",
    "label": "San Antonio"
  },
  {
    "value": "03",
    "label": "San Rafael"
  }
]

Todos los distritos

Obtén un objeto con la identificación territorial de la provincia y del cantón como clave y una lista de distritos como valor.

Request

GET

/distritos

curl https://territorios.fetchcr.com/distritos

Respuesta

{
  "101": [
    {
      "value": "01",
      "label": "Carmen"
    },
    {
      "value": "02",
      "label": "Merced"
    }
    ...
  ],
  "102": [
    {
      "value": "01",
      "label": "Escazú"
    },
    {
      "value": "02",
      "label": "San Antonio"
    }
    ...
  ],
}