Getting Started

The DomeTech Enterprise API lets you programmatically generate drone footage and track job progress.

Base URL

Switch between staging and production using the toggle in the top nav.

Quick Start

1. Get your API key

Your API key is provided during partner onboarding. Keys start with dome_live_ and are sent via the X-API-Key header.

2. Make your first request

List your jobs:

curl -H "X-API-Key: dome_live_your_key_here" \
  https://staging-api.dometech.com.au/v1/jobs

3. Generate drone footage

curl -X POST \
  -H "X-API-Key: dome_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"address": "123 Collins Street, Melbourne VIC 3000"}' \
  https://staging-api.dometech.com.au/v1/drone-footage/generate

Response:

{
  "data": {
    "job_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "queued"
  },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-09T10:00:00.000Z"
  }
}

4. Poll for results

Jobs are asynchronous. Poll the job endpoint until the status is completed:

curl -H "X-API-Key: dome_live_your_key_here" \
  https://staging-api.dometech.com.au/v1/jobs/550e8400-e29b-41d4-a716-446655440000

Available Endpoints

Response Format

All responses follow a consistent envelope:

{
  "data": { ... },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "..."
  },
  "meta": {
    "request_id": "...",
    "timestamp": "..."
  }
}

Next Steps

• Authentication -- API key details and security
• Jobs and Polling -- How async jobs work
• API Reference -- Full endpoint documentation