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

# List usage cost groups



## OpenAPI

````yaml https://api.arklow.io/swagger/ui/json get /v1/orgs/{org_id}/usage/costs/breakdown
openapi: 3.1.0
info:
  title: Arklow
  description: Arklow's API
  version: 0.1.0
servers:
  - url: https://api.arklow.io
    description: Production
  - url: http://localhost:3123
    description: Local development
security:
  - apiKey: []
tags:
  - name: actions
  - name: api_keys
  - name: billing
  - name: billing-sources
  - name: capacity-domains
  - name: credentials
  - name: destinations
  - name: invites
  - name: members
  - name: metrics
  - name: notifications
  - name: orgs
  - name: rules
  - name: scale-targets
  - name: sources
  - name: usage
  - name: users
  - name: ingress
externalDocs:
  url: https://api.arklow.io/swagger/ui
paths:
  /v1/orgs/{org_id}/usage/costs/breakdown:
    get:
      tags:
        - usage
      summary: List usage cost groups
      operationId: get_v1_orgs_by_org_id_usage_costs_breakdown
      parameters:
        - schema:
            type: string
            format: date-time
          in: query
          name: from
          required: true
        - schema:
            type: string
            format: date-time
          in: query
          name: to
          required: true
        - schema:
            type: string
            minLength: 1
            maxLength: 256
          in: query
          name: group
          required: true
        - schema:
            type: string
            minLength: 1
            maxLength: 16
          in: query
          name: currency
          required: true
        - schema:
            anyOf:
              - type: string
                enum:
                  - cost
              - type: string
                enum:
                  - hours
            default: cost
          in: query
          name: sort
          required: false
        - schema:
            anyOf:
              - type: string
                enum:
                  - asc
              - type: string
                enum:
                  - desc
            default: desc
          in: query
          name: order
          required: false
        - schema:
            type: string
          in: query
          name: search
          required: false
        - schema:
            type: string
            pattern: ^[0-9]+$
          in: path
          name: org_id
          required: true
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - errors
                properties:
                  data:
                    anyOf:
                      - type: object
                        required:
                          - from
                          - to
                          - group
                          - currency
                          - groups
                          - group_count
                        properties:
                          from:
                            type: string
                            format: date-time
                          to:
                            type: string
                            format: date-time
                          group:
                            type: array
                            items:
                              type: string
                          currency:
                            type: string
                          groups:
                            type: array
                            items:
                              type: object
                              required:
                                - keys
                                - effective_cost
                                - billed_cost
                                - estimate_cost
                                - consumed_seconds
                              properties:
                                keys:
                                  type: array
                                  items:
                                    type: string
                                effective_cost:
                                  type: string
                                billed_cost:
                                  type: string
                                estimate_cost:
                                  type: string
                                consumed_seconds:
                                  type: string
                          group_count:
                            type: integer
                      - type: 'null'
                  errors:
                    anyOf:
                      - type: array
                        items:
                          type: object
                          required:
                            - code
                            - message
                          properties:
                            code:
                              type: string
                            message:
                              type: string
                      - type: 'null'
                  warnings:
                    type: array
                    items:
                      type: object
                      required:
                        - code
                        - message
                      properties:
                        code:
                          type: string
                        message:
                          type: string
        '400':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - errors
                properties:
                  data:
                    anyOf:
                      - type: 'null'
                      - type: 'null'
                  errors:
                    anyOf:
                      - type: array
                        items:
                          type: object
                          required:
                            - code
                            - message
                          properties:
                            code:
                              type: string
                            message:
                              type: string
                      - type: 'null'
                  warnings:
                    type: array
                    items:
                      type: object
                      required:
                        - code
                        - message
                      properties:
                        code:
                          type: string
                        message:
                          type: string
        '404':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - errors
                properties:
                  data:
                    anyOf:
                      - type: 'null'
                      - type: 'null'
                  errors:
                    anyOf:
                      - type: array
                        items:
                          type: object
                          required:
                            - code
                            - message
                          properties:
                            code:
                              type: string
                            message:
                              type: string
                      - type: 'null'
                  warnings:
                    type: array
                    items:
                      type: object
                      required:
                        - code
                        - message
                      properties:
                        code:
                          type: string
                        message:
                          type: string
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-arklow-auth
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.