Billing & Usage

curl -X GET 'https://api.mobid.io/v1/service/billings?period=2025-01' \
  -H 'X-API-Key: mk_live_your_api_key' \
  -H 'X-Timestamp: 1717171717000' \
  -H 'X-Signature: <hmac-sha256 signature>'

{
  "code": 200,
  "data": {
    "invoices": [
      {
        "id": "inv_abc123",
        "period": "2025-01",
        "amount": 149.00,
        "currency": "USD",
        "status": "paid",
        "paidAt": "2025-02-01T00:00:00Z",
        "items": [
          {"description": "Growth Plan", "amount": 149.00},
          {"description": "API Calls (42,350)", "amount": 0.00}
        ]
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 12
    }
  }
}

{
  "code": 200,
  "data": {
    "period": "2025-01",
    "plan": "Growth",
    "usage": {
      "consents": { "used": 1250, "limit": 50000 },
      "authentications": { "used": 8420, "limit": 100000 },
      "verifications": { "used": 342, "limit": 5000 },
      "mandates": { "used": 89, "limit": 10000 }
    },
    "apiCalls": {
      "total": 42350,
      "dailyAverage": 1366
    }
  }
}