Listar centros de costo
Endpoint
GET https://api.verifik.co/v2/cost-centers
Devuelve los centros de costo de tu cuenta. El orden es por país y luego por nombre.
encabezados
| Nombre | Valor |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
parámetros de consulta
active
Tipo: boolean
Requerido: No
true devuelve solo los activos. false devuelve los inactivos. Si lo omites, devuelve ambos.
country
Tipo: string
Requerido: No
Código de país ISO-2, por ejemplo ES.
page
Tipo: number
Requerido: No
Número de página, desde 1.
limit
Tipo: number
Requerido: No
Elementos por página. 50 por defecto, hasta 100.
Ejemplo de solicitud
- cURL
- Node.js
- Python
curl "https://api.verifik.co/v2/cost-centers?active=true&country=ES&page=1&limit=50" \
-H "Authorization: Bearer $VERIFIK_TOKEN"
const axios = require("axios");
const config = {
method: "get",
url: "https://api.verifik.co/v2/cost-centers",
headers: {
"Content-Type": "application/json",
"Authorization": "Bearer YOUR_ACCESS_TOKEN"
},
params: {
active: true,
country: "ES",
page: 1,
limit: 50
}
};
axios.request(config)
.then((response) => {
console.log(JSON.stringify(response.data));
})
.catch((error) => {
console.log(error);
});
import os
import requests
response = requests.get(
"https://api.verifik.co/v2/cost-centers",
headers={"Authorization": f"Bearer {os.environ['VERIFIK_TOKEN']}"},
params={"active": "true", "country": "ES", "page": 1, "limit": 50},
)
print(response.json())
Ejemplo de respuesta
- 200 OK
{
"data": [
{
"_id": "6acfbdda92451bac5d0a7ebe",
"client": "69c2b824295cd7d276e478ad",
"name": "Operación España",
"code": "SPAIN-OPS",
"country": "ES",
"active": true,
"createdAt": "2026-10-14T17:37:30.469Z",
"updatedAt": "2026-10-14T17:37:30.469Z"
}
],
"total": 1,
"page": 1,
"pages": 1,
"limit": 50
}
Cada elemento de data es un objeto centro de costo.
Respuestas de error
Una consulta inválida, por ejemplo limit mayor que 100 o un country que no tiene dos letras:
{
"message": "\"limit\" must be less than or equal to 100",
"code": "MissingParameter"
}