comecerodocs
Usage billing runs

List bills that need attention

GET
/usage/attention

Billing runs that are stuck, up to 100: held for Comecero's review (needs_review), failed (failed), or waiting for prepaid credit (waiting_for_credit). Failures you can fix are retried from the dashboard, under Usage Billing. Secret and trusted tokens may call it; a limited token may not (403).

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Response Body

The runs that need attention.

application/json
  1. response
data?array<>
Example Request
curl -X GET 'https://api.comecero.com/api/v1/usage/attention'
Example Response
{  "data": [    {      "run": {        "object": "string",        "billing_run_id": "string",        "billing_agreement_id": "string",        "period_start": "2019-08-24T14:15:22Z",        "period_end": "2019-08-24T14:15:22Z",        "kind": "period",        "status": "pending",        "invoice_id": "string",        "carried_forward": true,        "prepared_lines": [          {            "kind": "usage",            "name": "string",            "quantity": 0,            "rated_amount": 0,            "credit_debit": 0,            "amount": 0          }        ],        "failure_code": "string",        "failure_message": "string",        "billing_region": "us",        "test": true      },      "agreement_id": "string",      "customer_id": "string",      "subscription_id": "string",      "currency": "string",      "reason": "needs_review"    }  ]}

List an agreement's billing runs GET

Newest period first. For the next page, set `before` to the oldest `period_start` you got. Secret and trusted tokens may call it; a limited token may not (`403`).

Get a billing run GET

One billed period, with its invoice lines. URL-encode the id. Secret and trusted tokens may call it; a limited token may not (`403`).