Reports & Artifacts — Developer Docs
Generate due-diligence and feasibility reports, then download artifacts through one-time links.
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 one-time download link | 60/min |
GET /v1/downloads/{token} | Stream the file a one-time link names; the link is the credential | 60/min per IP |
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:
- Every
download_urlis a one-time PrecisionDocs link onapi.precisiondocs.ai: it works once and expires after 15 minutes, and the file streams from our server, so no storage URL, bucket, path or token ever reaches your client. Re-request the artifact endpoint any time you need a fresh link; reminting is free. - Hand your user only these PrecisionDocs links. If your own code downloads the file, mint a fresh link for the user, because the one you used is spent.