Quickstart

This guide takes you from no account to a successful API call.

1. Create a developer account

Sign up at developer.ceibo.me. Anonymous sessions can browse the dashboard, but minting and managing API keys requires a real account — keys are tied to a user for billing, attribution, and revocation.

2. Mint an API key

Open the dashboard

Once logged in, go to the API keys section.

Create a key

Give the key a memorable name (e.g. local-dev, staging-api). Names are unique per account.

The plaintext key is shown once. Copy it immediately and store it in a secrets manager — Ceibo never displays it again.

Note the constraints

Each account can have up to 5 active keys at a time. Revoke unused keys to free up slots; revocation is idempotent and the revoked_at timestamp is preserved for audit.

3. Make your first request

The public API lives at https://api.ceibo.me/v1. Authenticate every request with an x-api-key header.

curl https://api.ceibo.me/v1/countries?limit=5 \
  -H "x-api-key: $CEIBO_API_KEY"

const res = await fetch("https://api.ceibo.me/v1/countries?limit=5", {
  headers: { "x-api-key": process.env.CEIBO_API_KEY! },
});
const { data, meta } = await res.json();

import os, requests

res = requests.get(
    "https://api.ceibo.me/v1/countries",
    params={"limit": 5},
    headers={"x-api-key": os.environ["CEIBO_API_KEY"]},
)
res.raise_for_status()
payload = res.json()

A successful response returns a paginated envelope:

{
  "data": [
    {
      "id": 10,
      "name": "Argentina",
      "iso2": "AR",
      "iso3": "ARG",
      "continent": "South America"
    }
  ],
  "meta": { "page": 1, "limit": 5, "total": 195, "totalPages": 39 }
}

Next steps

Authentication

Header format, JWT vs. API keys, rotation, and tier model.

API reference

Pagination, filtering, error envelope, and every endpoint.

Manage keys

Revoke compromised keys, view usage, change tier.

Status

Health endpoint — returns 200 when the API is up.

Getting started

Concepts

1. Create a developer account

2. Mint an API key

3. Make your first request

Next steps

Authentication

API reference

Manage keys

Status

​1. Create a developer account

​2. Mint an API key

​3. Make your first request

​Next steps

Authentication

API reference

Manage keys

Status

1. Create a developer account

2. Mint an API key

3. Make your first request

Next steps