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

# Inflation Factors

> Retrieve inflation factors for a given country and date range.
    Inflation factors are used to adjust principal and coupon payments of inflation-linked bonds to account for changes in the price level.
    



## OpenAPI

````yaml post /api/v1/inflation_factors
openapi: 3.0.0
info:
  title: Terrapin API
  version: 1.0.0
servers:
  - url: https://terrapinfinance.com
    variables: {}
security:
  - authorization: []
tags: []
paths:
  /api/v1/inflation_factors:
    post:
      tags: []
      summary: Inflation factors
      description: |-
        Retrieve inflation factors for a given country and date range.
            Inflation factors are used to adjust principal and coupon payments of inflation-linked bonds to account for changes in the price level.
            
      operationId: inflation_factors
      parameters: []
      requestBody:
        content:
          application/json:
            example:
              country: DE
              end_date: '2025-06-01'
              start_date: '2025-06-01'
            schema:
              additionalProperties: false
              properties:
                country:
                  description: >
                    ISO 3166-1 alpha-2 country code (2-letter code) of the
                    country of issue for government bonds.
                  enum:
                    - DE
                    - ES
                    - FR
                    - IT
                    - UK
                    - US
                  nullable: false
                  type: string
                  x-struct: null
                  x-validate: null
                end_date:
                  description: >-
                    The maximum date (inclusive) for which to return inflation
                    factors, in ISO-8601 format (YYYY-MM-DD). When not set,
                    defaults to the latest available inflation factor date.
                  format: date
                  type: string
                  x-check: end_date_gte_start_date
                  x-check-error: end_date must be greater than or equal to start_date
                  x-struct: null
                  x-validate: null
                start_date:
                  description: >-
                    The minimum date (inclusive) for which to return inflation
                    factors, in ISO-8601 format (YYYY-MM-DD). When not set,
                    defaults to the earliest available inflation factor date.
                  format: date
                  type: string
                  x-struct: null
                  x-validate: null
              required:
                - country
              type: object
              x-struct: null
              x-validate: null
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                data:
                  - date: '2025-06-01'
                    factor: 127.43
                    type: Eurostat
                total: 1
              schema:
                additionalProperties: false
                properties:
                  data:
                    description: List of response data objects, often capped to 1000.
                    items:
                      additionalProperties: false
                      properties:
                        date:
                          description: >-
                            Date for inflation factor in ISO-8601 format
                            (YYYY-MM-DD):
                          example: '2025-06-01'
                          format: date
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                        factor:
                          description: >-
                            Inflation factor value representing the cumulative
                            price level adjustment.
                          example: 127.43
                          nullable: false
                          type: number
                          x-struct: null
                          x-validate: null
                        type:
                          description: >-
                            The benchmark source for the inflation factor (e.g.,
                            Eurostat, ONS, BLS).
                          example: Eurostat
                          nullable: false
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - date
                        - factor
                        - type
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                  total:
                    description: >-
                      Total number of results in the database that match the
                      query filters.
                    type: integer
                    x-struct: null
                    x-validate: null
                required:
                  - data
                  - total
                title: InflationFactorsResponse
                type: object
                x-struct: null
                x-validate: null
          description: Inflation factors
        '401':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Unauthorized
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          example: >-
                            Your account tier does not allow this operation.
                            Contact team@terrapinfinance.com for an upgrade.
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Unauthorized
        '402':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Payment Required
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          example: >-
                            You have run out of your granted quota for this
                            resource as defined by your account tier. Contact
                            team@terrapinfinance.com for an upgrade.
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Payment Required
        '403':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Forbidden
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          example: >-
                            Your account tier does not allow this operation.
                            Contact team@terrapinfinance.com for an upgrade.
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Forbidden
        '422':
          content:
            application/json:
              schema:
                properties:
                  errors:
                    items:
                      properties:
                        detail:
                          example: 'Invalid string. Got: integer'
                          type: string
                          x-struct: null
                          x-validate: null
                        source:
                          properties:
                            pointer:
                              example: /isins/0
                              type: string
                              x-struct: null
                              x-validate: null
                          required:
                            - pointer
                          type: object
                          x-struct: null
                          x-validate: null
                        title:
                          example: Invalid value
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                        - source
                        - title
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Too Many Requests
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                additionalProperties: false
                properties:
                  errors:
                    items:
                      additionalProperties: false
                      properties:
                        detail:
                          example: Internal Server Error
                          type: string
                          x-struct: null
                          x-validate: null
                        reason:
                          type: string
                          x-struct: null
                          x-validate: null
                      required:
                        - detail
                      type: object
                      x-struct: null
                      x-validate: null
                    type: array
                    x-struct: null
                    x-validate: null
                required:
                  - errors
                type: object
                x-struct: null
                x-validate: null
          description: Internal Server Error
      callbacks: {}
components:
  securitySchemes:
    authorization:
      scheme: bearer
      type: http

````