Skip to content
Last updated

The Databox API enables you to programmatically interact with accounts, data sources, and datasets in Databox. It is designed to integrate Databox with other systems, automate data ingestion, and extend the functionality of the platform.

The API follows standard REST conventions, using predictable, resource-oriented URLs, JSON-encoded request and response bodies, and standard HTTP verbs and status codes.


Availability

The API is available to all users on the Professional plan and above.

  • Professional plan: You can create datasets and ingest data into them. However, in-app dataset functionality is limited. Features such as dataset merging, filtering, and calculated columns are not available.
  • Growth and higher plans: Full dataset functionality is supported, including dataset transformations and advanced calculations.

Versioning

The API is versioned, with the version number included in the URL. For example:

curl -i -X GET \
  https://api.databox.com/v1/accounts \
  -H 'x-api-key: YOUR_API_KEY_HERE'

A changelog is available to track new features, changes, and deprecations across versions.

Request IDs

Each API request has an associated request identifier. You can find this value in the response body in the requestId field.

When contacting support about a specific request, include the request identifier to help us quickly locate the request and expedite the resolution process.

Suggestions

If you need functionality that is not currently available through the API, you can request new endpoints or features directly in our Roadmap.

Next steps