> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hellocobi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first API call to the Cobi Data API

## Prerequisites

* An API key (contact [support@hellocobi.com](mailto:support@hellocobi.com) to request one)
* A tool to make HTTP requests (cURL, Postman, or your preferred language)

## Your First API Call

Upload a customer record to get started:

```bash theme={null}
curl -X POST https://api.hellocobi.com/v1/data/customers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "records": [
      {
        "customer_id": "550e8400-e29b-41d4-a716-446655440000",
        "user_id": "550e8400-e29b-41d4-a716-446655440001",
        "region": "US",
        "birthdate": "1990-01-01",
        "gender": "MALE"
      }
    ]
  }'
```

A successful response:

```json theme={null}
{
  "status": "success",
  "message": "Records uploaded successfully",
  "count": 1
}
```

## Available Endpoints

Once you're uploading successfully, explore the full set of endpoints:

* [Customers](/api-reference/data/endpoint/customers)
* [Transactions](/api-reference/data/endpoint/transactions)
* [Offers](/api-reference/data/endpoint/offers)
* [Shops, branches, categories, and more](/api-reference/data/overview)

## Best Practices

Send up to 5,000 records per request for the best throughput. Before uploading at scale, check your payload against the [data models](/api-reference/data/overview) to catch schema errors early. Always check the response status on each request and retry with exponential backoff on `429` or `5xx` responses.

## Next Steps

* Read the [Authentication](/authentication) guide for API key security and error codes
* Browse the [Data Models](/api-reference/data/overview) to see required and optional fields for each record type
* Check out the [Recommendations API](/api-reference/recommendations/overview) to surface personalised offers for your users