Get Locations Ids

To create a delivery you need to send us ID of: the provincia (state) requires country id, canton (province) that required provincia id and distrito (district) that required province id.

Get the List of countries

GET https://api-sandbox.condorexpres.com/api/v1/public/location/countries

Headers

Name	Type	Description
x-access-token*	String	Bearer token

200: OK List of countries Returned

{
	"success": true,
	"message": "Countries Returned",
	"data": [
		{
			"id": 1,
			"name": "Costa Rica"
		}
	]
}

Get the list of states/provincias

GET https://api-sandbox.condorexpres.com/api/v1/public/location/states/:countryid

Get the list of states/provincias, replace countryid with id returned from list countries.

Headers

Name	Type	Description
x-access-token*	String	Bearer token

200: OK

{
	"success": true,
	"message": "States Returned",
	"data": [
		{
			"id": 1,
			"label": "San José"
		},
		{
			"id": 2,
			"label": "Alajuela"
		},
		{
			"id": 3,
			"label": "Cartago"
		},
		{
			"id": 4,
			"label": "Heredia"
		},
		{
			"id": 5,
			"label": "Guanacaste"
		},
		{
			"id": 6,
			"label": "Puntarenas"
		},
		{
			"id": 7,
			"label": "Limón"
		}
	]
}

Get the list of cantones

GET https://api-sandbox.condorexpres.com/api/v1/public/location/canton/:stateid

Get the list of cantones/provinces, replace stateid with id returned from list states.

Headers

Name	Type	Description
x-access-token*	String	Bearer token

200: OK

{
	"success": true,
	"message": "Canton Returned",
	"data": [
		{
			"id": 1,
			"label": "San José"
		},
		{
			"id": 2,
			"label": "Escazú"
		},
		{
			"id": 3,
			"label": "Desamparados"
		},
		{
			"id": 4,
			"label": "Puriscal"
		},
		{
			"id": 5,
			"label": "Tarrazú"
		},
		{
			"id": 6,
			"label": "Aserrí"
		},
		{
			"id": 7,
			"label": "Mora"
		},
		{
			"id": 8,
			"label": "Goicoechea"
		},
		{
			"id": 9,
			"label": "Santa Ana"
		},
		{
			"id": 10,
			"label": "Alajuelita"
		},
		{
			"id": 11,
			"label": "Vásquez de Coronado"
		},
		{
			"id": 12,
			"label": "Acosta"
		},
		{
			"id": 13,
			"label": "Tibás"
		},
		{
			"id": 14,
			"label": "Moravia"
		},
		{
			"id": 15,
			"label": "Montes de Oca"
		},
		{
			"id": 16,
			"label": "Turrubares"
		},
		{
			"id": 17,
			"label": "Dota"
		},
		{
			"id": 18,
			"label": "Curridabat"
		},
		{
			"id": 19,
			"label": "Pérez Zeledón"
		},
		{
			"id": 20,
			"label": "León Cortéz Castro"
		}
	]
}

Get the list of districts

GET https://api-sandbox.condorexpres.com/api/v1/public/location/districts/:cantonid

Get the list of districts, replace cantonid with id returned from list canton.

Headers

Name	Type	Description
x-access-token*	String	Bearer token

200: OK

{
	"success": true,
	"message": "Districts Returned",
	"data": [
		{
			"id": 1,
			"label": "CARMEN"
		},
		{
			"id": 2,
			"label": "MERCED"
		},
		{
			"id": 3,
			"label": "HOSPITAL"
		},
		{
			"id": 4,
			"label": "CATEDRAL"
		},
		{
			"id": 5,
			"label": "ZAPOTE"
		},
		{
			"id": 6,
			"label": "SAN FRANCISCO DE DOS RÍOS"
		},
		{
			"id": 7,
			"label": "URUCA"
		},
		{
			"id": 8,
			"label": "MATA REDONDA"
		},
		{
			"id": 9,
			"label": "PAVAS"
		},
		{
			"id": 10,
			"label": "HATILLO"
		},
		{
			"id": 11,
			"label": "SAN SEBASTIÁN"
		}
	]
}