Monthly invoices

GET /v1/tenant/monthly-invoices

Returns the monthly invoices of your organisation, newest first (up to 36). Each one has everything charged apart from your plan in that month, one line per charge: communications through wede above what the plan includes, units above the plan for each day they were above, production events above the yearly limit, and the fee per production event when your plan has one. It also returns the fee per event of your current plan and, when it applies, the plan Billing suggests. See The monthly invoice. The licence of your plan is invoiced on its own, once a year, and never appears here.

Authentication

API key or session token with the billing:view permission. API keys have it.

Example

curl https://api.wede.pt/v1/tenant/monthly-invoices \
  -H "x-wede-api-key: wede_live_YOUR_KEY"

Response

200 OK. Values below are illustrative.

{
  "event_fee": null,
  "currency": "EUR",
  "upgrade": null,
  "data": [
    {
      "period": "2026-11",
      "status": "issued",
      "lines": [
        { "kind": "communications", "channel": "sms", "units": 1000, "unit_price": 0.05, "amount": 50 },
        { "kind": "stock", "item": "user", "unit_days": 12, "price_per_day": 0.5, "amount": 6 },
        { "kind": "events", "events": 40, "limit": 1000000, "unit_price": 0.01, "amount": 0.4 }
      ],
      "amount": 56.4,
      "comm_amount": 50,
      "stock_amount": 6.4,
      "fee_amount": 0,
      "fee_events": 0,
      "currency": "EUR",
      "invoice_url": "https://invoice.example/..."
    }
  ]
}

number | null

The fee per production event of your current plan, or null when it has none.

string

The currency of your country, ISO 4217.

object | null

The plan Billing suggests, or null. It is suggested when what was charged above your plan in the last monthly invoice (communications, units and events, without the fee per event) is more than the monthly difference to the next plan by price for your organisation (the difference of the yearly prices divided by 12). A month with nothing above the plan clears it.

Show properties

string

The suggested plan. Its conditions are in Plans of your organisation.

string

Its name.

string

The month of the invoice the suggestion comes from, YYYY-MM.

number

What was charged above your plan that month, without the fee per event.

number

Your current yearly price.

number

The yearly price of the suggested plan for your organisation.

number

The difference of the two yearly prices divided by 12.

string

Currency of these amounts.

object[]

The monthly invoices.

Show properties

string

The month, YYYY-MM.

string

issued, or carried when the month was below 0.50 in your currency and goes on the next invoice.

object[]

One line per charge, by kind:

`kind`	Fields
`communications`	`channel`, `units` above what the plan includes, `unit_price`, `amount`
`stock`	`item` (`user`, `device`, `zone`, `webhook`, `data_source`), `unit_days` (each unit above, for each day), `price_per_day`, `amount`
`events`	`events` above the yearly `limit`, `unit_price`, `amount`
`event_fee`	`events` of the month, `fee`, `amount`

number

Total without tax. Taxes are added on the invoice itself.

number

The communications part.

number

The part of units above the plan and of events above the yearly limit, including amounts carried from earlier months.

number

The fee per event part, including amounts carried from earlier months.

integer

Production events charged with the fee.

string

Currency of the invoice.

string | null

Link to the invoice, to see and pay it. null for a carried month.

Errors

Status	Code	When
401	`unauthorized`	Credential missing, malformed, revoked or expired
403	`forbidden`	The credential lacks `billing:view`
404	`not_found`	The credential is not linked to a tenant
503	`service_unavailable`	Not available right now. Retry

Overview

Authentication

Events

Teams & Dispatch

Missions

Zones

Billing

Tenant

Webhooks

Sync

Connectivity

Sandbox

Parsers

Onboarding

Authentication

Example

Response

Errors

​Authentication

​Example

​Response

​Errors

Authentication

Example

Response

Errors