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

# List a member's allowances

> Every fiscal year of every allowance type the member can use, oldest first. Allowance types that are switched off for this member are left out. This is the read side of the deprecated PUT /members/{id}/allowance/{allowance_type_id}/{year}.



## OpenAPI

````yaml https://api.absentify.com/api/v1/openapi.json get /members/{member_id}/allowances
openapi: 3.1.0
info:
  title: absentify CRUD API
  description: OpenAPI compliant REST API
  version: 1.0.0
servers:
  - url: https://api.absentify.com/api/v1
security: []
tags:
  - name: Departments
  - name: Leave types
  - name: Members
  - name: Requests
  - name: Public holidays
  - name: Workspace
  - name: Absences
  - name: Allowance Management
  - name: Out of office
externalDocs:
  url: https://absentify.com/docs/en/api-reference
paths:
  /members/{member_id}/allowances:
    get:
      tags:
        - Allowance Management
      summary: List a member's allowances
      description: >-
        Every fiscal year of every allowance type the member can use, oldest
        first. Allowance types that are switched off for this member are left
        out. This is the read side of the deprecated PUT
        /members/{id}/allowance/{allowance_type_id}/{year}.
      operationId: memberAllowance-listMemberAllowances
      parameters:
        - in: path
          name: member_id
          schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$
          required: true
        - in: query
          name: year
          schema:
            type: integer
            minimum: -9007199254740991
            maximum: 9007199254740991
        - in: query
          name: locale
          schema:
            type: string
            enum:
              - en
              - de
              - fr
              - hu
              - it
              - pl
              - pt
              - ru
              - es
              - tr
              - uk
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    member_id:
                      type: string
                    allowance_type_id:
                      type: string
                    year:
                      type: integer
                      minimum: -9007199254740991
                      maximum: 9007199254740991
                    start:
                      description: First day of the fiscal year (inclusive).
                      type: string
                    end:
                      description: Last day of the fiscal year (inclusive).
                      type: string
                    allowance:
                      type: number
                      description: >-
                        The entitlement of this year: `rule_allowance` plus
                        `adjustments`. Same meaning as the `allowance` field on
                        GET /members/{id}.
                    rule_allowance:
                      type: number
                      description: >-
                        The part of the entitlement the allowance rule granted.
                        For a year still on the pre-rules data it holds the
                        stored entitlement, and `adjustments` is 0.
                    adjustments:
                      type: number
                      description: >-
                        The part that came from manual adjustments, overtime
                        compensation excluded.
                    brought_forward:
                      type: number
                      description: Carried over from the previous year into this one.
                    overwrite_brought_forward:
                      type: boolean
                      description: >-
                        True when an admin set the carry-over by hand instead of
                        letting it be computed.
                    compensatory_time_off:
                      type: number
                      description: Overtime compensation credited to this year.
                    taken:
                      type: number
                      description: Booked and approved out of this year.
                    remaining:
                      type: number
                      description: What is left to book.
                    carry_over:
                      type: number
                      description: >-
                        Compatibility alias for allowance carried over from the
                        previous year into this one.
                    will_expire:
                      type: number
                      description: Of `remaining`, how much expires later this year.
                    expired:
                      type: number
                      description: How much has already expired this year.
                    carry_forward_deadline:
                      description: The day carried-over balance expires.
                      type: string
                    expiring_adjustments:
                      anyOf:
                        - type: object
                          properties:
                            amount:
                              type: number
                            earliest_expiry:
                              description: >-
                                The LAST day (inclusive) the soonest-expiring of
                                them can still be used, the same value POST
                                /members/{member_id}/adjustments takes.
                              type: string
                          required:
                            - amount
                            - earliest_expiry
                          additionalProperties: false
                        - type: 'null'
                      description: >-
                        Positive adjustments of this year that expire in the
                        future, if any. Always null when the `year` filter is
                        used.
                    allowance_type:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                          description: >-
                            Translated into `locale` when one is given,
                            otherwise into the API key owner's language, falling
                            back to the stored name.
                        default_name:
                          type: string
                        allowance_unit:
                          type: string
                          enum:
                            - days
                            - hours
                      required:
                        - id
                        - name
                        - default_name
                        - allowance_unit
                      additionalProperties: false
                    createdAt:
                      type: string
                    updatedAt:
                      type: string
                  required:
                    - id
                    - member_id
                    - allowance_type_id
                    - year
                    - start
                    - end
                    - allowance
                    - rule_allowance
                    - adjustments
                    - brought_forward
                    - overwrite_brought_forward
                    - compensatory_time_off
                    - taken
                    - remaining
                    - carry_over
                    - will_expire
                    - expired
                    - carry_forward_deadline
                    - expiring_adjustments
                    - allowance_type
                    - createdAt
                    - updatedAt
                  additionalProperties: false
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.BAD_REQUEST'
        '401':
          description: Authorization not provided
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.UNAUTHORIZED'
        '403':
          description: Insufficient access
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.FORBIDDEN'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.NOT_FOUND'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error.INTERNAL_SERVER_ERROR'
      security:
        - ApiKey: []
components:
  schemas:
    error.BAD_REQUEST:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Invalid input data
        code:
          type: string
          description: The error code
          example: BAD_REQUEST
        issues:
          description: An array of issues that were responsible for the error
          example: []
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
            additionalProperties: false
      required:
        - message
        - code
      additionalProperties: false
      title: Invalid input data error (400)
      description: The error information
      example:
        code: BAD_REQUEST
        message: Invalid input data
        issues: []
    error.UNAUTHORIZED:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Authorization not provided
        code:
          type: string
          description: The error code
          example: UNAUTHORIZED
        issues:
          description: An array of issues that were responsible for the error
          example: []
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
            additionalProperties: false
      required:
        - message
        - code
      additionalProperties: false
      title: Authorization not provided error (401)
      description: The error information
      example:
        code: UNAUTHORIZED
        message: Authorization not provided
        issues: []
    error.FORBIDDEN:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Insufficient access
        code:
          type: string
          description: The error code
          example: FORBIDDEN
        issues:
          description: An array of issues that were responsible for the error
          example: []
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
            additionalProperties: false
      required:
        - message
        - code
      additionalProperties: false
      title: Insufficient access error (403)
      description: The error information
      example:
        code: FORBIDDEN
        message: Insufficient access
        issues: []
    error.NOT_FOUND:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Not found
        code:
          type: string
          description: The error code
          example: NOT_FOUND
        issues:
          description: An array of issues that were responsible for the error
          example: []
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
            additionalProperties: false
      required:
        - message
        - code
      additionalProperties: false
      title: Not found error (404)
      description: The error information
      example:
        code: NOT_FOUND
        message: Not found
        issues: []
    error.INTERNAL_SERVER_ERROR:
      type: object
      properties:
        message:
          type: string
          description: The error message
          example: Internal server error
        code:
          type: string
          description: The error code
          example: INTERNAL_SERVER_ERROR
        issues:
          description: An array of issues that were responsible for the error
          example: []
          type: array
          items:
            type: object
            properties:
              message:
                type: string
            required:
              - message
            additionalProperties: false
      required:
        - message
        - code
      additionalProperties: false
      title: Internal server error error (500)
      description: The error information
      example:
        code: INTERNAL_SERVER_ERROR
        message: Internal server error
        issues: []
  securitySchemes:
    ApiKey:
      type: apiKey
      name: X-API-KEY
      in: header

````