---
title: "Create, charge once and durably store a machine-safe property report"
method: POST
path: "/v1/reports"
---

# Create, charge once and durably store a machine-safe property report

`POST /v1/reports`

## Request

- Base URL: `https://agents.alphaquantlabs.ai`
- URL: `https://agents.alphaquantlabs.ai/v1/reports`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `latitude` number, required
  - `longitude` number, required

## Response `200`

idempotent replay

- ReportRecord
  - `report_id` string, required
  - `request_id` string, required
  - `status` 'ready', required
  - `response_hash` string, required
  - `report` Schema (unresolved $ref)

## Other responses

- `201`: new report
- `400`: bad request or missing Idempotency-Key
- `402`: insufficient credits
- `404`: out of coverage; not charged
- `409`: same request still running
- `503`: upstream/persistence failure; refunded

---

[API](https://skmtc.dev/alphaquantlabs/apis/aql-propertycheck-property-intelligence-due-diligence-report.md) · [All operations](https://skmtc.dev/alphaquantlabs/apis/aql-propertycheck-property-intelligence-due-diligence-report/llms.txt) · [OpenAPI document](https://skmtc.dev/alphaquantlabs/apis/aql-propertycheck-property-intelligence-due-diligence-report/revisions/97e2fb7774f8?raw)