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

# List payment link invoices



## OpenAPI

````yaml /openapi.yaml get /v1/payment-links/{id}/invoices
openapi: 3.1.0
info:
  title: Meum Public Merchant API
  version: 1.0.0
  description: >
    Public merchant API for programmatic payment management: invoices,
    transactions,

    payment links, webhooks, and WooCommerce integration.


    Authenticate with a store-scoped API key (`sk_live_*`) via Bearer token.

    Base URL: https://api.meum.io
  contact:
    name: Meum Support
    email: support@meum.io
    url: https://meum.io
servers:
  - url: https://api.meum.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Health
    description: Service health checks
  - name: Invoices
    description: Invoice lifecycle
  - name: Transactions
    description: On-chain payment transactions
  - name: Payment Links
    description: Reusable payment link management
  - name: Webhooks
    description: Webhook endpoint and delivery management
  - name: Integrations
    description: Third-party platform integrations
paths:
  /v1/payment-links/{id}/invoices:
    get:
      tags:
        - Payment Links
      summary: List payment link invoices
      operationId: listPaymentLinkInvoices
      parameters:
        - $ref: '#/components/parameters/PaymentLinkId'
        - $ref: '#/components/parameters/CursorLimit'
        - $ref: '#/components/parameters/CursorStartingAfter'
      responses:
        '200':
          description: Paginated invoices created from this payment link
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/CursorPage'
                  - type: object
                    properties:
                      data:
                        type: array
                        items:
                          $ref: '#/components/schemas/PaymentLinkInvoiceSummary'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    PaymentLinkId:
      name: id
      in: path
      required: true
      description: Pay Link ID from create or list responses (starts with `plink_`).
      schema:
        type: string
        pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$
    CursorLimit:
      name: limit
      in: query
      description: How many items to return per page (1–100). Defaults to `20` if omitted.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
    CursorStartingAfter:
      name: starting_after
      in: query
      description: >
        Pagination cursor. Pass the ID of the last item from the previous page
        to get the next page.

        Omit on the first request.
      schema:
        type: string
        pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$
  schemas:
    CursorPage:
      type: object
      required:
        - data
        - has_more
        - next_cursor
      properties:
        data:
          type: array
          description: Page of resources for the current request.
          items: {}
        has_more:
          type: boolean
          description: Whether additional pages exist after this one.
          example: true
        next_cursor:
          type:
            - string
            - 'null'
          format: uuid
          description: >-
            Pass as `starting_after` on the next request to fetch the following
            page. Null when `has_more` is false.
          example: 550e8400-e29b-41d4-a716-446655440000
    PaymentLinkInvoiceSummary:
      type: object
      description: Invoice row returned from Pay Link invoice listing.
      properties:
        id:
          type: string
          pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$
          description: Invoice public ID (`inv_...`).
        status:
          $ref: '#/components/schemas/InvoiceStatus'
        amount:
          type: string
          description: Invoice amount in the link currency.
          example: '25.00'
        currency:
          type: string
          description: Currency code (e.g. `USD`).
          example: USD
        created_at:
          type: string
          format: date-time
          description: When the invoice was created from this link.
        paid_at:
          type:
            - string
            - 'null'
          format: date-time
          description: When payment was confirmed. Null if unpaid.
        payment_link:
          type:
            - object
            - 'null'
          description: Nested Pay Link summary when included in the response.
          properties:
            id:
              type: string
              pattern: ^(inv_|txn_|plink_|wh_|whd_|evt_|int_)[0-9a-z]{20,32}$
              description: Pay Link merchant ID (`plink_...`).
            title:
              type: string
              description: Link title.
            public_id:
              type: string
              description: Public checkout token (`plpub_...`).
    InvoiceStatus:
      type: string
      description: |
        Where the invoice is in the payment flow:
        - `pending`: created, not yet ready for payment
        - `quoted`: price quote ready; customer can proceed to pay
        - `awaiting_payment`: waiting for the customer to send funds
        - `paid`: payment received and confirmed
        - `underpaid`: customer paid less than the requested amount
        - `expired`: not paid before the deadline
        - `failed`: payment or processing failed
        - `refunded`: payment was returned to the customer
        - `cancelled`: invoice was cancelled before completion
      enum:
        - pending
        - quoted
        - awaiting_payment
        - paid
        - underpaid
        - expired
        - failed
        - refunded
        - cancelled
    PublicApiError:
      type: object
      description: Standard error envelope for Public API v1 endpoints.
      required:
        - error
      properties:
        error:
          type: object
          description: Error details for the failed request.
          required:
            - type
            - code
            - message
            - request_id
          properties:
            type:
              type: string
              description: High-level error category used for programmatic handling.
              enum:
                - invalid_request
                - authentication_error
                - permission_error
                - not_found
                - conflict
                - rate_limit_error
                - api_error
              example: not_found
            code:
              type: string
              description: >-
                Stable machine-readable error code (for example
                `invoice_not_found`).
              example: invoice_not_found
            message:
              type: string
              description: Human-readable explanation suitable to show in logs or UI.
              example: Invoice not found
            param:
              type: string
              description: Request field associated with the error, when applicable.
              example: url
            request_id:
              type: string
              description: Unique request ID. Include when contacting support.
              example: req_a1b2c3d4e5f6789012345678
      example:
        error:
          type: not_found
          code: invoice_not_found
          message: Invoice not found
          request_id: req_a1b2c3d4e5f6789012345678
  responses:
    NotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PublicApiError'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: |
        Store-scoped API key. Prefix with `sk_live_`.
        Example: `Authorization: Bearer sk_live_EXAMPLE_DO_NOT_USE`

````