Query Daily Bill

Request URL

https://api.xiaomimimo.com/v1/platform/billing/daily?start_date=2026-10-01&end_date=2026-10-02

Request Header

This interface supports the following two authentication methods. Please select one of them and add it to the request header (this interface requires a regular API Key sk-):

api-key: $MIMO_API_KEY

Query Parameters

Parameters	Type	Required	Description
`start_date`	string	Yes	Start date, UTC calendar day, format: `YYYY-MM-DD`
`end_date`	string	Yes	End date, UTC calendar day, in the format of `YYYY-MM-DD`; the time span between this date and `start_date` shall not exceed 31 days

Note:

The query interval is a closed interval. end_date If it is later than today, the result will be returned based on the existing data.
The earliest queryable date is 2026-09-01. If the specified interval has no overlap with the queryable range, an empty list will be returned without any error reported.
There is no pagination, and all records within the range are returned at one time. The results are sorted in descending order by date, and by currency for records on the same day.
The scope of aggregation covers API call consumption and bonus write-off.

response

objectstring
Object type.
Optional values: list
dataarray
Daily billing record array.
Hide child attributes
data.datestring
Bill date, format YYYY-MM-DD.
data.currencystring
Currency.
data.original_amountstring
Original amount (before discount), 2 decimal places.
data.discount_amountstring
Discount amount = original amount - discounted amount, 2 decimal places.
data.gift_amountstring
Bonus deduction amount, with 2 decimal places.
data.final_paid_amountstring
Actual payment amount = Amount after discount - Bonus deduction, rounded to 2 decimal places.

Definition of Amount Caliber

Original Amount: Calculated based on the public standard unit price multiplied by Token consumption, without deducting any discounts, and only serves as a benchmark reference.
Discount Reduction Amount: The amount of pricing discount enjoyed by the user.
Discounted Consumption Amount (Usage-based Consumption Amount) : Original Amount - Discount Deduction Amount; it refers to the amount payable after deducting discounts and before deducting bonus funds, which is also the consumption amount returned by the usage interface and serves as the benchmark item for reconciliation.
Bonus Write-off Amount: The amount deducted using bonus funds, which constitutes a deduction in the payment process and does not qualify as a pricing discount.
Final actual payment amount: Consumption amount after discount - Bonus write-off amount, which refers to the actual cash expenditure of the user.

Calculation formula:

Discounted consumption amount = Original amount − Discount reduction amount

Final actual payment amount = Discounted consumption amount − Bonus write-off amount

curl --location --request GET 'https://api.xiaomimimo.com/v1/platform/billing/daily?start_date=2026-10-31&end_date=2026-11-01' \
--header 'Authorization: Bearer $MIMO_API_KEY'

response

{
  "object": "list",
  "data": [
    {
      "date": "2026-10-02",
      "currency": "CNY",
      "original_amount": "10.01",
      "discount_amount": "0.00",
      "gift_amount": "0.00",
      "final_paid_amount": "10.01"
    },
    {
      "date": "2026-10-01",
      "currency": "CNY",
      "original_amount": "5.00",
      "discount_amount": "0.50",
      "gift_amount": "1.00",
      "final_paid_amount": "3.50"
    }
  ]
}

Update Time November 03, 2026

curl --location --request GET 'https://api.xiaomimimo.com/v1/platform/billing/daily?start_date=2026-10-31&end_date=2026-11-01' \
--header 'Authorization: Bearer $MIMO_API_KEY'

response

{
  "object": "list",
  "data": [
    {
      "date": "2026-10-02",
      "currency": "CNY",
      "original_amount": "10.01",
      "discount_amount": "0.00",
      "gift_amount": "0.00",
      "final_paid_amount": "10.01"
    },
    {
      "date": "2026-10-01",
      "currency": "CNY",
      "original_amount": "5.00",
      "discount_amount": "0.50",
      "gift_amount": "1.00",
      "final_paid_amount": "3.50"
    }
  ]
}