# Show Service Usage History

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /v1/billing/service_usage/history:
    get:
      summary: Show Service Usage History
      deprecated: false
      description: ''
      tags:
        - API Reference/Management API/Core/Billing/Service Usages/History
      parameters:
        - name: from_offset
          in: query
          description: >-
            Offset (in months) from current month for the start month of the
            report, if not provided, report will start from first customer
            service usage
          required: false
          example: 1
          schema:
            type: integer
            maximum: 24
            minimum: 0
        - name: to_offset
          in: query
          description: >-
            Offset (in months) from current month for the end month of the
            report, if not provided, report will end at last month that customer
            has any usage record (typically current month), if provided cannot
            be greater than from_offset
          required: false
          example: 1
          schema:
            type: integer
        - name: Content-Type
          in: header
          description: '[Details](doc-341635)'
          required: true
          example: application/json
          schema:
            type: string
            default: application/json
            const: application/json
        - name: X-User-Agent
          in: header
          description: Arbitrary identifier of your client. [Details](doc-341635)
          required: true
          example: '{{X_USER_AGENT}}'
          schema:
            type: string
            default: '{{X_USER_AGENT}}'
        - name: X-Product-Name
          in: header
          description: API Product for API context. [Details](doc-341635)
          required: true
          example: '{{PRODUCT_NAME}}'
          schema:
            type: string
            default: '{{PRODUCT_NAME}}'
        - name: X-Loyalty-Club-Slug
          in: header
          description: LoyaltyClub for API context. [Details](doc-342138)
          required: false
          example: '{{LOYALTY_CLUB_SLUG}}'
          schema:
            type: string
            default: '{{LOYALTY_CLUB_SLUG}}'
        - name: X-Customer
          in: header
          description: Customer for API context.  [Details](doc-342139)
          required: false
          example: '{{CUSTOMER_ID}}'
          schema:
            type: string
            default: '{{CUSTOMER_ID}}'
        - name: X-Client-Authorization
          in: header
          description: '[Token](doc-342128) Authorization.'
          example: '{{API_TOKEN}}'
          schema:
            type: string
            default: '{{API_TOKEN}}'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  service_usage_history:
                    type: array
                    items:
                      $ref: '#/components/schemas/ServiceUsageHistory'
                required:
                  - service_usage_history
                x-apidog-orders:
                  - service_usage_history
                x-apidog-ignore-properties: []
              example:
                service_usage_history:
                  - period: '04.2025'
                    data:
                      - service: domains
                        usage: '0.0'
          headers: {}
          x-apidog-name: Success
        '422':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                  details:
                    type: object
                    properties: {}
                    x-apidog-orders: []
                    x-apidog-ignore-properties: []
                required:
                  - error
                  - details
                x-apidog-orders:
                  - error
                  - details
                x-apidog-ignore-properties: []
              example:
                error: Invalid parameters
                details:
                  to_offset:
                    - error: greater_than_from_offset
          headers: {}
          x-apidog-name: Parameter Error
      security: []
      x-apidog-folder: API Reference/Management API/Core/Billing/Service Usages/History
      x-apidog-status: released
      x-run-in-apidog: https://app.eu.apidog.com/web/project/346351/apis/api-3799839-run
components:
  schemas:
    ServiceUsageHistory:
      type: object
      properties:
        period:
          type: string
          examples:
            - '01.2025'
        data:
          type: array
          items:
            type: object
            properties:
              service:
                type: string
                examples:
                  - domains
              usage:
                type: string
                examples:
                  - '0.0'
            x-apidog-orders:
              - service
              - usage
            x-apidog-ignore-properties: []
      required:
        - period
        - data
      x-apidog-orders:
        - period
        - data
      x-apidog-ignore-properties: []
      x-apidog-folder: ''
  securitySchemes: {}
servers:
  - url: https://api.mpc.dev.placewise.com
    description: Staging
security: []

```