# Using API to Check Customer's Bills

You can obtain the WhatsApp fees for your site's customers by calling the daily billing API.

### Daily Billing Interface <a href="#ycloud-zhang-dan-jie-kou-ri-zhang-dan-jie-kou" id="ycloud-zhang-dan-jie-kou-ri-zhang-dan-jie-kou"></a>

Interface URL: <https://api.ycloud.com/v2/billing/usageDetails>

Function Description: Returns billing data by day, paginated. Grouping criteria: date (daily, fixed UTC+8 time zone), sending region, message channel (WhatsApp, SMS, voice, email), WABA ID (only applicable for WhatsApp channel). Sorting: by date in descending order.

Request Method: GET

Request Headers:

| Parameter            | Description                                                                                                                                                                                                                      |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| X-API-Key            | \[Required] Account API Key, see [Console](https://www.ycloud.com/console/#/app/developers/apikey).                                                                                                                              |
| X-Managed-Account-ID | <p>Applicable only for white-label partners.</p><p>If your account has one or more managed accounts, you can specify a managed account ID, which will make the request as the managed account and retrieve its billing data.</p> |

Request Parameters:

| Parameter        | Description                                                                       |
| ---------------- | --------------------------------------------------------------------------------- |
| page             | <p>Page number, integer, range \[1,100].</p><p>Default is 1.</p>                  |
| limit            | <p>Page size, integer, range \[1,100].</p><p>Default is 10.</p>                   |
| includeTotal     | Whether to return the total record count, values true / false, default is false.  |
| filter.startDate | \[Required] Billing start date (inclusive), format yyyy-MM-dd, example 2024-01-31 |
| filter.endDate   | \[Required] Billing end date (inclusive), format yyyy-MM-dd, example 2024-01-31   |
| filter.wabaId    | WABA ID                                                                           |

**Request Example:**

```
curl 'https://api.ycloud.com/v2/billing/usageDetails?page=1&limit=10&includeTotal=false&filter.startDate=2024-01-01&filter.endDate=2024-01-31&filter.wabaId=WABA-ID' \
-H 'X-API-Key: {{YOUR-API-KEY}}'
```

**Response Example:**

```
{
  "offset": 0,
  "limit": 10,
  "total": 1,
  "length": 1,
  "items": [
    {
      "date": "2024-03-06",
      "isTransient": true,
      "channel": "whatsapp",
      "wabaId": "WABA_ID",
      "regionCode": "CN",
      "costItems": [
        {
          "cost": 1.0,
          "unitPrice": 0.1,
          "quantity": 10,
          "conversationOriginType": "authentication"
        },
        {
          "cost": 3.0,
          "unitPrice": 0.2,
          "quantity": 15,
          "conversationOriginType": "utility"
        }
      ]
    }
  ]
}
```

**Response Fields:**

Common fields like offset, limit, etc., are omitted, see [Pagination](https://docs.ycloud.com/reference/pagination).

The fields of the returned items\[] object are as follows:

| Field                               | Type    | Description                                                                                                                                                                             |
| ----------------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| date                                | string  | Billing date, format yyyy-MM-dd, example 2024-01-31                                                                                                                                     |
| isTransient                         | boolean | <p>Whether it's temporary. For nearly real-time bills from yesterday or today, it might not be accurate and can change, marked as true.</p><p>If false, it means the bill is final.</p> |
| channel                             | string  | Message channel. Enumeration: whatsapp, sms, voice, email.                                                                                                                              |
| wabaId                              | string  | WABA ID. Included when channel is whatsapp.                                                                                                                                             |
| regionCode                          | string  | Region where the message was sent, [two-letter country or region codes](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).                                                              |
| costItems\[].cost                   | double  | Amount consumed, in USD                                                                                                                                                                 |
| costItems\[].quantity               | integer | Number of billed messages                                                                                                                                                               |
| costItems\[].unitPrice              | double  | Average unit price                                                                                                                                                                      |
| costItems\[].conversationOriginType | string  | <p>WhatsApp conversation type. Included only when channel is whatsapp.</p><p>Enumeration: authentication, authentication\_international, marketing, utility, service.</p>               |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdocs.ycloud.com/partner-center/english-en-2/bai-biao-huo-ban/partner-platform-management-api/shi-yong-api-cha-xun-ke-hu-de-zhang-dan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.