Quickstart

This guide will get you set up and ready to use the Claims Database API. We'll cover how to obtain your API token and make your first request to submit a claim.

Before you can make requests to the API, you will need to generate an API token from your dashboard under Settings » API Tokens.

Get your API token

Log in to the Claims Database dashboard.
Navigate to Settings » API Tokens.
Click Create Token and give it a descriptive name (e.g., "Production Integration").
Copy the token immediately — it will only be shown once.

Base URL

All API endpoints are served under the following base URL:

https://YOUR_DOMAIN/api/v1

All requests must include the Accept: application/json header.

Make your first request

Below is an example of submitting a new claim using cURL. Replace {token} with your actual API token.

POST

/api/v1/claims

curl -X POST https://YOUR_DOMAIN/api/v1/claims \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_id": "CY-12345678",
    "claim_date": "2025-11-15",
    "claim_type": "accident",
    "amount": 2500.00,
    "currency": "EUR",
    "is_at_fault": true
  }'

Response (201 Created)

{
  "data": {
    "id": "9e5f1a2b-3c4d-5e6f-7a8b-9c0d1e2f3a4b",
    "claim_date": "2025-11-15",
    "claim_type": "accident",
    "amount": "2500.00",
    "currency": "EUR",
    "is_at_fault": true,
    "source": "api",
    "company_name": "Cyprus General Insurance",
    "created_at": "2025-11-20T10:30:00+00:00"
  }
}

What's next?

You've made your first API request. Here are some useful next steps: