# Get Report
source: https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/get_reports/index.md
> Get the authorization or clearing report for a VCN using its report ID. Reports are currently deleted 7 days after creation.
## Parameters {#parameters}
| Names | Description | Required for ICCP | Required for ICMP | Type |
|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------|---------|
| | | | | |
| `ReportId` | ID of a report obtained from a [Create](https://developer.mastercard.com/iccp/documentation/05_api_reference/soap_api/reports/create_reports/index.md) API call. | Yes | Yes | Numeric |
| `From` | First Transaction to review in the report. Index starts with 0. | Yes | Yes | Numeric |
| `To` | Last transaction to retrieve the report. Max number of transactions per call is 100. | Yes | Yes | Numeric |
Note: For additional transactions beyond 100, the `From` value starts after the last `To` value.
Call 1: 0-99
Call 2: 100-199 Note: The `GetVCNClearingExceptionReport` returns items for the last settlement date only. While the `GetVCNClearingExceptionReport` includes all authorized transactions it only displays those included for the settlement date the report was ran for. For example if a transaction was authorized in November, and a second transaction is authorized in January, the report run in January will only show transactions with a settlement date of January. The November authorization will not be returned. However both the Clearing and Cumulative amounts will include all transactions.
## Responses {#responses}
For each API request, you receive the following responses.
### Attributes {#attributes}
| Names | Description | Required for ICCP | Required for ICMP | Type |
|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------|---------|
| | | | | |
| `HasMore` | * Confirms whether more transactions exist for this report, up to the maximum limit of 50,000. For report queries that exceed the limit, the value returns as 'false' once all 50,000 transactions have been returned * Values: True, False | No | No | Boolean |
| `To` | Last transaction in the report. | No | No | Numeric |
| `From` | First transaction in the report. | No | No | Numeric |
### AccountSummaryItem attributes {#accountsummaryitem-attributes}
| Names | Description | Required for ICCP | Required for ICMP | Type |
|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------|--------------|
| `CpnPan` | PAN number | No | No | Numeric |
| `CurrencyCode` | ISO currency code of expected currency. | No | No | Numeric |
| `CpnType` | In Control internal identifier. | No | No | Alpha |
| `LastAuthDate` | Last authorization date. | No | No | Numeric |
| `SettledUsage` | Number of cleared settlements for the period defined in the report. | No | No | Numeric |
| `SettledAmount` | Cleared amount. | No | No | Numeric |
| `LastSettledDate` | Cleared amount date. | No | No | Numeric |
| `PreAuthUsage` | Number of preauthorizations for the period defined in the report. | No | No | Numeric |
| `CreatedDate` | Date VCN was created. | No | No | Numeric |
| `CreatedBy` | ID that created the purchase request. | No | No | Alpha |
| `AuthAmount` | Authorization amount. | No | No | Numeric |
| `AuthUsage` | Number of authorizations for the period defined in the report. | No | No | Numeric |
| `PurchaseID` | Purchase Request ID. | No | No | Numeric |
| `CumulativeLimit` | Maximum cumulative amount allowed. | No | No | Numeric |
| `PeriodType` | Only the continuous period value is compared. | No | No | Alpha |
| `Company` | Company name. | No | No | Alpha |
| `Supplier` | Supplier name. **Note**: This attribute is present but unpopulated for ICMP report results. | No | No | Alpha |
| `SpendVLimit` | Depicts any transactions where the settled amount exceeds the cumulative limit. | No | No | Numeric |
| `CDF1Label` | The label of the first custom data field. | No | No | Alphanumeric |
| `CDF1value` | The value of the first custom data field. | No | No | Alphanumeric |
| `ICMPUserFirstName` | The first name of the ICMP end user who is the designated recipient of the virtual card. This attribute is present but unpopulated for non-ICMP report results. | No | No | Alphanumeric |
| `ICMPUserLastName` | The last name of the ICMP end user who is the designated recipient of the virtual card. This attribute is present but unpopulated for non-ICMP report results. | No | No | Alphanumeric |
| `ICMPUserEmail` | The email address of the ICMP end user who is the designated recipient of the virtual card. This attribute is present but unpopulated for non-ICMP report results. | No | No | Alphanumeric |
| `ICMPUserPhoneCountryCode` | The country code of the ICMP end user's mobile phone number. This attribute is present but unpopulated for non-ICMP report results. | No | No | Alphanumeric |
| `ICMPUserMobileNumber` | The ICMP end user's mobile phone number. This attribute is present but unpopulated for non-ICMP report results. | No | No | Numeric |
### Elements {#elements}
| Names | Description | Required for ICCP | Required for ICMP | Type |
|----------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------------------|-------------------|--------------|
| `ReportStatus` | Current status of the report, which is: * **Pending**: Report is under preparation * **Active**: Generated and being processed by ICCP * **Completed**: Processed Successfully * **Failed**: Problem generating a report. Try after some time. Note: ICCP deletes reports after seven days. | No | No | Alphanumeric |
### AuthInfos/Transaction/Decision attributes {#authinfostransactiondecision-attributes}
| Names | Description | Required | Type | Transaction type |
|-----------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------|
| `PurchaseRequestId` | ID of the purchase request used to generate the virtual card. | No | Numeric | Authorization/Clearing/Decision |
| `ClearingDecisionDate` | Date and time when InControl received and processed the decision on Clearing. | No | Numeric | Decision |
| `TransactionDate` | Date in UTC when InControl processes the transaction, also known as the settlement date. | No | Numeric | Decision |
| `ClearingDecisionID` | Unique identifier from InControl for the Clearing Decision. | No | Numeric | Decision |
| `RealCardExpiry` | * Expiry month and year of the real card. * Format: YYMM | No | Numeric | Decision |
| `ClearingDecisionCode` | Numeric code added to the Clearing Decision from In Control to represent the result (approve/deny) and reason. | No | Numeric | Decision |
| `ClearingDecisionDescription` | Text description for the InControl Clearing Decision Code added. | No | Numeric | Decision |
| `AuthorizationCode` | Authorization Code submitted on the Clearing, if present. | No | Numeric | Decision |
| `CardAcceptorId` | Merchant ID submitted for the transaction. | No | Numeric | Decision |
| `TransactionLifecycleId` | Transaction link identifier submitted on the Clearing record. | No | Numeric | Decision |
| `BanknetReference` | Banknet reference number generated by the network for the transaction. | No | Numeric | Decision |
| `RetrievalReferenceNumber` | Retrieval reference number associated with the Clearing Decision record. | No | Numeric | Decision |
| `AcquirerInstitutionId` | ICA of the Acquirer who submitted the transaction. | No | Numeric | Decision |
| `ForwardingInstitutionId` | ICA of the forwarding institution who submitted the transaction. | No | Numeric | Decision |
| `DestinationInstitutionId` | ICA of card Issuer who issued the card used to generate the transaction. | No | Numeric | Decision |
| `ReceiverInstitutionId` | ICA of the processor for the issued cards transactions. | No | Numeric | Decision |
| `PurchaseRequestStatus` | Status of the purchase request used to generate the virtual card. -Approved -Blocked -Declined -Cancelled -Pending batch approval -Pending | No | Alphanumeric | Authorization/Clearing |
| `RealCardAlias` | Name of the real card used to generate the virtual card. | No | Alphanumeric | Authorization/Clearing/Decision |
| `RealCardNumber` | Number of the real card used to generate the virtual card. | No | Alphanumeric | Authorization/Clearing/Decision |
| `VirtualCardNumber` | Number of the virtual card used for the payment. | No | Numeric | Authorization/Clearing/Decision |
| `VCNExpiry` | * Expiry month and year of virtual card that maps to the real card. * Format: YYMM \
```
### Sample GetVCNAuthsReportResponse (ICMP not enabled) {#sample-getvcnauthsreportresponse-icmp-not-enabled}
```xml
Completed
```
### Sample GetVCNAuthsReportResponse (ICMP enabled) {#sample-getvcnauthsreportresponse-icmp-enabled}
```xml
Completed
```
### Sample GetVCNClearingsReport {#sample-getvcnclearingsreport}
```xml
```
### Sample GetVCNClearingsReportResponse (ICMP not enabled) {#sample-getvcnclearingsreportresponse-icmp-not-enabled}
```xml
Completed
```
### Sample GetVCNClearingsReportResponse (ICMP enabled) {#sample-getvcnclearingsreportresponse-icmp-enabled}
```xml
Completed
```
### Sample GetVCNClearingExceptionReportRequest {#sample-getvcnclearingexceptionreportrequest}
```xml
```
### Sample GetVCNClearingExceptionReportResponse (ICMP not enabled) {#sample-getvcnclearingexceptionreportresponse-icmp-not-enabled}
```xml
Completed
```
### Sample GetVCNClearingExceptionReportResponse (ICMP enabled) {#sample-getvcnclearingexceptionreportresponse-icmp-enabled}
```xml
GetICMPVCNClearingExceptionReportRequest=
Completed
```
### Sample GetVCNClearingDecisionsReportRequest {#sample-getvcnclearingdecisionsreportrequest}
The `GetVCNClearingDecisionsReport` retrieves a report that was generated through the `CreateVCNClearingDecisions` request.
The maximum number of transactions that you can return for a report query is 50,000. If the `GetVCNClearingDecisionsReportResponse` includes 50,000 transactions, then there may be additional transactions for the date range queried. In this case, submit a new `CreateVCNClearingDecisionsReportRequest` with an adjusted date range, followed by a `GetVCNClearingDecisionsReportRequest`.
This approach ensures that you can include all of your transactions, even if multiple queries are required.
```xml
```
### Sample GetVCNClearingDecisionsReportResponse {#sample-getvcnclearingdecisionsreportresponse}
```xml
Completed
```