> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.mangopay.com/api-reference/overview/data-availability-periods/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.mangopay.com/_mcp/server.

# Data availability periods

## Transactions

The Mangopay API retains live transaction data for 13 months. This means that any transaction object can be retrieved via the API for 13 months after its `CreationDate`.

This limitation applies:

* To transactions of every `Type` (`PAYIN`, `TRANSFER`, `CONVERSION`, `PAYOUT`) and `Nature` (`REGULAR`, `REPUDIATION`, `REFUND`, `SETTLEMENT`)
* On all relevant GET endpoints, both to retrieve by Object ID (e.g. [GET View a Payout](/api-reference/payouts/view-payout)) and to list transactions (e.g. [GET List Transactions for a User](/api-reference/transactions/list-transactions-user))
* In both the Production and Sandbox environments

Past the 13-month period, transaction data is archived. Once archived:

* A GET call on the archived Transaction ID (e.g. GET View a PayIn, GET View a Refund, etc.) returns 404 Not Found
* A GET call to list transactions call (e.g. for a User) doesn’t return the archived transaction

For example, here is a 404 response on GET View a PayIn:

**`Example - 404 Not Found`**

```json Example - 404 Not Found
{
    "Message": "The ressource does not exist",
    "Type": "ressource_not_found",
    "Id": "5ca01f7f-99f4-4ba4-82a1-3af3b702f727#1718224387",
    "Date": 1718224388,
    "errors": {
        "RessourceNotFound": "Cannot found the ressource PayIn with the id=158250465 "
    }
}
```

This limitation does not apply to resources that enable a user to make payments, such as [Cards](/api-reference/cards), [Recurring PayIn Registrations](/api-reference/recurring-card-payins), [Bank Accounts](/api-reference/bank-accounts), and [Mandates](/api-reference/mandates).

However, [Preauthorizations](/api-reference/preauthorizations) and [Extended Preauthorizations](/api-reference/extended-preauthorizations), given their limited validity and use, are also limited to 13 months.

Limiting the duration of data retention is essential to maintain performance. The retention period is sufficient for operational usage (such as refunds, fraud investigations, and user experience) and most auditing purposes.

All data is archived securely and provisions are in place to ensure we address any legal or business requirements that may arise.

## Reports

Mangopay's reports feature (via the API or the Dashboard) can return data from January 1 of the previous calendar year (N-1).

For more information about generating reports, see the [Reports](/reports) article.

## Events

[GET List all Events](/api-reference/events/get-events) returns events up to 45 days after the `Date` they occur.

## API responses

If an API call contains an idempotency key, it can be retrieved up to 24 hours after the `Date` it was sent, using the [GET View an API Response](/api-reference/api-responses/view-api-response) endpoint.