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

# List business messaging usage ledger entries

> Lists current-business usage ledger entries with paging, sorting, and filters for messaging, billing, and wallet review.



## OpenAPI

````yaml /openapi.json post /usage/all/my
openapi: 3.0.4
info:
  title: Leadping API
  description: >-
    Leadping API for lead intake, messaging, calling, automations, billing,
    business settings, and compliant lead communication workflows.
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  version: v1
servers:
  - url: https://api.leadping.ai
    description: Production
security: []
tags:
  - name: Analytics
  - name: Automations
  - name: Contact
  - name: Conversations
  - name: Dispositions
  - name: Feedback
  - name: Leads
  - name: LeadStatuses
  - name: Notifications
  - name: OutboundDelivery
  - name: Sources
  - name: Suppressions
  - name: Tags
  - name: Users
  - name: Calls
  - name: PhoneNumbers
  - name: Sms
  - name: Telephony
  - name: UserDataExports
  - name: CallEvents
  - name: Events
  - name: SmsEvents
  - name: Businesses
  - name: PaymentMethods
  - name: Transactions
  - name: Usage
  - name: Wallets
paths:
  /usage/all/my:
    post:
      tags:
        - Usage
      summary: List business messaging usage ledger entries
      description: >-
        Lists current-business usage ledger entries with paging, sorting, and
        filters for messaging, billing, and wallet review.
      operationId: Usage_GetAllForCurrentBusiness
      requestBody:
        description: The filtering, sorting, and pagination options.
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/RequestDataOptions'
              description: >-
                Options for flexible, efficient, and explicit querying in Cosmos
                DB or similar repositories.
          application/*+json:
            schema:
              allOf:
                - $ref: '#/components/schemas/RequestDataOptions'
              description: >-
                Options for flexible, efficient, and explicit querying in Cosmos
                DB or similar repositories.
        required: true
      responses:
        '200':
          description: Returns the paged usage ledger table row.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PagedResultOfUsageLedgerTableRow'
                description: >-
                  A generic container for paginated results returned to the
                  client.
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
components:
  schemas:
    RequestDataOptions:
      type: object
      properties:
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: Maximum items to return in one page
          format: int32
        continuationToken:
          type: string
          description: >-
            Opaque Cosmos DB continuation token. ‑ on the **first** request. ‑
            Client must echo back the NextToken it received from the previous
            page.
          nullable: true
        orderBy:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/OrderByOption'
            description: An object for ordering during querying
          description: List of sort instructions, in priority order.
          nullable: true
        includeCount:
          type: boolean
          description: Whether to include the total count in the response (for pagination).
          nullable: true
        search:
          type: string
          description: The search term to filter results (applied to ).
          nullable: true
        searchFields:
          type: array
          items:
            type: string
          description: >-
            The list of fields to apply the Search term to (must be string
            properties).
          nullable: true
        filters:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/ExactMatchFilter'
            description: >-
              A generic object for handling exact match filtering during
              querying
          description: Key-value exact match filters (e.g., Status = Active).
          nullable: true
        rangeFilters:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/RangeFilter'
            description: A generic object for handling range filtering during querying
          description: Advanced range-based filters (e.g., Price > 50 and Price <= 200).
          nullable: true
      description: >-
        Options for flexible, efficient, and explicit querying in Cosmos DB or
        similar repositories.
    PagedResultOfUsageLedgerTableRow:
      type: object
      properties:
        items:
          type: array
          items:
            allOf:
              - $ref: '#/components/schemas/UsageLedgerTableRow'
            description: >-
              API DTO containing usage ledger data used by Leadping API
              contracts.
          description: The subset of items returned for the current page.
        pageSize:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            The number of items returned per page in the response. This may
            reflect the client's requested page size, or a server-defined
            default or limit.
          format: int32
        totalCount:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: >-
            The total number of items that match the query across all pages. May
            be null if the count is not computed or not applicable (e.g., in
            continuation-based pagination).
          format: int32
          nullable: true
        continuationToken:
          type: string
          description: >-
            Opaque storage continuation token. ‑ `null` → the current page was
            the last page.
          nullable: true
      description: A generic container for paginated results returned to the client.
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          description: URI reference that identifies the problem type.
          nullable: true
        title:
          type: string
          description: Short, human-readable summary of the problem.
          nullable: true
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: HTTP status code returned for the problem.
          format: int32
          nullable: true
        detail:
          type: string
          description: >-
            Human-readable explanation specific to this occurrence of the
            problem.
          nullable: true
        instance:
          type: string
          description: >-
            URI reference that identifies this specific occurrence of the
            problem.
          nullable: true
    OrderByOption:
      type: object
      properties:
        field:
          type: string
          description: The field to sort by.
        direction:
          enum:
            - asc
            - desc
          type: string
          description: An enumerator for sort direction during querying
          nullable: true
      description: An object for ordering during querying
    ExactMatchFilter:
      type: object
      properties:
        value:
          description: The value that the field must match.
        field:
          type: string
          description: The field to filter by.
      description: A generic object for handling exact match filtering during querying
    RangeFilter:
      type: object
      properties:
        greaterThan:
          description: The exclusive lower bound for the field value.
        greaterThanOrEqual:
          description: The inclusive lower bound for the field value.
        lessThan:
          description: The exclusive upper bound for the field value.
        lessThanOrEqual:
          description: The inclusive upper bound for the field value.
        field:
          type: string
          description: The field to filter by.
      description: A generic object for handling range filtering during querying
    UsageLedgerTableRow:
      type: object
      properties:
        id:
          type: string
          description: The unique ID for this usage ledger.
        business:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: The ID and name for this business.
          nullable: true
        user:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: The ID and name for this user.
          nullable: true
        lead:
          type: object
          allOf:
            - $ref: '#/components/schemas/IdNamePair'
          description: The ID and name for this lead.
          nullable: true
        phoneNumberId:
          type: string
          description: The phone number ID associated with this usage ledger.
          nullable: true
        phoneNumber:
          type: string
          description: The phone number associated with this usage ledger.
          nullable: true
        channel:
          allOf:
            - $ref: '#/components/schemas/UsageChannel'
          description: The channel value for this usage ledger.
        billableUnit:
          allOf:
            - $ref: '#/components/schemas/BillableUnit'
          description: The billable unit value for this usage ledger.
        status:
          allOf:
            - $ref: '#/components/schemas/UsageRecordStatus'
          description: The current status for this usage ledger.
        quantity:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          description: The quantity value for this usage ledger.
          format: double
        durationSeconds:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: The duration seconds value for this usage ledger.
          format: int32
          nullable: true
        billableSeconds:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: The billable seconds value for this usage ledger.
          format: int32
          nullable: true
        smsSegments:
          pattern: ^-?(?:0|[1-9]\d*)$
          description: The SMS segments value for this usage ledger.
          format: int32
          nullable: true
        unitPrice:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          description: The unit price value for this usage ledger.
          format: double
        customerChargeAmount:
          pattern: ^-?(?:0|[1-9]\d*)(?:\.\d+)?$
          description: The monetary customer charge amount for this usage ledger.
          format: double
        isBillable:
          type: boolean
          description: Whether this usage ledger is billable.
        description:
          type: string
          description: The human-readable description of this usage ledger.
          nullable: true
        createdAt:
          type: string
          description: The date and time for the created at value on this usage ledger.
          format: date-time
      description: API DTO containing usage ledger data used by Leadping API contracts.
    IdNamePair:
      required:
        - id
        - name
      type: object
      properties:
        id:
          type: string
          description: The unique identifier.
        name:
          type: string
          description: The display name.
      description: >-
        A minimal Record type with an (string), (string), and maximum JSON
        compatibility. The reason for this type (over something like
        KeyValuePair, dictionary) is because of JSON serialization support.
    UsageChannel:
      enum:
        - sms
        - mms
        - email
        - voice
        - phone_number
        - warmup
        - website
        - domain
        - 10dlc
        - connection
        - automation
      type: string
      description: Defines the supported Usage Channel values.
    BillableUnit:
      enum:
        - sms_segment
        - mms_message
        - email_message
        - voice_minute
        - phone_number_month
        - warmup_sms_segment
        - warmup_voice_minute
        - website_setup
        - domain_registration
        - 10dlc_application
        - connection_action
        - automation_run
      type: string
      description: Defines the supported Billable Unit values.
    UsageRecordStatus:
      enum:
        - recorded
        - rated
        - pending_invoice
        - invoiced
        - charged
        - failed
        - refunded_credited
        - non_billable_internal
        - blocked_due_to_billing
      type: string
      description: Defines the supported Usage Record Status values.

````