Skip to main content
GET
/
api
/
billing
/
history
Get Billing History
curl --request GET \
  --url https://api.example.com/api/billing/history/
{
  "count": 50,
  "next": "https://mifumosms.mifumolabs.com/api/billing/history/?page=2",
  "previous": null,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "purchase",
      "description": "Starter Package - 1000 SMS",
      "amount": 50.00,
      "currency": "USD",
      "status": "completed",
      "created_at": "2025-11-01T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "type": "usage",
      "description": "SMS Usage - 500 messages",
      "amount": -25.00,
      "currency": "USD",
      "status": "completed",
      "created_at": "2025-11-15T10:00:00Z"
    }
  ]
}
Get billing history including purchases, payments, and usage.
​
page
integer
Page number (default: 1)
​
page_size
integer
Items per page (default: 20, max: 100)
​
type
string
Filter by type (purchase, payment, usage)
Requires authentication. Include the access token in the Authorization header.

​
Success Response (200)

​
count
integer
Total number of billing records
​
next
string
URL to next page (nullable)
​
previous
string
URL to previous page (nullable)
​
results
array
Array of billing history objects
​
results[].id
string
Billing record ID
​
results[].type
string
Record type (purchase, payment, usage)
​
results[].description
string
Description of the transaction
​
results[].amount
float
Transaction amount (negative for usage)
​
results[].currency
string
Currency code
​
results[].status
string
Transaction status
​
results[].created_at
string
Creation timestamp (ISO 8601)
{
  "count": 50,
  "next": "https://mifumosms.mifumolabs.com/api/billing/history/?page=2",
  "previous": null,
  "results": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "type": "purchase",
      "description": "Starter Package - 1000 SMS",
      "amount": 50.00,
      "currency": "USD",
      "status": "completed",
      "created_at": "2025-11-01T10:00:00Z"
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "type": "usage",
      "description": "SMS Usage - 500 messages",
      "amount": -25.00,
      "currency": "USD",
      "status": "completed",
      "created_at": "2025-11-15T10:00:00Z"
    }
  ]
}