Catalog

Read the supported countries and payment methods.

The catalog endpoints expose reference data — the active countries and payment methods configured on the platform. They are read-only and take no parameters.

List countries

GET /v1/countries — Scope: organization:read

Returns the active countries, each with its currency code where configured.

Request

bash

curl https://api.caiboglobal.com/v1/countries \
  -H "X-API-Key: $CAIBO_API_KEY"

Response — 200 OK

json

{
  "object": "list",
  "data": [
    { "id": "ctry_ca", "code": "CA", "name": "Canada", "currency": "CAD" },
    { "id": "ctry_us", "code": "US", "name": "United States", "currency": "USD" }
  ]
}

Field	Type	Description
`id`	string	Country id.
`code`	string	ISO-3166 alpha-2 code.
`name`	string	Country name.
`currency`	string	Currency code, when the country has one configured.

List payment methods

GET /v1/payment-methods — Scope: organization:read

Returns the active payment methods.

Request

bash

curl https://api.caiboglobal.com/v1/payment-methods \
  -H "X-API-Key: $CAIBO_API_KEY"

Response — 200 OK

json

{
  "object": "list",
  "data": [
    { "id": "pm_wire", "code": "WIRE", "name": "Wire transfer", "type": "BANK_TRANSFER" }
  ]
}

Field	Type	Description
`id`	string	Payment method id.
`code`	string	Machine code, e.g. `WIRE`.
`name`	string	Human-readable name.
`type`	string	Method type.

Errors

Both endpoints share the same error set:

HTTP	type	code	When
401	authentication_error	api_key_missing / api_key_invalid	No key, or an unknown/revoked key.
403	permission_error	scope_insufficient	The key lacks `organization:read`.
429	rate_limit_error	rate_limited	Too many requests.