> ## Documentation Index
> Fetch the complete documentation index at: https://help.eazybe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get pricing analytics

> Returns billable conversations and cost for a Unix time range.



## OpenAPI

````yaml /api-reference/meta/openapi.yaml get /meta/wabas/{wabaId}/pricing-analytics
openapi: 3.1.0
info:
  title: Eazybe Meta API Documentation
  version: 1.0.0
  description: |
    A single authenticated Eazybe REST surface over WhatsApp Business Cloud API.
    The wrapper uses the Meta credentials captured when a WABA is connected to
    Eazybe, so callers never send Meta access tokens directly.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: Eazybe staging API v2.
security:
  - bearerAuth: []
tags:
  - name: Phone numbers
    description: Discover connected WABAs and phone-number IDs.
  - name: Messaging
    description: Send WhatsApp messages and update message state.
  - name: Templates
    description: Manage WhatsApp message templates.
  - name: Media
    description: Upload, inspect, and delete WhatsApp media.
  - name: Webhooks
    description: Manage WABA webhook subscriptions.
  - name: Analytics
    description: Read messaging, conversation, pricing, and template analytics.
  - name: Profiles and settings
    description: Manage business profiles and phone-number settings.
  - name: Automation
    description: Configure welcome messages, ice-breakers, and commands.
  - name: QR codes
    description: Manage click-to-chat QR codes.
  - name: Flows
    description: Manage the WhatsApp Flows lifecycle.
  - name: Number administration
    description: Register numbers, manage PINs, and synchronize coexistence data.
  - name: Block list
    description: List, block, and unblock WhatsApp users.
paths:
  /meta/wabas/{wabaId}/pricing-analytics:
    get:
      tags:
        - Analytics
      summary: Get pricing analytics
      description: Returns billable conversations and cost for a Unix time range.
      operationId: getPricingAnalytics
      parameters:
        - $ref: '#/components/parameters/WabaId'
        - name: start
          in: query
          required: true
          description: Start of the range in Unix seconds.
          schema:
            type: integer
        - name: end
          in: query
          required: true
          description: End of the range in Unix seconds.
          schema:
            type: integer
        - name: granularity
          in: query
          required: false
          schema:
            type: string
            enum:
              - HALF_HOUR
              - DAILY
              - MONTHLY
            default: DAILY
        - name: phoneNumbers
          in: query
          required: false
          description: Comma-separated phone-number IDs.
          schema:
            type: string
        - name: metricTypes
          in: query
          required: false
          description: Comma-separated metric types.
          schema:
            type: string
        - name: dimensions
          in: query
          required: false
          description: Comma-separated dimensions.
          schema:
            type: string
      responses:
        '200':
          description: >-
            Pricing data returned


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `404` | `wabaId` not linked to your organization | Verify the id |

            | `400` | `start`/`end` missing or non-numeric, or invalid
            `granularity` | Always send Unix-second `start` and `end` |

            | `502` | Graph unreachable or timed out | Retry with backoff |
          content:
            application/json:
              schema:
                type: object
                required:
                  - pricing_analytics
                  - id
                properties:
                  pricing_analytics:
                    type: object
                    required:
                      - data
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          required:
                            - data_points
                          properties:
                            data_points:
                              type: array
                              items:
                                type: object
                                required:
                                  - start
                                  - end
                                  - volume
                                  - cost
                                  - pricing_type
                                  - pricing_category
                                  - phone_number
                                properties:
                                  start:
                                    type: integer
                                  end:
                                    type: integer
                                  volume:
                                    type: integer
                                  cost:
                                    type: number
                                  pricing_type:
                                    type: string
                                  pricing_category:
                                    type: string
                                  phone_number:
                                    type: string
                  id:
                    type: string
              example:
                pricing_analytics:
                  data:
                    - data_points:
                        - start: 1753900000
                          end: 1753986400
                          volume: 412
                          cost: 3.71
                          pricing_type: REGULAR
                          pricing_category: MARKETING
                          phone_number: '919900000000'
                id: '1029384756'
components:
  parameters:
    WabaId:
      name: wabaId
      in: path
      required: true
      description: WhatsApp Business Account ID returned by `GET /meta/phone-numbers`.
      schema:
        type: string
      example: '1029384756'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: |
        Eazybe bearer token. The token resolves the caller's organization and
        must be kept on the server.

````