POST////
Use this endpoint to create a new report request.
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 |
Request body
| Fields | Description |
|---|---|
| filters object Required | Filters for the report. Allowable Values: aliasStatuses, aliasType, billingEventTypes, endDate, startDate |
| filters.aliasStatuses array of strings Required | Statuses of the Visa Aliases to include in the report. Allowable Values: ACTIVE, DISABLED, BLOCKED, EXPIRED, DELETED |
| filters.aliasType string Required | Type of Visa Alias in the Alias Directory Service (ADS) profile. Visa supports phone and email as Visa Alias types that can be used in place of sensitive payment credentials details. Allowable Values: EMAIL, PHONE, DIRECTORY_ALIASID, PAYNAME |
| filters.billingEventTypes array of strings Optional | Billing event types to include in the report. Allowable Values: aliasInquiry, createAlias, createBatch, createPaymentCredential, createReport, deleteAlias, deletePaymentCredential, getAlias, getAliasId, getAliasOnlineReport, getBatch, getBatchKeys, getBatchResult, getByExternalId, getPaymentCredential, getPaymentCredentials, getReport, getReportFile, resolveAlias, updateAlias, updateAliasStatus, updateBankPaymentCredential |
| filters.endDate string Required | Date when the report ends in ISO UTC format YYYY-MM-DDThh:mm:ss.000Z Allowable Values: Format: YYYY-MM-DDThh:mm:ss.000Z |
| filters.startDate string Required | Date when the report starts in ISO UTC format YYYY-MM-DDThh:mm:ss.000Z Allowable Values: Format: YYYY-MM-DDThh:mm:ss.000Z |
| format string Required | The format of the report Allowable Values: 1–36 chars |
| reportType string Required | Indicates the type of report. Allowable Values: DIRECTORY_STATUS, PLATFORM_REQUESTS, RESOLUTION_RECONCILIATION, DIRECTORY_ACTIVITY, PAYMENT_CREDENTIAL_DETAILS |
Sample request body
JSON
{
"format": "JSON",
"filters": {
"endDate": "2026-01-01T22:52:46Z",
"aliasType": "PHONE",
"startDate": "2026-01-01T22:52:46Z",
"aliasStatuses": [
"ACTIVE"
],
"billingEventTypes": [
"createAlias"
]
},
"reportType": "PLATFORM_REQUESTS"
}
Response body
| Fields | Description |
|---|---|
| reportId string Conditionally returned | Unique identifier of the report. Allowable Values: 36 char max |
Sample response body
JSON
{
"reportId": "my_report_id_1234"
}