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

# Individual calls for a period

> List your individual calls over a period, newest first, to reconcile against an invoice.



## OpenAPI

````yaml /suite/api-reference/openapi.json get /usage/v1/calls
openapi: 3.1.0
info:
  title: Privue API Suite
  description: >-
    Identity and account verification against government and banking sources.


    **Authentication.** Every request takes your API key as a bearer token:
    `Authorization: Bearer <your-key>`. A successful call to a billed endpoint
    deducts one credit; a call that fails is not charged.


    **Versioning.** Each endpoint is versioned on its own, directly in its path.
    A new version of one endpoint never moves another, so no release requires
    migrating every integration at once.


    **Retention.** Nothing you send and nothing we return is stored. Documents
    are returned as the issuer's own download links, and the response is the
    only copy, so retrieve what you need when you receive it. We record that a
    call happened, for billing and audit, never what it was about.
  version: 1.0.0
servers:
  - url: https://api.privue.ai
    description: Production
security: []
paths:
  /usage/v1/calls:
    get:
      tags:
        - Usage
      summary: Individual calls for a period
      description: >-
        List your individual calls over a period, newest first, to reconcile
        against an invoice.
      operationId: usage_calls
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 500
            minimum: 1
            description: Calls per page
            default: 100
            title: Limit
          description: Calls per page
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: '`next_cursor` from the previous page'
            title: Cursor
          description: '`next_cursor` from the previous page'
        - name: from
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: First day to count, inclusive
            title: From
          description: First day to count, inclusive
        - name: to
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date
              - type: 'null'
            description: Last day to count, inclusive
            title: To
          description: Last day to count, inclusive
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallPage'
        default:
          description: The request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    CallPage:
      properties:
        calls:
          items:
            $ref: '#/components/schemas/Call'
          type: array
          title: Calls
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
          description: Pass as `cursor` to fetch the next page; absent on the last page
      type: object
      title: CallPage
      description: A page of calls, newest first.
    ErrorResponse:
      properties:
        code:
          type: integer
          title: Code
          description: HTTP status code of the response
        timestamp:
          type: integer
          title: Timestamp
          description: Unix millisecond timestamp of when the response was produced
        message:
          type: string
          title: Message
          description: What went wrong, in one sentence
        transaction_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Transaction Id
          description: >-
            Identifier for the call, present when it reached the source. Quote
            it when raising a query
      type: object
      required:
        - code
        - timestamp
        - message
      title: ErrorResponse
      description: Why a request failed.
    Call:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Our identifier for this call
        at:
          type: string
          format: date-time
          title: At
          description: When the call was made, in IST
        operation:
          type: string
          title: Operation
          description: The operation called, as endpoint and action
        version:
          type: string
          title: Version
          description: Version of that endpoint which served the call
        status_code:
          type: integer
          title: Status Code
          description: HTTP status the call returned
        billed:
          type: boolean
          title: Billed
          description: Whether this call deducted a credit
        duration_ms:
          type: integer
          title: Duration Ms
          description: How long the call took, in milliseconds
        reference:
          anyOf:
            - type: string
            - type: 'null'
          title: Reference
          description: Quote this when raising a query about a particular call
      type: object
      required:
        - id
        - at
        - operation
        - version
        - status_code
        - billed
        - duration_ms
      title: Call
      description: One call, as it appears on a usage statement.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````