GET/////
Use this endpoint to retrieve the status of a report by its report ID.
Header parameter
| Fields | Description |
|---|---|
| req-sys-id string Required | Identifier generated by the card program. These identifiers are used for troubleshooting requests between the card program and Marqeta. Allowable Values: 36 char max |
| participant-id string Required | Visa Business Identifier (BID) that is assigned to the program. Allowable Values: Existing participant ID |
URL path parameters
| Fields | Description |
|---|---|
| reportId string Required | Unique identifier of the report. Allowable Values: Existing report ID |
Response body
| Fields | Description | |
|---|---|---|
| creationDateTime datetime Conditionally returned | The timestamp when the report was created in ISO UTC format YYYY-MM-DDThh:mm:ss.000Z Allowable Values: YYYY-MM-DDThh:mm:ss.000Z | |
| dataClassification string Conditionally returned | Data classification of the report. Allowable Values: 1–36 chars | |
| expirationDateTime datetime Conditionally returned | The timestamp after which the report won’t be available for download in ISO UTC format YYYY-MM-DDThh:mm:ss.000Z Allowable Values: YYYY-MM-DDThh:mm:ss.000Z | |
| fileIds array of strings Conditionally returned | UUIDs of the files generated by the report. Allowable Values: | |
| format string Conditionally returned | Format of the report. Allowable Values: 1–36 chars | |
| id string Conditionally returned | UUID generated by Alias Directory, which identifies the report. Allowable Values: 1–36 chars | |
| reportType string Conditionally returned | Indicates the type of report. Allowable Values: PLATFORM_REQUESTS, DIRECTORY_STATUS, PAYMENT_CREDENTIAL_DETAILS | |
| status string Conditionally returned | Indicates the status of the report. Allowable Values: CREATED, IN_PROGRESS, COMPLETED |
Sample response body
JSON
{
"id": "a77ef5c5-c972-467b-9a11-ac550183b495",
"format": "JSON",
"status": "COMPLETED",
"fileIds": [
"000001-a96032e1-0ad9-4937-9320-a2a28b139ea5, 000002-a96032e1-0ad9-4937-9320-a2a28b139ea5"
],
"reportType": "PLATFORM_REQUESTS",
"creationDateTime": "2026-01-01T22:52:46Z",
"dataClassification": "VERY_IMPORTANT",
"expirationDateTime": "2025-01-01T22:52:46Z"
}