# Get verification report

This endpoint is used to retrieve the URL of a verification report for a specific verification record. The returned URL is a signed link that can be used to download the verification report in PDF format.

If the report has not been generated yet, our system will initiate report generation and wait for it to complete. This may take up to 60 seconds.

This endpoint is rate-limited per customer per verification to prevent abuse.

Endpoint: GET /verifications/{verification_id}/report
Version: 1.0
Security: API-Key

## Security:

  - `API-Key` (unknown)
    apiKey in header API-Key

## Path parameters:

  - `verification_id` (string | null, required)

## Response 200:

  - `200` (unknown)
    **OK**
The request was successful, and our system returned an expected response.

## Response 200 fields (application/json):

  - `status` (string)
    Example: ok

  - `data` (object)

  - `data.report_url` (string)
    Signed URL to download the verification report in PDF format
    Example: https://app.kycaid.com/verification-reports/1fad6bae05533340c21b5248f15ed6f75626/b61a6b4f03cfd3450718e5b89790e4afc46d.pdf?signature=xyz

## Response 400:

  - `400` (unknown)
    **Bad Request**
Our system could not process the request due to invalid syntax, missing parameters, or incorrect data format. Check the request structure and try again.

## Response 400 fields (application/json):

  - `type` (string)
    Example: bad_request

  - `errors` (array)

## Response 402:

  - `402` (unknown)
    **Payment Required**
Access to the requested resource is restricted until a payment is successfully processed. Ensure your account has a valid payment method or sufficient funds to complete this action.

## Response 402 fields (application/json):

  - `type` (string)
    Example: insufficient_funds

  - `errors` (array)

## Response 404:

  - `404` (unknown)
    **Not Found**
The requested resource does not exist or can't be found in our system.

## Response 404 fields (application/json):

  - `type` (string)
    Example: not_found

  - `errors` (array)

  - `errors.parameter` (string)
    Example: verification_id

  - `errors.message` (string)
    Example: The verification was not found

## Response 408:

  - `408` (unknown)
    **Request Timeout**
The report generation process did not complete within the expected time. Please try again later.

## Response 408 fields (application/json):

  - `type` (string)
    Example: request_timeout

  - `errors` (array)
    Example: []

## Response 422:

  - `422` (unknown)
    **Unprocessable Content**
Our system understands the request but can't process it due to invalid fields in the request.

## Response 422 fields (application/json):

  - `type` (string)
    Example: validation

  - `errors` (array)

  - `errors.parameter` (string)
    Example: verification_id

  - `errors.message` (string)
    Example: Value is required

## Response 429:

  - `429` (unknown)
    **Too Many Requests**
The maximum number of report generation attempts for this verification has been exceeded. Please contact support if you need additional access.

## Response 429 fields (application/json):

  - `type` (string)
    Example: limit_exceeded

  - `errors` (array)
    Example: []