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

# List invoice payable payments

> Returns all clearings (bank payments and credit notes) linked to the invoice payable. Each entry carries a `type` discriminator (`BP` for bank payments, `CN` for credit notes) so consumers can filter client-side if only one kind is needed. Reversed clearings are excluded.



## OpenAPI

````yaml /openapi-public.json get /v1/invoice-payables/{invoicePayableId}/payments
openapi: 3.0.1
info:
  title: Light API
  version: 1.0.0
servers: []
security:
  - apiKeyAuth: []
  - bearerAuth: []
paths:
  /v1/invoice-payables/{invoicePayableId}/payments:
    get:
      tags:
        - v1 - Invoice Payables
      summary: List invoice payable payments
      description: >-
        Returns all clearings (bank payments and credit notes) linked to the
        invoice payable. Each entry carries a `type` discriminator (`BP` for
        bank payments, `CN` for credit notes) so consumers can filter
        client-side if only one kind is needed. Reversed clearings are excluded.
      operationId: listInvoicePayablePayments
      parameters:
        - name: invoicePayableId
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        default:
          description: default response
          content:
            application/json;charset=UTF-8:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ExternalInvoicePayablePaymentV1Model'
components:
  schemas:
    ExternalInvoicePayablePaymentV1Model:
      type: object
      properties:
        id:
          type: string
          description: Unique identifier for the payment
          format: uuid
        invoicePayableId:
          type: string
          description: ID of the invoice payable this payment cleared
          format: uuid
        amount:
          type: integer
          description: >-
            Payment amount in the smallest currency denomination (e.g. cents),
            in the invoice payable's currency
          format: int64
        currency:
          type: string
          example: USD
        paymentDate:
          type: string
          description: Date the payment was made
          format: date
        payment:
          $ref: '#/components/schemas/ExternalInvoicePayablePaymentEntryV1Model'
        createdAt:
          type: string
          description: Timestamp when the payment was created
          format: date-time
    ExternalInvoicePayablePaymentEntryV1Model:
      type: object
      properties:
        type:
          type: string
          description: >-
            - `BP` - Bank payment

            - `CN` - Credit note


            ⚠️ This enum is not exhaustive; new values may be added in the
            future.
          enum:
            - BP
            - CN
      description: Type of payment entry for an invoice payable payment
      nullable: true
      discriminator:
        propertyName: type
      oneOf:
        - $ref: >-
            #/components/schemas/ExternalInvoicePayablePaymentBankPaymentEntryV1Model
        - $ref: >-
            #/components/schemas/ExternalInvoicePayablePaymentCreditNoteEntryV1Model
    ExternalInvoicePayablePaymentBankPaymentEntryV1Model:
      title: Bank payment
      type: object
      allOf:
        - $ref: '#/components/schemas/ExternalInvoicePayablePaymentEntryV1Model'
        - type: object
          properties:
            bankAccountId:
              type: string
              description: ID of the bank account
              format: uuid
              nullable: true
            endToEndId:
              type: string
              description: End-to-end ID for the payment
              nullable: true
            originalAmount:
              type: integer
              description: Original payment amount in smallest denomination
              format: int64
            originalCurrency:
              type: string
              example: USD
            accountingDocumentId:
              type: string
              description: ID of the accounting document
              format: uuid
    ExternalInvoicePayablePaymentCreditNoteEntryV1Model:
      title: Credit note
      type: object
      allOf:
        - $ref: '#/components/schemas/ExternalInvoicePayablePaymentEntryV1Model'
        - type: object
          properties:
            accountingDocumentId:
              type: string
              description: ID of the accounting document
              format: uuid
            amount:
              type: integer
              description: Credit note amount in smallest denomination
              format: int64
              nullable: true
            documentNumber:
              type: string
              description: Document number
              nullable: true
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      description: >-
        Basic authentication header of the form **Basic** **<api_key>**, where
        **<api_key>** is your api key.
      name: Authorization
      in: header
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````