# VCN Reports
source: https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/index.md

> VCN Reports provide authorization and clearing activity details for a VCN. You make two API calls to get the details. Firstly to create the report for a VCN, make a CreateVCNAuthsReport or CreateVCNClearingsReport API
> call with a specific date range. Secondly to retrieve the reports, make a GetVCNAuthsReport or GetVCNClearingsReport API call with the report ID returned in a create call.

## Request Headers {#request-headers}

|    Key name     |                   Value                    |                                                                                                            Description for ICCP                                                                                                            |
|-----------------|--------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Idempotency-Key | Any random UUID set in HTTP Request Header | 1. The header key Idempotency-Key is optional. 2. If the header key Idempotency-Key is added then it should be non-null and non-empty. 3. Max length of key is 80 chars. 4. It is recommended that the key is UUID and generated randomly. |

## Report limit {#report-limit}

The maximum number of transactions that you can return for a report query is 50,000. If a report includes 50,000 transactions, then there may be additional transactions
for the date range queried. In this case, submit a new create call with an adjusted date range and then followed by a get call.
This ensures that you include all your transactions through multiple queries if required.

## Creating and retrieving VCN reports {#creating-and-retrieving-vcn-reports}

For a successful retrieval of a VCN authorization or clearing report:

1. Send a CreateVCNAuthsReport or CreateVCNClearingsReport API call.
2. Wait for a minimum of 5 seconds for the report to create. If the number of entries is larger, then the report generation may take more than 5 seconds.
3. Send a GetVCNAuthsReport or GetVCNClearingsReport API call.
4. If you receive the status as pending, then retry the get VCN Report request at 5-seconds intervals.

## Throttling of reporting requests {#throttling-of-reporting-requests}

Mastercard throttles VCN Reports requests to ensure performance.

* If you receive an error response that indicates a reporting call has been throttled, retry the request and reduce the overall rate of requests from your application to the ICCP API.
* When selecting the date range for a VCN report, choose a date range that keeps the expected number of entries in the report to no more than 50,000 entries. Where necessary, make multiple requests for consecutive date ranges.
* Contact Mastercard for further details.