Developer API

A REST API to submit bills, read the 42 extracted fields, and pull the loss diagnosis. Authenticate with a bearer token; all responses are JSON.

Authentication

Send your API key as a bearer token.

curl https://api.deftenergy.example/v1/buildings \
  -H "Authorization: Bearer $DEFT_API_KEY"

Endpoints

POST

/v1/billsSubmit a bill for extraction & analysis

GET

/v1/bills/{id}Fetch a bill, its 42 fields and diagnosis

GET

/v1/buildingsList buildings in the organisation

GET

/v1/diagnosis/{billId}Run the 58-check loss analysis

POST

/v1/webhooksRegister an alert / event webhook

Demo reference — the live API and full OpenAPI spec ship with the backend at Stage F.