> ## 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 accounting exceptions

> List the accounting exceptions of a ledger raised by contract assessments, open ones by default, newest first.



## OpenAPI

````yaml get /v1/accounting/exceptions
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/exceptions:
    get:
      tags:
        - Accounting > Revenue policies
      summary: List accounting exceptions
      description: >-
        List the accounting exceptions of a ledger raised by contract
        assessments, open ones by default, newest first.
      operationId: listAccountingExceptions
      parameters:
        - 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
        - schema:
            type: string
            minLength: 1
            description: Identifier of the ledger the record belongs to.
          required: true
          description: Identifier of the ledger the record belongs to.
          name: ledger_id
          in: query
        - schema:
            type: string
          required: false
          name: id
          in: query
        - schema:
            type: string
          required: false
          name: id__not
          in: query
        - schema:
            type: string
          required: false
          name: id__equals
          in: query
        - schema:
            type: string
          required: false
          name: id__contains
          in: query
        - schema:
            type: string
          required: false
          name: id__startsWith
          in: query
        - schema:
            type: string
          required: false
          name: id__endWith
          in: query
        - schema:
            type: string
            enum:
              - open
              - resolved
              - dismissed
            description: Exception status; defaults to `open`.
          required: false
          description: Exception status; defaults to `open`.
          name: status
          in: query
        - schema:
            anyOf:
              - type: string
                enum:
                  - open
                  - resolved
                  - dismissed
              - type: string
                description: open,resolved
          required: false
          name: status__in
          in: query
        - schema:
            type: string
            enum:
              - missing_standalone_selling_price
              - standalone_selling_price_not_normalizable
              - unmapped_product
              - zero_allocation_basis
              - discount_exceeds_allocation
              - obligation_not_schedulable
              - recognition_rule_incompatible
              - periods_owned_by_invoice_schedules
              - review_required
              - override_review_required
              - override_out_of_date
              - modification_review_required
              - allocation_below_recognized
              - transition_review_required
              - billing_variance
              - consumption_breakage_review
              - milestone_not_delivered
            description: What the exception is about.
          required: false
          description: What the exception is about.
          name: code
          in: query
        - schema:
            anyOf:
              - type: string
                enum:
                  - missing_standalone_selling_price
                  - standalone_selling_price_not_normalizable
                  - unmapped_product
                  - zero_allocation_basis
                  - discount_exceeds_allocation
                  - obligation_not_schedulable
                  - recognition_rule_incompatible
                  - periods_owned_by_invoice_schedules
                  - review_required
                  - override_review_required
                  - override_out_of_date
                  - modification_review_required
                  - allocation_below_recognized
                  - transition_review_required
                  - billing_variance
                  - consumption_breakage_review
                  - milestone_not_delivered
              - type: string
                description: >-
                  missing_standalone_selling_price,standalone_selling_price_not_normalizable
          required: false
          name: code__in
          in: query
        - schema:
            type: string
            enum:
              - blocking
              - informational
            description: >-
              `blocking` holds the contract's recognition until resolved,
              `informational` does not.
          required: false
          description: >-
            `blocking` holds the contract's recognition until resolved,
            `informational` does not.
          name: severity
          in: query
        - schema:
            anyOf:
              - type: string
                enum:
                  - blocking
                  - informational
              - type: string
                description: blocking,informational
          required: false
          name: severity__in
          in: query
        - schema:
            type: string
            description: 'Comma-separated identifiers: only the records with one of them.'
          required: false
          description: 'Comma-separated identifiers: only the records with one of them.'
          name: id__in
          in: query
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AccountingExceptionPaginated'
      security:
        - bearer: []
components:
  schemas:
    AccountingExceptionPaginated:
      type: object
      properties:
        meta:
          $ref: '#/components/schemas/AccountingPaginationMeta'
        data:
          type: array
          items:
            $ref: '#/components/schemas/AccountingException'
      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.
    AccountingException:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier of the accounting exception.
          example: acx_9xQ1z4Ha7Gk2Lm
        assessment_id:
          type: string
          description: Contract assessment the exception belongs to.
          example: caa_2Lm9xQ1z4Ha7Gk
        assessment_version:
          type: integer
          description: Assessment version that raised the exception.
        subscription_id:
          type: string
          description: Identifier of the subscription holding the contract.
          example: sub_Gk2Lm9xQ1z4Ha7
        customer_id:
          type: string
          description: Identifier of the customer.
          example: cus_Lm9xQ1z4Ha7Gk2
        code:
          type: string
          enum:
            - missing_standalone_selling_price
            - standalone_selling_price_not_normalizable
            - unmapped_product
            - zero_allocation_basis
            - discount_exceeds_allocation
            - obligation_not_schedulable
            - recognition_rule_incompatible
            - periods_owned_by_invoice_schedules
            - review_required
            - override_review_required
            - override_out_of_date
            - modification_review_required
            - allocation_below_recognized
            - transition_review_required
            - billing_variance
            - consumption_breakage_review
            - milestone_not_delivered
          description: What the exception is about.
        severity:
          type: string
          enum:
            - blocking
            - informational
          description: >-
            `blocking` holds the contract's recognition until resolved,
            `informational` does not.
        status:
          type: string
          enum:
            - open
            - resolved
            - dismissed
          description: >-
            `open` until a new input, an override, an approval or a dismissal
            resolves it.
        obligation_key:
          type:
            - string
            - 'null'
          description: Obligation the exception is about, or null for the whole contract.
        product_ids:
          type: array
          items:
            type: string
          description: Products the exception is about.
        evidence:
          type: object
          additionalProperties: {}
          description: >-
            Data the exception was raised from. Informational: its keys depend
            on the code and may grow.
        proposed_resolution:
          type:
            - object
            - 'null'
          additionalProperties: {}
          description: >-
            Suggested way to resolve the exception, or null. Informational: its
            keys depend on the code.
        compatibility_key:
          type: string
          description: >-
            Exceptions sharing this key can be decided together in one bulk
            decision.
        decision_id:
          type:
            - string
            - 'null'
          description: Review decision that resolved it, or null.
        resolved_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When the exception was resolved, or null while open.
          example: '2024-12-20T16:04:11Z'
        created_at:
          type: string
          format: date-time
          description: When the record was created.
          example: '2024-12-20T16:04:11Z'
      required:
        - id
        - assessment_id
        - assessment_version
        - subscription_id
        - customer_id
        - code
        - severity
        - status
        - obligation_key
        - product_ids
        - evidence
        - proposed_resolution
        - compatibility_key
        - decision_id
        - resolved_at
        - created_at
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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