> ## Documentation Index > Fetch the complete documentation index at: https://developers.circle.com/llms.txt > Use this file to discover all available pages before exploring further. # Get report by ID > Returns the current metadata for a report, including a fresh pre-signed `downloadUrl` when the report is `ready`. Use this endpoint to check the status of a `pending` report or to obtain a new download URL after the previous one has expired. ## OpenAPI ````yaml openapi/account.yaml get /v1/reports/{id} openapi: 3.0.2 info: version: ${version} title: Core Functionality description: > All of Circle's APIs share a common set of core functionality that lets you manage your Circle Account in a programmatic way. With a Circle Account your business can deposit traditional money from 80+ countries and seamlessly convert them into "digital currency dollars": USDC. You can then use USDC for everyday payments and treasury flows. servers: - url: https://api-sandbox.circle.com - url: https://api.circle.com security: [] tags: - name: Balances description: Get information on settled and unsettled balances. - name: Payouts description: Create and get information on 1st party payouts. - name: Wires description: >- Create, get instructions, and get information on 1st party bank accounts for wire transfers. - name: CUBIX description: Create and get information on CUBIX accounts. - name: PIX description: Create and get information on PIX accounts. - name: Transfers description: Create and get information on 1st party transfers. - name: Addresses description: Generate and get information on blockchain addresses. - name: Deposits description: Get information on 1st party deposits. - name: Payments description: Create, cancel, refund, and get updates on card payments. - name: Settlement Bank Routing description: View and manage settlement bank routing preferences for fiat accounts. - name: Reporting description: >- Retrieve transaction and balance reports, including ISO 20022 (CAMT.053) statements and managed-payment reports. paths: /v1/reports/{id}: get: tags: - Reporting summary: Get report by ID description: > Returns the current metadata for a report, including a fresh pre-signed `downloadUrl` when the report is `ready`. Use this endpoint to check the status of a `pending` report or to obtain a new download URL after the previous one has expired. operationId: getReportById parameters: - $ref: '#/components/parameters/ReportIdPath' responses: '200': description: Report metadata. Includes `downloadUrl` when status is `ready`. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: title: GetReportByIdResponse properties: data: $ref: '#/components/schemas/ReportRecord' examples: ready: summary: Report is ready with download URL value: data: id: 550e8400-e29b-41d4-a716-446655440000 reportType: camt053 status: ready downloadUrl: https://s3.amazonaws.com/... expiresAt: '2025-01-15T16:00:00Z' pending: summary: Report is still being generated value: data: id: 550e8400-e29b-41d4-a716-446655440000 reportType: camt053 status: pending '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/NotAuthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' security: - bearerAuth: [] components: parameters: ReportIdPath: name: id description: The report ID. in: path required: true schema: type: string format: uuid example: 550e8400-e29b-41d4-a716-446655440000 headers: XRequestId: description: >- Universally unique identifier (UUID v4) for the request. Helpful for identifying a request when communicating with Circle support. schema: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde schemas: ReportRecord: type: object description: > Metadata for a unified report. `status` reflects whether the generated file is available. If `status` is `ready`, the response includes a pre-signed `downloadUrl`. If `pending`, generation is still in progress. Poll `GET /v1/reports/{id}` until `ready`, then download using `GET /v1/reports/{id}/content`. Requests are idempotent: the same entity and request parameters always produce the same report ID. Subsequent `POST` requests return the existing report. required: - id - reportType - status properties: id: type: string format: uuid description: > Unique, deterministic identifier for this report. The same entity and request parameters always produce the same ID. Safe to retry as subsequent POST requests return the same report. example: 550e8400-e29b-41d4-a716-446655440000 reportType: type: string enum: - camt053 - managed_payout_transactions - managed_payment_wallet_balances - managed_payin_transactions description: Report type identifier. example: camt053 status: type: string enum: - pending - ready - failed description: > Current lifecycle status of the report. - `ready`: Report is available to download. Use `downloadUrl` or the content endpoint. - `pending`: Report generation is in process. Poll `GET /v1/reports/{id}` until `ready`. - `failed`: Report generation failed. example: ready downloadUrl: type: string format: uri nullable: true description: | Pre-signed URL to download the report. Present only when status is `ready`; omitted otherwise. example: https://s3.amazonaws.com/... expiresAt: type: string format: date-time nullable: true description: > Expiration time of `downloadUrl` in ISO 8601 format. After expiration, call GET `/v1/reports/{id}` to obtain a fresh URL. example: '2025-01-15T15:00:00Z' responses: BadRequest: description: The request cannot be processed due to a client error. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object title: BadRequest required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. example: code: 400 message: Bad request. examples: response: value: code: 400 message: Bad request. NotAuthorized: description: >- The request has not been applied because it lacks valid authentication credentials. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object title: NotAuthorized required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. example: code: 401 message: Malformed authorization. examples: response: value: code: 401 message: Malformed authorization. Forbidden: description: >- The request provides authentication, but the authenticated user does not possess sufficient permissions for accessing this resource. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object title: Forbidden required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. example: code: 3 message: Forbidden examples: response: value: code: 3 message: Forbidden NotFound: description: The specified resource was not found. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object title: NotFound required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. example: code: 404 message: Not found. examples: response: value: code: 404 message: Not found. InternalServerError: description: Unexpected server error. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: type: object title: InternalServerError required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. example: code: 500 message: Internal server error. examples: response: value: code: 500 message: Internal server error. securitySchemes: bearerAuth: type: http scheme: bearer ````