Partner API
Three satellite-data products with a signed PDF report: lightning activity, housing detection and damage assessment.
This API answers three questions and, when you need it, issues the report that documents them. You never have to open the console: the API key we hand you is enough.
| Product | The question | Start here |
|---|---|---|
| Lightning activity | Did lightning strike near the point, within the window? | Guide |
| Housing | Is there construction on the parcel, and how much? | Guide |
| Damage assessment | How much damage did the event leave on the parcel? | Guide |
All three share one shape: a cheap evaluation that answers the question, and an issuance that returns the PDF. The evaluation does not commit you to issuing — if the answer is enough, you are done.
Before your first call
- Authentication:
Authorization: Bearer uco_live_…(production) oruco_sbox_…(sandbox). They are not interchangeable: using one against the other environment returns401 environment_mismatch. Idempotency-Keyis required on anything that spends quota. Without it the answer is428.- Errors carry
retryable, so you do not need your own table of what is worth retrying.
Cross-cutting mechanics — job lifecycle, the stable download and the full status code table — live in Jobs, delivery and errors.
The sandbox
https://sbox.ucotron.com serves the same routes with fixture data and no
cost. It returns real PDF reports that open; what it does not do is reflect your
request parameters in their content. And it keeps no state: listings come back
empty and jobs are born finished.