Reports & Artifacts — Developer Docs
Generate due-diligence and feasibility reports, then download artifacts with signed URLs.
How do I generate and download reports?
| Endpoint | What it does | Rate limit |
|---|---|---|
POST /v1/projects/{project_id}/reports | Start a report job (202 with a job_id) | 5/min |
GET /v1/projects/{project_id}/reports/{job_id} | Poll job status; completed jobs include artifact references | 60/min |
GET /v1/projects/{project_id}/reports | List report jobs for the project | 60/min |
GET /v1/projects/{project_id}/artifacts | List downloadable artifacts (reports, map bundles) | 60/min |
GET /v1/projects/{project_id}/artifacts/{artifact_id} | Mint a fresh signed download URL | 60/min |
Report generation:
report_typeisdue_diligenceorfeasibility.- Generation is asynchronous — poll the job until it is terminal.
- If a matching report job is already queued or running, the API attaches to the in-flight job instead of dispatching (and billing) a duplicate.
Artifacts:
- Signed download URLs expire after 15 minutes. Re-request the artifact endpoint any time you need a fresh link — reminting is free.