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

# Per-customer nesting-minutes usage breakdown

> Admin only (an Admin API key or the account owner). Returns how the account's nesting minutes are being shared across your API keys for the current period. Each row is one of your keys (i.e. one of your customers): the minutes it has consumed, its guaranteed fair-share floor, any overage it incurred, and a sizing signal to help you right-size weights. When fairness is not enabled on the plan the rows are informational only.



## OpenAPI

````yaml /openapi.json get /usage/fairness
openapi: 3.0.0
info:
  title: NestAPI
  version: '1.0'
servers:
  - description: Staging
    url: https://dev.api.nestapi.com
security: []
tags:
  - name: account
    description: API key and account management
  - name: ApiAdmin
  - name: auth
  - name: fairness
    description: >-
      Per-customer nesting-minutes fairness config, weights and usage (requires
      an Admin API key)
  - name: importer
  - name: nesting
    description: Submit nesting jobs, retrieve results and exports
  - name: public
    description: Health check and public utility endpoints
paths:
  /usage/fairness:
    parameters:
      - $ref: '#/components/parameters/Accept'
    get:
      tags:
        - fairness
      summary: Per-customer nesting-minutes usage breakdown
      description: >-
        Admin only (an Admin API key or the account owner). Returns how the
        account's nesting minutes are being shared across your API keys for the
        current period. Each row is one of your keys (i.e. one of your
        customers): the minutes it has consumed, its guaranteed fair-share
        floor, any overage it incurred, and a sizing signal to help you
        right-size weights. When fairness is not enabled on the plan the rows
        are informational only.
      operationId: GetFairnessUsage
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FairnessUsageResponse'
      deprecated: false
      security:
        - Bearer: []
components:
  parameters:
    Accept:
      name: Accept
      in: header
      description: Accept Header
      required: true
      schema:
        type: string
        enum:
          - application/json
  schemas:
    FairnessUsageResponse:
      title: FairnessUsageResponse
      properties:
        FairnessEnabled:
          type: boolean
          nullable: false
        OverageEnabled:
          type: boolean
          nullable: false
        IncludedMinutes:
          type: number
          format: double
          nullable: false
        SharedBurstMinutes:
          type: number
          format: double
          nullable: false
        Keys:
          type: array
          items:
            $ref: '#/components/schemas/FairnessKeyUsage'
      description: FairnessUsageResponse
      type: object
    FairnessKeyUsage:
      title: FairnessKeyUsage
      properties:
        ApiKeyId:
          type: string
        Weight:
          type: integer
          format: int32
          nullable: false
        ConsumedMinutes:
          type: number
          format: double
          nullable: false
        ReservedMinutes:
          type: number
          format: double
          nullable: false
        OverageMinutes:
          type: number
          format: double
          nullable: false
        EffectiveFloorMinutes:
          type: number
          format: double
          nullable: false
        Sizing:
          type: string
      description: FairnessKeyUsage
      type: object
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header

````