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

# List ledger close events

> List the closes and reopens of a ledger, newest first, with who did them and why.



## OpenAPI

````yaml get /v1/accounting/ledgers/{id}/close-events
openapi: 3.1.0
info:
  title: Hyperline API
  version: 0.0.0
servers:
  - url: https://api.hyperline.co
  - url: https://sandbox.api.hyperline.co
security: []
paths:
  /v1/accounting/ledgers/{id}/close-events:
    get:
      tags:
        - Accounting > Ledgers
      summary: List ledger close events
      description: >-
        List the closes and reopens of a ledger, newest first, with who did them
        and why.
      operationId: listLedgerCloseEvents
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
        - schema:
            type:
              - number
              - 'null'
            minimum: 0
            maximum: 100
            default: 50
          required: false
          name: take
          in: query
        - schema:
            type:
              - number
              - 'null'
            minimum: 0
            default: 0
          required: false
          name: skip
          in: query
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountingLedgerCloseEventPaginated'
        '404':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
      security:
        - bearer: []
components:
  schemas:
    AccountingLedgerCloseEventPaginated:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/AccountingPaginationMeta'
        data:
          type: array
          items:
            $ref: '#/components/schemas/AccountingLedgerCloseEvent'
          description: Close events of the ledger, newest first.
      required:
        - meta
        - data
    AccountingPaginationMeta:
      type: object
      properties:
        total:
          type: number
          description: Total number of matching resources.
        taken:
          type: number
          description: Number of resources returned.
        skipped:
          type: number
          description: Number of resources skipped.
      required:
        - total
        - taken
        - skipped
      description: Pagination metadata.
    AccountingLedgerCloseEvent:
      type: object
      properties:
        id:
          type: string
          description: Unique close event identifier.
        ledger_id:
          type: string
          description: Ledger identifier.
        action:
          type: string
          enum:
            - close
            - reopen
          description: Whether months were closed or reopened.
        from_date:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Closed-through date before the event, formatted YYYY-MM-DD. Null
            when no month was closed.
          example: '2026-08-31'
        to_date:
          type:
            - string
            - 'null'
          format: date
          description: Closed-through date after the event, formatted YYYY-MM-DD.
          example: '2026-09-30'
        reason:
          type:
            - string
            - 'null'
          description: Why the months were closed or reopened.
        actor:
          $ref: '#/components/schemas/AccountingLedgerCloseActor'
        created_at:
          type:
            - string
            - 'null'
          format: date
          description: Timestamp of the close or reopen.
      required:
        - id
        - ledger_id
        - action
        - from_date
        - to_date
        - reason
        - actor
        - created_at
    AccountingLedgerCloseActor:
      oneOf:
        - $ref: '#/components/schemas/AccountingLedgerCloseUserActor'
        - $ref: '#/components/schemas/AccountingLedgerCloseApiActor'
        - $ref: '#/components/schemas/AccountingLedgerCloseMcpOrCliActor'
      discriminator:
        propertyName: type
        mapping:
          user: '#/components/schemas/AccountingLedgerCloseUserActor'
          api: '#/components/schemas/AccountingLedgerCloseApiActor'
          mcp: '#/components/schemas/AccountingLedgerCloseMcpOrCliActor'
          cli: '#/components/schemas/AccountingLedgerCloseMcpOrCliActor'
      description: Who closed or reopened the months.
    AccountingLedgerCloseUserActor:
      type: object
      properties:
        type:
          type: string
          enum:
            - user
          description: A user of the Hyperline app.
        user_id:
          type:
            - string
            - 'null'
          description: Identifier of the user who acted.
      required:
        - type
        - user_id
      additionalProperties: false
      title: User
    AccountingLedgerCloseApiActor:
      type: object
      properties:
        type:
          type: string
          enum:
            - api
          description: A public API call.
        api_credential_id:
          type:
            - string
            - 'null'
          description: Identifier of the API key used.
        app_id:
          type:
            - string
            - 'null'
          description: Identifier of the third-party app that called the API.
        user_id:
          type:
            - string
            - 'null'
          description: Identifier of the user who acted.
      required:
        - type
        - api_credential_id
        - app_id
        - user_id
      additionalProperties: false
      title: API
    AccountingLedgerCloseMcpOrCliActor:
      type: object
      properties:
        type:
          type: string
          enum:
            - mcp
            - cli
          description: A call from the Hyperline MCP server or CLI.
        user_id:
          type:
            - string
            - 'null'
          description: Identifier of the user who acted.
        api_credential_id:
          type:
            - string
            - 'null'
          description: Identifier of the API key used.
      required:
        - type
        - user_id
        - api_credential_id
      additionalProperties: false
      title: MCP or CLI
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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