Skip to main content
GET
/
v1
/
organization
/
billing
/
summary
cURL
curl --request GET \
  --url https://api.buildwithchirp.com/v1/organization/billing/summary \
  --header 'Authorization: Bearer <token>'
{
  "total_cost": 5.43,
  "currency": "USD",
  "period": {
    "start": "<string>",
    "end": "<string>"
  },
  "by_product": {
    "messaging": 123,
    "sip-trunking": 123,
    "webrtc": 123,
    "recording": 123,
    "media-storage": 123,
    "whatsapp": 123,
    "phone-numbers": 123
  },
  "by_channel": {
    "sms": 123,
    "mms": 123,
    "whatsapp": 123,
    "voice": 123,
    "other": 123
  },
  "by_direction": {
    "inbound": 123,
    "outbound": 123
  },
  "record_count": 123
}

Authorizations

Authorization
string
header
required

Admin API key (format: sk_admin_*) for organization-level operations

Query Parameters

start_date
string
required

Start date (YYYY-MM-DD)

Example:

"2026-02-01"

end_date
string
required

End date (YYYY-MM-DD)

Example:

"2026-02-28"

app_id
string

Filter by specific app

Response

Aggregated billing summary

total_cost
number
required
Example:

5.43

currency
enum<string>
required
Available options:
USD
period
object
required
by_product
object
required
by_channel
object
required
by_direction
object
required
record_count
number
required