비용 센터 목록

엔드포인트

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

계정의 비용 센터를 반환합니다. 국가, 그다음 이름 순입니다.

헤더

이름	값
Content-Type	application/json
Authorization	Bearer <token>

쿼리 매개변수

active

타입: boolean
필수: 아니요

true는 활성만, false는 비활성만 반환합니다. 생략하면 둘 다 반환합니다.

country

타입: string
필수: 아니요

ISO-2 국가 코드. 예: ES.

page

타입: number
필수: 아니요

페이지 번호. 1부터.

limit

타입: number
필수: 아니요

페이지당 개수. 기본 50, 최대 100.

요청 예시

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

응답 예시

200 OK

{
  "data": [
    {
      "_id": "6acfbdda92451bac5d0a7ebe",
      "client": "69c2b824295cd7d276e478ad",
      "name": "스페인 운영",
      "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
}

data의 각 항목은 비용 센터 객체입니다.

오류 응답

잘못된 쿼리입니다. 예를 들어 limit이 100을 넘거나 country가 두 글자가 아닌 경우입니다.

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