> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a report request

> Use this endpoint to create a new report request.

POST/digitalwallets/aliasdirectory/visa/reports

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 JSON expandable lines wrap theme={null}
{
  "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 JSON expandable lines wrap theme={null}
{
  "reportId": "my_report_id_1234"
}
```


## Related topics

- [Visa Alias Reports Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management/visa-alias-reports.md)
- [Digital Wallets Management Overview](https://www.marqeta.com/docs/core-api/digital-wallets-management.md)
- [Create a digital wallet provisioning request for Google Wallet (UPP)](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/provisioning-requests/create-digital-wallet-provisioning-request-google-wallet-upp.md)
- [Dashboard Overview and Quick Start](https://www.marqeta.com/docs/developer-guides/dashboard-overview-and-quick-start.md)
- [Create digital wallet provisioning request for Samsung Wallet](https://www.marqeta.com/docs/core-api/tokenization-as-a-service/provisioning-requests/create-digital-wallet-provisioning-request-samsung-wallet.md)