> ## Documentation Index
> Fetch the complete documentation index at: https://developer.voyado.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Purchase history summary

This endpoint can be used to get a summary of all a contact's previous purchases.

```http theme={null}
GET /api/v3/contacts/{contactId}/purchasehistorysummary
```

## Responses

A successful update will return *HTTP 200 OK* along with the contact's purchase history summary as the response body. That will look like this:

```json theme={null}
{
  "lastUpdated": "2025-09-05T14:53:50.4905776+02:00",
  "purchaseAmountAll": 2219.26,
  "numberOfArticlePurchasesAll": 3,
  "averageReceiptAll": 2219.26,
  "latestReceiptDate": "2023-09-05T14:53:50.4905776+02:00",
  "purchaseFrequencyAll": 1,
  "purchaseAmountLastYear": 0,
  "numberOfArticlePurchasesLastYear": 0,
  "averageReceiptLastYear": 0,
  "purchaseFrequencyLastYear": 1,
  "purchaseAmountLastTwoYears": 2219.26,
  "numberOfArticlePurchasesLastTwoYears": 3,
  "averageReceiptLastTwoYears": 2219.26,
  "purchaseFrequencyLastTwoYears": 2219.26
}
```

<Tip>
  Amounts shown are given in the group currency.
</Tip>

If the request has not been successful, you'll get this HTTP error code:

* *404: RetailKpiNotCalculated*: The contact ID given was not found in the database.