List Cost Centers

Endpoint

GET https://api.verifik.co/v2/cost-centers

Returns the cost centers on your account. Results are ordered by country, then by name.

headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

query parameters

active

Type: boolean
Required: No

true returns active cost centers only. false returns inactive ones. Omit it to return both.

country

Type: string
Required: No

ISO-2 country code, such as ES.

page

Type: number
Required: No

Page number, starting at 1.

limit

Type: number
Required: No

Items per page. Default 50, maximum 100.

Request Example

cURL

curl "https://api.verifik.co/v2/cost-centers?active=true&country=ES&page=1&limit=50" \
  -H "Authorization: Bearer $VERIFIK_TOKEN"

Node.js

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);
});

Python

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())

Response Example

200 OK

{
  "data": [
    {
      "_id": "6acfbdda92451bac5d0a7ebe",
      "client": "69c2b824295cd7d276e478ad",
      "name": "Spain operations",
      "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
}

Each item in data is a cost center object.

Error Responses

An invalid query, such as limit above 100 or a country that is not two letters:

{
  "message": "\"limit\" must be less than or equal to 100",
  "code": "MissingParameter"
}