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

# List contract recurring discounts

> Lists the recurring discounts configured for a contract.



## OpenAPI

````yaml /api-reference/openapi.yaml get /v1/contracts/{id}/recurring-discounts
openapi: 3.1.0
info:
  title: API Reference
  version: '1.0'
  description: Aira API Reference
  x-logo:
    url: https://static.useaira.com/images/airalogo.svg
    backgroundColor: '#FFFFFF'
    altText: Aira Logo
servers:
  - url: https://api.useaira.com
    description: API base URL
security:
  - ApiKey: []
paths:
  /v1/contracts/{id}/recurring-discounts:
    get:
      tags:
        - Contracts
      summary: List contract recurring discounts
      description: Lists the recurring discounts configured for a contract.
      parameters:
        - schema:
            type: string
            format: uuid
          in: path
          name: id
          required: true
          description: Unique identifier for the contract.
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      description: >-
                        Schema representing a recurring discount configured on a
                        contract. On every billing cycle within its validity
                        window, the discount is applied to the generated
                        invoices as an invoice discount, as long as it is active
                        (see isActive).
                      properties:
                        id:
                          type: string
                          format: uuid
                          description: >-
                            The unique identifier of the recurring discount in
                            our system.
                        planId:
                          type: string
                          format: uuid
                          nullable: true
                          description: >-
                            The unique identifier of the plan targeted by the
                            discount, for plan and metric target scopes. Null
                            for invoice and contract_minimum_amount scopes.
                        targetScope:
                          type: string
                          enum:
                            - invoice
                            - plan
                            - metric
                            - contract_minimum_amount
                          description: >-
                            What the discount applies to on each generated
                            invoice: invoice (the whole invoice), plan (the line
                            item group of the targeted plan), metric (the line
                            item of the targeted usage charge), or
                            contract_minimum_amount (the contract minimum
                            commitment line item).
                        method:
                          type: string
                          enum:
                            - fixed
                            - percentage
                          description: >-
                            How amount is interpreted: fixed subtracts a
                            monetary amount; percentage subtracts a percentage
                            of the targeted amount.
                        amount:
                          type: number
                          multipleOf: 1
                          minimum: 1
                          description: >-
                            Value of the discount, as a positive integer: whole
                            cents when method is fixed; basis points when method
                            is percentage (1 basis point = 0.01%; maximum 10000
                            = 100%).
                        description:
                          type: string
                          minLength: 1
                          description: >-
                            Display text of the discount as it appears on
                            invoices.
                        startDate:
                          type: string
                          format: date
                          description: First billing cycle date the discount applies to.
                        endDate:
                          type: string
                          format: date
                          nullable: true
                          description: >-
                            Last billing cycle date the discount applies to.
                            Null when the discount has no end date.
                        distributionMode:
                          type: string
                          enum:
                            - proportional
                            - full
                          description: >-
                            For fixed discounts on contracts that split invoices
                            across payment accounts: full applies the whole
                            amount on each invoice of the cycle; proportional
                            splits the amount across the cycle's invoices in
                            proportion to their totals. Percentage discounts
                            always apply per invoice.
                        isActive:
                          type: boolean
                          description: >-
                            Whether the discount is applied to new billing
                            cycles. Inactive discounts are kept for history but
                            no longer applied.
                      required:
                        - id
                        - planId
                        - targetScope
                        - method
                        - amount
                        - description
                        - startDate
                        - endDate
                        - distributionMode
                        - isActive
                      additionalProperties: false
                    description: A list of items.
                required:
                  - items
                additionalProperties: false
        '404':
          description: Error object returned to the client when a resource is not found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: A human-readable description of the error
components:
  securitySchemes:
    ApiKey:
      type: apiKey
      description: API Key Authentication.
      name: X-API-KEY
      in: header

````