Get billing method by ID
Use this endpoint to retrieve a single billing method by its identifier, scoped to the account specified in the Snappy-Account-Id header. Use this when you want to confirm a billing method is usable through the public API, fetch its remaining balance, or read its status and metadata before creating campaigns or sending gifts.
Required fields:
Snappy-Account-Idheader - optional account scopingbillingMethodId- the billing method identifier, passed as a path parameter
Optional parameters:
Snappy-Company-Idheader - optional company scoping
Please note:
- Returns
404if no billing method exists for the suppliedbillingMethodId, or if it belongs to a different account or company than the one in scope. - Returns
422for billing methods that exist but are not supported through the public API (e.g. Express). The error envelope identifies the unsupported type. - The response includes a
spendingLimitobject with remaining balance, or null when the billing method has no cap. expirationDateis null when no expiry is configured.
Permissions
- Requires:
billingMethods:read
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.
"acc123456"
Optional company identifier.
"cmp123456"
Path Parameters
The ID of the billing method to retrieve.
"6a2515d0982480c2a4fd6b81"
Response
Billing method details.
A single billing method.
The unique identifier of the billing method.
"6a2515d0982480c2a4fd6b81"
The display name of the billing method.
"Q1 Marketing PO"
The type of the billing method.
Prepay, Invoice, PO, CC "PO"
The current status of the billing method.
draft, active, archived, expired "active"
The date the billing method was created, in ISO-8601 format.
"2025-01-15T10:00:00.000Z"
The expiration date of the billing method, in ISO-8601 format. Null when no expiry is configured.
"2025-12-31T23:59:59.000Z"
Spending limit details. Null when the billing method has no cap (e.g. Invoice).
{ "remaining": 7250.5 }