Get billing methods
Billing methods
Get billing methods
Use this endpoint to retrieve the billing methods of an account that are usable through the public API. Use this when you need to discover which billing methods are available - and how much budget remains on each - before creating campaigns or sending gifts.
Filtering options:
filter[type]- exact match on billing method type. One of Prepay, Invoice, PO, CC.filter[status]- exact match on billing method status. Allowed values depend on the type:Invoice: active, archivedCC: active, archived, expiredPO: draft, active, archived, expiredPrepay: draft, active, archived
filter[remainingBalance][gte]/filter[remainingBalance][lte]- range filter on remaining balanceSnappy-Account-Idheader - optional account scopingSnappy-Company-Idheader - optional company scoping
Please note:
- Express billing methods are intentionally excluded from this endpoint. They exist on some accounts but cannot be used through the public API.
- Each billing method’s response includes a spendingLimit object with remaining balance, or null when the billing method has no cap (e.g. Invoice).
- expirationDate is null when no expiry is configured on the billing method.
Permissions
- Requires:
billingMethods:read
GET
Get billing methods
Authorizations
Company Level Authentication
Include your API key in the X-Api-Key header for every request:
X-Api-Key: YOUR_API_KEYHeaders
Account identifier.
Example:
"acc123456"
Optional company identifier.
Example:
"cmp123456"
Query Parameters
Filter by billing method type.
Available options:
Prepay, Invoice, PO, CC Example:
"PO"
Filter by billing method status. Allowed values depend on the selected type.
Available options:
draft, active, archived, expired Example:
"active"
Return only billing methods with remaining balance at or above this value.
Required range:
x > 0Example:
1000
Return only billing methods with remaining balance at or below this value.
Required range:
x > 0Example:
5000
Response
List of billing methods for the account.
A list of billing methods for the account.
Last modified on June 17, 2026