# Reports
source: https://developer.mastercard.com/mastercom-extended/documentation/use_cases/reporting/index.md

## How managing reports works {#how-managing-reports-works}

The reporting overview diagram displays the process of an acquirer or issuer searching, creating, and obtaining reports. For more information, refer to the [Reports](https://developer.mastercard.com/mastercom-extended/tutorial/reports/index.md) tutorial.
Note: In the following graphics, optional steps are denoted with dashed arrows instead of solid arrows. Diagram reporting

**Step 1 (first option):** The issuer or acquirer retrieves the list of available report details from which a report could be created.   

**Step 2 (second option):** The issuer or acquirer retrieves the details of a specific report definition.  

**Step 3:** The issuer or acquirer creates a report using the selected report definition.  

**Step 4:** The issuer or acquirer retrieves the status of the report through the reportRequestId generated from the report creation request.  

**Step 5:** The issuer or acquirer downloads the completed report.  

## Retrieve list of report fields {#retrieve-list-of-report-fields}

Issuers and acquirers use this endpoint to retrieve a list of reports and their fields.
Diagram report_fieldlist
API Reference: `GET /report-definitions`

## Retrieve report fields {#retrieve-report-fields}

Issuers and acquirers use this endpoint to retrieve fields within a specific report.
Diagram report_fields
API Reference: `GET /report-definitions/{report_definition_id}`

## Create a report {#create-a-report}

Issuers and acquirers use this endpoint to request the creation of a report.

NOTE : The system requires at least 120 seconds to generate a report.
Diagram report_create
API Reference: `POST /reports`

## Search for reports {#search-for-reports}

Issuers and acquirers use this endpoint to obtain a reportStatus and reportCompletedId.
Diagram report_search
API Reference: `POST /reports/searches`

## Retrieve report status {#retrieve-report-status}

Issuers and acquirers use this endpoint to retrieve the status of a specific report.
Diagram report_retstatus
API Reference: `GET /reports/{report_request_id}/status`

## Retrieve completed report {#retrieve-completed-report}

Issuers and acquirers use this endpoint to retrieve a completed report.
Diagram report_retreport
API Reference: `GET /reports/{report_completed_id}`