> ## 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.

# List SMS Packages

List all available SMS packages for purchase.

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

## Success Response (200)

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

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

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

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

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

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

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

<ResponseField name="results[].bonus_sms" type="integer">
  Bonus SMS credits
</ResponseField>

<ResponseField name="results[].validity_days" type="integer">
  Validity period in days
</ResponseField>

<ResponseField name="results[].is_active" type="boolean">
  Whether package is active
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "count": 5,
    "results": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Starter Package",
        "sms_count": 1000,
        "price": 50.00,
        "currency": "USD",
        "bonus_sms": 0,
        "validity_days": 30,
        "is_active": true
      },
      {
        "id": "550e8400-e29b-41d4-a716-446655440001",
        "name": "Business Package",
        "sms_count": 5000,
        "price": 200.00,
        "currency": "USD",
        "bonus_sms": 500,
        "validity_days": 60,
        "is_active": true
      }
    ]
  }
  ```
</ResponseExample>