# Get Report

## 12.1 Get Report

**Request**

| Method | URL                  |
| ------ | -------------------- |
| GET    | /merchant/v1/reports |

**Query Params**

id (Optional): Used to filter report ID or IDs.

reportTypes: Specifies the list of report types.

reportPeriod: Determines the reporting period.

page: Specifies the page number for pagination.

size: Specifies the number of items per page for pagination.

**Response**

| Status | Response                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 200    | <p>{</p><p>"data": {</p><p>"items": \[</p><p>{</p><p>"id": 10,</p><p>"createdDate": "2023-12-08T18:23:17.998281",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "INSTANT",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 9,</p><p>"createdDate": "2023-12-08T18:20:27.164542",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "INSTANT",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 8,</p><p>"createdDate": "2023-12-08T18:15:48.275313",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "INSTANT",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 7,</p><p>"createdDate": "2023-12-08T18:12:46.853184",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "DAILY",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 6,</p><p>"createdDate": "2023-12-08T18:10:33.600712",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "DAILY",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 5,</p><p>"createdDate": "2023-12-08T18:09:10.831708",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "DAILY",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 4,</p><p>"createdDate": "2023-12-08T18:08:25.444979",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "DAILY",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 3,</p><p>"createdDate": "2023-12-08T18:07:35.868049",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "DAILY",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>},</p><p>{</p><p>"id": 2,</p><p>"createdDate": "2023-12-08T18:06:42.896034",</p><p>"reportType": "TRANSACTION,PAYMENT",</p><p>"reportPeriod": "DAILY",</p><p>"startDate": "2023-01-01T00:00:00",</p><p>"endDate": "2023-12-31T23:59:59",</p><p>"availableFileTypes": "XLSX",</p><p>"state": "READY"</p><p>}</p><p>]</p><p>}</p><p>}</p> |
| 403    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 400    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 401    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| 500    |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://magicpay.gitbook.io/magicpay-documentation/reports/get-report.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.