Quickstart

Make your first authenticated request in under five minutes.

Mint a token#

Open Account → API tokens, create a token with the read scope, and copy it. A read token is enough for this walkthrough.

Screenshot: Creating a read-scoped token at Account → API tokens

Make a test request#

Call GET /credits — the simplest authenticated endpoint — to confirm your token works. Swap cornect_your_token_here for your real token.

curl -X GET https://api.cornect.io/api/v1/credits \
  -H "Authorization: Bearer cornect_your_token_here"

Interpret the response#

A successful call returns your workspace's balance:

json

{
  "workspace_id": "5b2fa9e8-...",   // your workspace
  "balance": 1250,                   // credits remaining
  "recent_transactions": [           // most-recent first
    { "id": "...", "amount": -3, "reason": "export_charge", "reference": "export:…", "created_at": "2026-05-28T12:00:00Z" }
  ]
}

Run a real query#

Now search the company index. POST /companies/search accepts filters in the body and returns matching companies plus a next_cursor for pagination.

curl -X POST https://api.cornect.io/api/v1/companies/search \
  -H "Authorization: Bearer cornect_your_token_here" \
  -H "Content-Type: application/json" \
  -d '{"query":"fintech","countries":["US"],"employee_count_min":50}'

Next steps

Browse the full API Reference, learn pagination, or read how credits work before creating exports.