Bill Query

Pull day-level consumption details and summaries from TenndaAI for reconciliation, cost analysis, and bill collection

GET /prod-api/api/logs/v2/getDailyList

Bill Query

cURL

curl --request GET \
  --url https://client.tennda.ai/prod-api/api/logs/v2/getDailyList

Overview

Two read-only billing endpoints: day summaries for net spend trends, and line items broken down by model × token type. Amounts are always USD, billing timezone is utc+8, and data is T+1.

Consumption details

getDailyList: grain (bill day × account × model × token type). Max span 92 days per request; pageSize capped at 100.

Day summary

getDailySummary: grain (bill day × account). Max span 366 days per request; pageSize capped at 400.

Endpoints

Endpoint	Method / path	Use case
Details	GET /api/logs/v2/getDailyList	Line-item reconciliation, cost split
Day summary	GET /api/logs/v2/getDailySummary	Daily trends, monthly overviews

Item	Value
Base URL	https://client.tennda.ai/prod-api
Format / encoding	application/json · UTF-8
Protocol	HTTPS
Currency / timezone	USD · utc+8

Authentication

Send a Bearer credential in the request header — either option works:

Authorization: Bearer <access_token>
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

Credential	Notes
System access token	Console → Profile → Access token
API Key	Usually starts with sk-

Auth failure: HTTP 401, business code 40100.

Never put a full key in URLs, frontend code, logs, or support tickets.

Common response

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 128,
    "rows": []
  }
}

Field	Type	Description
code	integer	0 = success; non-zero = failure
message	string	Status message
data	object / null	Payload; null on failure
data.total	integer	Total matching rows (for pagination)
data.rows	array	Current page

Business error codes

code	HTTP	Description
0	200	Success
40001	400	Bad parameter format (invalid date, non-positive page params, etc.)
40002	400	Missing required parameter
40003	400	Invalid date range (start after end, or span over the limit)
40100	401	Token missing, invalid, or expired
50000	500	Internal server error

---

Details · getDailyList

GET https://client.tennda.ai/prod-api/api/logs/v2/getDailyList

Returns rows keyed by (bill day × account × model × token type).

Request parameters

startDate · string · required

Start date, yyyy-MM-dd

endDate · string · required

End date, yyyy-MM-dd; span with startDate must not exceed 92 days

userId · string

Filter by account ID. Multi-sub-account visibility requires Enterprise Management — see Conventions. Omit to return accounts visible to the current credential.

userName · string

Filter by account name (exact). Same Enterprise Management rules; omit to return accounts visible to the current credential.

pageSize · string · required

Positive integer string, 1 ~ 100; values over 100 are capped at 100

pageNum · string · required

Positive integer string, starting at 1

Pagination is by detail row; data.total is the total number of matching detail rows.

Response fields (data.rows[])

Field	Type	Description
billMonth	string	Billing month, yyyyMM
billDay	string	Billing day, yyyy-MM-dd
billingDateTimezone	string	Always utc+8
account	string	Account name
modelType	string	Model family, e.g. claude, gpt, gemini
modelName	string	Model name
tokenType	string	Token type — see below
tokenCount	string	Token count for this type (integer as string)
tokenUnit	string	Always million (priced per million tokens)
currency	string	Always USD
subtotalBeforeTax	string	Pre-discount, pre-tax (8 decimals)
subtotalAfterDiscount	string	Post-discount, pre-tax (8 decimals)
totalAmountAfterTax	string	Post-discount, post-tax (8 decimals)
price	string	Pre-discount unit price per million tokens (8 decimals). subtotalBeforeTax = price × tokenCount ÷ 1,000,000; may be omitted when tokenCount is 0
entryType	string	normal = normal consumption

tokenType

