Reporting

​

Report types

​

Request and download a report

1. Request the report with POST /v1/reports, passing reportType, date in YYYY-MM-DD format, and timeframe where the type supports it. Circle interprets date in your entity’s reporting timezone, not UTC. For example, a Circle SG entity uses Singapore Time (SGT). Circle generates Managed Payments reports on a schedule:
   • If the report is available, the response is 200 OK with the report id and a pre-signed downloadUrl.
   • If the report is still being generated, the response is 202 Accepted with a report id and no downloadUrl.
2. If the response was 202 Accepted, poll GET /v1/reports/{id} until status is ready and a downloadUrl is present.
3. Download the file from downloadUrl before the time given by expiresAt. Call GET /v1/reports/{id} again to get a fresh URL after it expires. You can also request the report again. Requests are idempotent, so the same parameters return the same report.

curl -X POST https://api-sandbox.circle.com/v1/reports \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reportType":"camt_managed","timeframe":"daily","date":"2026-06-30"}'

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "reportType": "camt_managed",
    "status": "ready",
    "downloadUrl": "https://s3.amazonaws.com/...",
    "expiresAt": "2026-06-30T15:00:00Z"
  }
}