Cardexio Public API

Authentication

Every request requires the Authorization: Bearer cdx_live_… header. Generate a key from Profile → API Keys. The token is shown only once at creation; the server stores a SHA-256 hash.

curl -H "Authorization: Bearer cdx_live_xxxxxxxxxxxxxxxx" \
  https://app.cardexio.com/api/v1/contacts

Rate limit

100 requests per 60-second sliding window, per API key. When exceeded, you receive 429 Too Many Requests + Retry-After header.

Base URL

https://app.cardexio.com/api/v1

Contacts

List

GET /api/v1/contacts

Query parameters:

• limit — 1..100, default 50
• cursor — ISO timestamp; for pagination use next_cursor from the previous response
• email — exact match (lowercase)

{
  "data": [
    {
      "id": "uuid",
      "full_name": "Jane Doe",
      "job_title": "Head of Sales",
      "company_name": "Acme Ltd",
      "email": "jane@acme.com",
      "phone": "+44 20 1234 5678",
      "country": "United Kingdom",
      "country_code": "GB",
      "linkedin_url": "https://linkedin.com/in/...",
      "follow_up_status": "meeting_scheduled",
      "source_event": "Web Summit Lisbon 2026",
      "created_at": "2026-04-10T14:32:11Z",
      "updated_at": "2026-04-12T09:18:55Z"
    }
  ],
  "next_cursor": "2026-04-10T14:32:11Z",
  "has_more": true
}

Single record

GET /api/v1/contacts/{id}

Returns 400 invalid_id on malformed UUID; 404 not_found for records outside your workspace or deleted.

Companies

List

GET /api/v1/companies

Query parameters:

• limit — 1..100, default 50
• cursor — ISO timestamp
• name — partial match (case-insensitive)

{
  "data": [
    {
      "id": "uuid",
      "name": "Acme Ltd",
      "industry": "Manufacturing",
      "website": "https://acme.com",
      "phone": "+44 20 1234 5678",
      "formatted_address": "1 Main St, London, UK",
      "country_code": "GB",
      "google_rating": 4.5,
      "enrichment_status": "enriched",
      "created_at": "2026-04-08T10:14:32Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

Single record

GET /api/v1/companies/{id}

Error codes

Roadmap

• v1 (now): read-only — contacts, companies
• v1.1: filtering (date range, follow_up_status, country_code)
• v2: write endpoints (create/update/delete) + webhooks

Questions: support@cardexio.com