API Reference
Complete reference for the Drimer Partner API endpoints.
All API endpoints require authentication via your partner API key in the x-api-key header:
x-api-key: your_partner_api_keyYou can find your API key in the Partner Portal settings. If you need to rotate it, use the rotate button — the previous key will be immediately invalidated.
All responses use a standardized { "data": ... } wrapper.
Agencies
Create an agency
Creates a new agency linked to your partner account.
curl -X POST https://api-core.drimer.io/api/partners/v1/agencies \
-H "Content-Type: application/json" \
-H "x-api-key: your_partner_api_key" \
-d '{ "name": "My Travel Agency" }'Request body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the agency |
Response 201 Created
{
"data": {
"id": "agency-uuid",
"name": "My Travel Agency",
"created_at": "2025-01-15T10:30:00+00:00"
}
}List agencies
Returns all agencies linked to your partner account.
curl https://api-core.drimer.io/api/partners/v1/agencies \
-H "x-api-key: your_partner_api_key"Response 200 OK
{
"data": [
{
"id": "agency-uuid",
"name": "My Travel Agency",
"created_at": "2025-01-15T10:30:00+00:00"
}
]
}API Keys
List API keys
Returns all active API keys for an agency.
curl https://api-core.drimer.io/api/partners/v1/agencies/{agencyId}/api-keys \
-H "x-api-key: your_partner_api_key"Path parameters
| Parameter | Type | Description |
|---|---|---|
agencyId | string | UUID of the agency |
Response 200 OK
{
"data": [
{
"id": "key-uuid",
"public_key": "pk_live_...",
"secret_key": "sk_live_...",
"created_at": "2025-01-15T10:30:00+00:00"
}
]
}Create an API key
Generates a new API key pair for an agency.
curl -X POST https://api-core.drimer.io/api/partners/v1/agencies/{agencyId}/api-keys \
-H "x-api-key: your_partner_api_key"Path parameters
| Parameter | Type | Description |
|---|---|---|
agencyId | string | UUID of the agency |
Response 201 Created
{
"data": {
"id": "key-uuid",
"public_key": "pk_live_...",
"secret_key": "sk_live_...",
"created_at": "2025-01-15T10:30:00+00:00"
}
}Store the secret_key securely — it is only returned once at creation time.
Users
List agency users
Returns all users (agents) for an agency.
curl https://api-core.drimer.io/api/partners/v1/agencies/{agencyId}/users \
-H "x-api-key: your_partner_api_key"Path parameters
| Parameter | Type | Description |
|---|---|---|
agencyId | string | UUID of the agency |
Response 200 OK
{
"data": [
{
"id": "agent-uuid",
"email": "[email protected]",
"name": "John",
"surname": "Doe",
"is_manager": true,
"is_active": true,
"created_at": "2025-01-15T10:30:00+00:00"
}
]
}Error responses
All error responses follow the same format:
{
"error": "Description of the error"
}| Status | Meaning |
|---|---|
400 | Bad request — missing or invalid parameters |
401 | Unauthorized — invalid or missing API key |
404 | Not found — agency does not exist or does not belong to your account |