Download a Report by ID

Request

Retrieves the download information for a specific compliance report identified by its unique reportId.

This endpoint provides the URL to download the report file, along with metadata such as the file name and the expiration time for the download link.

Use this endpoint after generating a report to access the final output. Ensure the reportId corresponds to a valid and completed report in the system.

Security

bearerToken

Path

reportIdstring, (uuid)required

The unique identifier of the report to be downloaded. Must be a valid UUID that corresponds to an existing and completed report in the system.

Example:6d0104f1-fa7f-466a-933b-7a22200241ab

X-Team-Idstring, (uuid)

Optional. The team to work in, using a team id from List Teams. If left out, the default team is used. Records created in a team can only be seen by sending that team's id. A team id that doesn't exist, or a team being deleted, is rejected with 404 Team Not Found.

Example:6b78aed4-9ba6-441b-80b9-df9bea3b7c97

curl -i -X GET \
  https://connect.sandbox.creditsafe.com/v1/compliance/kyc-protect/reports/6d0104f1-fa7f-466a-933b-7a22200241ab/download \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'X-Team-Id: 6b78aed4-9ba6-441b-80b9-df9bea3b7c97'

Responses

Success. Returns the download URL, file name, and expiration timestamp for the specified report.

Bodyapplication/json

downloadUrlstring

The direct URL to download the report file. This URL is valid only until the expiration time specified in the expiresAt field.

fileNamestring

The name of the report file as specified during creation.

expiresAtstring, (date-time)

The date and time when the download URL will expire. After this time, the URL will no longer be valid, and the report must be regenerated if needed.

correlationIdstring

A unique ID assigned to this request.

Response

{
  "downloadUrl": "https://kyc-protect-api-stage.s3.eu-west-1.amazonaws.com/reports/aml-screens/customers/100000002/511a38c1-2016-420d-84bb-0873be8d4d2b_2026-11-03_14_41_02.pdf",
  "fileName": "openapi-test-screen-144102",
  "expiresAt": "2026-11-03T15:41:56.873Z",
  "correlationId": "e822f929-de01-4947-b120-21ef834dfd7e"
}