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

# Get Purchase History

Get history of SMS package purchases.

<ParamField query="page" type="integer">
  Page number (default: 1)
</ParamField>

<ParamField query="page_size" type="integer">
  Items per page (default: 20, max: 100)
</ParamField>

<ParamField query="status" type="string">
  Filter by status (pending, completed, failed)
</ParamField>

<Warning>
  Requires authentication. Include the access token in the Authorization header.
</Warning>

## Success Response (200)

<ResponseField name="count" type="integer">
  Total number of purchases
</ResponseField>

<ResponseField name="next" type="string">
  URL to next page (nullable)
</ResponseField>

<ResponseField name="previous" type="string">
  URL to previous page (nullable)
</ResponseField>

<ResponseField name="results" type="array">
  Array of purchase objects
</ResponseField>

<ResponseField name="results[].id" type="string">
  Purchase ID
</ResponseField>

<ResponseField name="results[].package_name" type="string">
  Package name
</ResponseField>

<ResponseField name="results[].sms_count" type="integer">
  Number of SMS credits purchased
</ResponseField>

<ResponseField name="results[].price" type="float">
  Purchase price
</ResponseField>

<ResponseField name="results[].currency" type="string">
  Currency code
</ResponseField>

<ResponseField name="results[].status" type="string">
  Purchase status
</ResponseField>

<ResponseField name="results[].purchased_at" type="string">
  Purchase timestamp (ISO 8601)
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "count": 10,
    "next": null,
    "previous": null,
    "results": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "package_name": "Starter Package",
        "sms_count": 1000,
        "price": 50.00,
        "currency": "USD",
        "status": "completed",
        "purchased_at": "2025-11-01T10:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>