πŸ“„ Billing Statements API: How to Use It

πŸ” 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

OperationEndpointMethod
Get current billing statement/v2/billing-statements/currentGET
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.