Skip to main content

​
Authentication

Databar uses API keys to allow access to the API. Include your key in the x-apikey header on every request. 
curl https://api.databar.ai/v1/user/me \
  -H "x-apikey: YOUR_API_KEY"
To find your API key, head over to your Databar workspace and click Integrations.

​
Base URL

All API requests should be made to: 
https://api.databar.ai

​
Async Pattern

Some operations (bulk enrichments, waterfalls) run asynchronously. The flow is:
1

Submit the request

Call a run or bulk-run endpoint. You’ll receive a task_id in the response.
2

Poll for results

Call GET /v1/tasks/{request_id} with the task_id. The status field will be processing, completed, or failed.
3

Retrieve your data

When status is completed, the data field contains your results.
Data from enrichment and waterfall tasks is stored for 1 hour only. After that, the data is permanently deleted and the task status will return gone. Make sure to retrieve your results promptly.

​
Pagination

The GET /v1/table/{table_uuid}/rows endpoint supports pagination:
ParameterDefaultDescription
per_page1000Number of rows to return per page.
page1Page number to retrieve.
The response includes has_next_page and total_count to help you iterate.

​
Error Handling

The API uses standard HTTP status codes. All error responses return a JSON body with a detail field describing the issue.

​
Common Error Codes

CodeMeaningWhen it happens
400Bad RequestInvalid or missing parameters in your request. The response body shows which fields failed validation.
403ForbiddenYour API key is missing, invalid, or doesn’t have access to the requested resource.
404Not FoundThe enrichment, waterfall, table, or task ID you referenced doesn’t exist.
406Insufficient CreditsYour account doesn’t have enough credits or your plan doesn’t support this operation.
410GoneThe requested data has expired. Task results are deleted after 1 hour.
422Validation ErrorThe request body failed schema validation. The response includes field-level error details.

​
Error Response Formats

Parameter validation error (400): 
{
  "detail": {
    "param1": ["This field is required."]
  }
}
Batch operation error (400) — for row insert/update/upsert: 
{
  "error": "BATCH_TOO_LARGE",
  "max_size": 50
}
Batch error codes: BATCH_TOO_LARGE, UNKNOWN_COLUMNS, INVALID_DATA. Insufficient credits (406): 
{
  "detail": "Check the number of remaining credits or the tariff plan."
}
Schema validation error (422): 
{
  "detail": [
    {
      "loc": ["body", "params"],
      "msg": "field required",
      "type": "value_error.missing"
    }
  ]
}