Get end-user Teams bot (MAU) usage and charge for a month

curl --request GET \
  --url https://api.neoagent.io/public-api/billing/end-user-teams-usage \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "active_users": 123,
    "charge": 123,
    "currency": "<string>",
    "month": "<string>",
    "trial_end_date": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

GET

public-api

billing

end-user-teams-usage

Get end-user Teams bot (MAU) usage and charge for a month

curl --request GET \
  --url https://api.neoagent.io/public-api/billing/end-user-teams-usage \
  --header 'Authorization: Bearer <token>'

{
  "data": {
    "active_users": 123,
    "charge": 123,
    "currency": "<string>",
    "month": "<string>",
    "trial_end_date": "2023-11-07T05:31:56Z"
  },
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

Authorizations

Authorization

string

header

required

Authorization: Bearer <token> where <token> is either a neo_sk_<env>_<secret> API key (service account) or a Microsoft Entra ID access token (dashboard user).

Query Parameters

month

string

Month in YYYY-MM format. Defaults to current month.

Response

Success.

data

EndUserTeamsUsage · object

required

End-user (white-label) Teams bot MAU usage + charge for a month.

active_users = distinct end-users with >=2 messages that month. charge is the MSP's own add-on bill for that count (marginal tiers + 100 floor) in currency — for the current month it is a projection that finalizes when the month closes; for a past month it is what was billed. This is the customer's own bill, not provider/LLM cost (see module docstring).

Show child attributes