Quickstart

1. Create an API key

Create an API key in the Incard dashboard. See Authentication for key limits and storage guidance.

2. Get an access token

Exchange your API key for a short-lived access token:

curl -sS -X POST "https://api.incard.com/developer/auth" \
  -H "Content-Type: application/json" \
  -d '{"api_key": "sk_YOUR_KEY"}'

Save the access_token from the response.

3. List invoices

Pass your company UUID in X-On-Behalf-Of — it selects which company the request applies to:

curl -sS "https://api.incard.com/developer/company/invoices" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-On-Behalf-Of: YOUR_COMPANY_ID"

Example response (truncated):

{
  "data": [
    {
      "id": "11111111-1111-4111-8111-000000000206",
      "public_id": "invoice_api_doc_list_001",
      "status": "pending",
      "due_date": "2027-02-01T00:00:00.000Z",
      "issued_at": "2027-01-01T00:00:00.000Z",
      "invoice_number": "INV-API-DOC-001",
      "amount": 100,
      "currency": "GBP",
      "line_items": [
        { ... }
      ]
    }
  ],
  "meta": { "total": 1, "take": 20, "skip": 0 }
}

4. Check your balances

The same headers work on every endpoint. List your accounts with their available balance:

curl -sS "https://api.incard.com/developer/company/accounts" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-On-Behalf-Of: YOUR_COMPANY_ID"

5. Browse the API

Open the API Reference tab for all documented endpoints — accounts and balances, transactions, cards, and outbound invoices — with request and response examples. The guides for Balances, Transactions, and Cards walk through each area.

Get started

Resources

Events

1. Create an API key

2. Get an access token

3. List invoices

4. Check your balances

5. Browse the API

​1. Create an API key

​2. Get an access token

​3. List invoices

​4. Check your balances

​5. Browse the API

1. Create an API key

2. Get an access token

3. List invoices

4. Check your balances

5. Browse the API