Value	Meaning
textInputTokens	Text input
textOutputTokens	Text output
reasoningTokens	Reasoning / thinking
cacheCreationTokens5m	Cache creation (5-minute TTL)
cacheCreationTokens1h	Cache creation (1-hour TTL)
cacheTokens	Cache hit (read)
imageInputTokens / imageOutputTokens	Image in / out
audioInputTokens / audioOutputTokens	Audio in / out
videoInputTokens / videoOutputTokens	Video in / out

Sort: billDay desc, then account, modelName, tokenType, currency asc.

Request example

curl "https://client.tennda.ai/prod-api/api/logs/v2/getDailyList?startDate=2026-07-27&endDate=2026-07-27&pageSize=100&pageNum=1" \
  -H "Authorization: Bearer <your_token>"

Response example

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 23,
    "rows": [
      {
        "billMonth": "202607",
        "billDay": "2026-07-27",
        "billingDateTimezone": "utc+8",
        "account": "your_account",
        "modelType": "claude",
        "modelName": "claude-opus-4-8",
        "tokenType": "textOutputTokens",
        "tokenCount": "2931",
        "tokenUnit": "million",
        "currency": "USD",
        "subtotalBeforeTax": "0.07327564",
        "subtotalAfterDiscount": "0.07327564",
        "totalAmountAfterTax": "0.07327564",
        "price": "25.00021836",
        "entryType": "normal"
      }
    ]
  }
}

---

Day summary · getDailySummary

GET https://client.tennda.ai/prod-api/api/logs/v2/getDailySummary

Day-level net spend. Lighter payload — suited for overviews and trend reports.

Request parameters

startDate · string · required

Start date, yyyy-MM-dd

endDate · string · required

End date, yyyy-MM-dd; span with startDate must not exceed 366 days

userId · string

Filter by account ID (same Enterprise Management rules as details)

userName · string

Filter by account name, exact (same Enterprise Management rules as details)

pageSize · string · required

Positive integer string, 1 ~ 400; values over 400 are capped at 400

pageNum · string · required

Positive integer string, starting at 1

Pagination is by (bill day × account); data.total is the combination count.

Response fields (data.rows[])

Field	Type	Description
billMonth	string	Billing month, yyyyMM
billDay	string	Billing day, yyyy-MM-dd
billingDateTimezone	string	Always utc+8
account	string	Account name
currency	string	Always USD
subtotalBeforeTax	string	Day total, pre-discount pre-tax net (8 decimals)
subtotalAfterDiscount	string	Day total, post-discount pre-tax net (8 decimals)
totalAmountAfterTax	string	Day total, post-discount post-tax net (8 decimals)

Sort: billDay desc, then account asc.

Request example

curl "https://client.tennda.ai/prod-api/api/logs/v2/getDailySummary?startDate=2026-07-01&endDate=2026-07-27&pageSize=31&pageNum=1" \
  -H "Authorization: Bearer <your_token>"

Response example

{
  "code": 0,
  "message": "success",
  "data": {
    "total": 2,
    "rows": [
      {
        "billMonth": "202607",
        "billDay": "2026-07-27",
        "billingDateTimezone": "utc+8",
        "account": "your_account",
        "currency": "USD",
        "subtotalBeforeTax": "0.26569400",
        "subtotalAfterDiscount": "0.26569400",
        "totalAmountAfterTax": "0.26569400"
      }
    ]
  }
}

---

Conventions

1. Amounts: Always string with 8 decimal places — use Decimal / BigDecimal; do not convert to binary floats.
2. Consistency: For the same bill day and account, each day-summary amount equals the sum of the matching detail amounts that day (sum across pages).
3. Zero days: Days with no consumption in the range are omitted.
4. Freshness: Bills are T+1 — the latest day is queryable the next day.
5. Account scope: Default is own account only. A primary account with Enterprise Management can see all sub-accounts — omit userId / userName for all, or pass them to filter; a sub-account credential only sees itself. Contact a TenndaAI admin to enable Enterprise Management.
6. Out-of-range pages: When pageNum exceeds total pages, rows is empty while total remains the true total.