Partner API

The Partner API is a read-only REST API for pulling your DrillerDB data into something else: a data warehouse, a BI dashboard, a nightly ETL job, or another system that needs your job and billing records. It is available on Enterprise accounts.

• Interactive docs: app.drillerdb.com/api/docs
• OpenAPI spec: app.drillerdb.com/api/v1/openapi.json

The spec is OpenAPI 3.1, so most client generators and API tools can read it directly.

What you can read

Six resources, and every endpoint is a GET:

• Projects, and the invoices on a project
• Work orders
• Contacts
• Equipment
• Inventory items

There are no write endpoints in v1. The API cannot create, change, or delete anything in your account.

Authentication

Send an API key in the X-API-Key header on every request.

curl -H "X-API-Key: ddb_live_example.your_secret_here" \
  "https://app.drillerdb.com/api/v1/projects?limit=50"

Keys are scoped to one company and can be revoked at any time.

Getting a key

Create a key in DrillerDB under Settings > API Access. The section appears on Enterprise accounts. You can list and revoke your keys from the same place.

Base URLs

https://app.drillerdb.com/api/v1
https://beta.drillerdb.com/api/v1

Test against beta before you point a production job at the live URL.

Pagination and change tracking

List endpoints use cursor pagination. Each response carries the next cursor at meta.next_cursor, and every response carries a meta.request_id you can quote if you need to ask us about a specific call.

Projects, contacts, equipment, and inventory accept updated_since, so a recurring sync can ask for only what changed. Work orders use cursor pagination only in v1.