# Mass Payout Reporting

## Retrieve Mass Payout Item Detail

> Retrieves the details of an item contained within a mass payout.

```json
{"openapi":"3.0.3","info":{"title":"Mass Payout API","version":"1.0.0"},"tags":[{"name":"Mass Payout","description":"Mass payout operations"}],"servers":[{"url":"https://api.iyzipay.com","description":"Production"},{"url":"https://sandbox-api.iyzipay.com","description":"Sandbox"}],"paths":{"/v1/mass/payout/retrieve/items/{referenceCode}":{"get":{"tags":["Mass Payout"],"summary":"Retrieve Mass Payout Item Detail","description":"Retrieves the details of an item contained within a mass payout.","parameters":[{"$ref":"#/components/parameters/AuthHeader"},{"$ref":"#/components/parameters/ContentTypeHeader"},{"$ref":"#/components/parameters/LocaleQuery"},{"name":"referenceCode","in":"path","required":true,"description":"Unique reference code of the mass payout item.","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MassPayoutItemRetrieveResponse"}}}}}}}},"components":{"parameters":{"AuthHeader":{"name":"Authorization","in":"header","required":true,"description":"Authorization header; a signed hash value that starts with **IYZWSv2** and is generated in Base64 format.","schema":{"type":"string"}},"ContentTypeHeader":{"name":"Content-Type","in":"header","required":true,"description":"Content-Type value.","schema":{"type":"string"}},"LocaleQuery":{"name":"locale","in":"query","required":true,"description":"Response language.","schema":{"type":"string","enum":["tr","en"]}}},"schemas":{"MassPayoutItemRetrieveResponse":{"type":"object","description":"Mass payout single item detail response.","properties":{"status":{"type":"string","enum":["success","failure"]},"systemTime":{"type":"integer"},"locale":{"type":"string"},"item":{"$ref":"#/components/schemas/MassPayoutItemDetail"}}},"MassPayoutItemDetail":{"type":"object","description":"Mass payout item detail.","properties":{"itemExternalId":{"type":"string"},"referenceCode":{"type":"string"},"recipientType":{"type":"string","enum":["PHONE","IBAN","IDENTITY_NUMBER","MEMBER_ID"]},"recipientInfo":{"type":"string"},"recipientName":{"type":"string"},"description":{"type":"string"},"itemStatus":{"type":"string","description":"Mass payout item lifecycle status (enum).","enum":["FAILED","SUCCESS","INIT","INVALID","PROCESSING","MASS_PAYOUT_CANCELED","QUEUED","DEPOSIT_SUCCESS","DEPOSIT_FAIL"]},"errorMessages":{"type":"array","items":{"type":"string"}},"totalAmount":{"type":"decimal"},"commissionAmount":{"type":"decimal"},"currencyCode":{"type":"string"}}}}}}
```

### Mass Payout Item Status List

<table data-full-width="true"><thead><tr><th>Status</th><th>Description</th></tr></thead><tbody><tr><td>FAILED</td><td>Item was sent to the bank but failed. Includes errors returned from the bank or general processing errors. Validation errors will also result in this status.</td></tr><tr><td>SUCCESS</td><td>Item was sent to the bank and completed successfully.</td></tr><tr><td>INIT</td><td>When the mass payout is created, items are stored in waiting state before auth</td></tr><tr><td>INVALID</td><td>Parameter(s) are invalid, missing, or inconsistent.</td></tr><tr><td>PROCESSING</td><td>Item has been sent to the bank and is being processed.</td></tr><tr><td>MASS_PAYOUT_CANCELED</td><td>Item was canceled because the parent mass payout was canceled.</td></tr><tr><td>QUEUED</td><td>Item has been queued (for both bank transfer and wallet/deposit flows)</td></tr><tr><td>DEPOSIT_SUCCESS</td><td>Failed item and its commission amount were successfully refunded to the merchant mass payout balance</td></tr><tr><td>DEPOSIT_FAIL</td><td>Failed payment amount and commission amount could not be refunded to the mass payout balance. An error was returned.</td></tr></tbody></table>


---

# 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://docs.iyzico.com/en/products/mass-payout/mass-payout-integration/mass-payout-reporting.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.