π What is the Billing Statements API?
The Billing Statements API (v2) provides access to your companyβs monthly billing statements. Each statement summarizes expenses and payments made during a given billing cycle.
You can use this API to:
- Retrieve the current billing statement (the active billing cycle)
- Retrieve a past billing statement by specifying the month and year
- Automate reconciliation and reporting processes
π Available Endpoints
Operation | Endpoint | Method |
---|---|---|
Get current billing statement | /v2/billing-statements/current | GET |
Get billing statement by date | /v2/billing-statements/{month}/{year} | GET |
1οΈβ£ Get current billing statement
Retrieve the billing statement that is currently open for the ongoing cycle.
π Endpoint
GET /v2/billing-statements/current
π€ cURL Request
curl -X GET \
"https://public-api.mx.clara.com/api/v2/billing-statements/current" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
π₯ Sample JSON Response
{
"month": 7,
"year": 2025,
"status": "OPEN",
"statementUuid": "b6a81f58-4ebc-4e93-822d-2b0917ae845c",
"totalAmount": 150000.50,
"currency": "MXN",
"closingDate": "2025-07-31"
}
2οΈβ£ Get current billing statement
Retrieve a billing statement for a specific month and year (e.g. June 2024).
π Endpoint
GET /v2/billing-statements/{month}/{year}
π€ cURL Request
curl -X GET \
"https://public-api.mx.clara.com/api/v2/billing-statements/6/2024" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
π₯ Sample JSON Response
{
"month": 6,
"year": 2024,
"status": "CLOSED",
"statementUuid": "e1f349d4-cf35-4b78-bdbf-1d35f0a8e014",
"totalAmount": 132500.00,
"currency": "MXN",
"closingDate": "2024-06-30"
}
π‘ Tip: Use the status field to distinguish between open and closed billing cycles.
β οΈ Note: The current billing statement is subject to change until the cycle closes.