# Get invoice payments

List all payments applied to a specific invoice.

Endpoint: GET /invoices/{id}/payments
Version: 1.0.0
Security: BearerAuth

## Path parameters:

  - `id` (string, required)
    Resource ID (UUID) or client key
    Example: "550e8400-e29b-41d4-a716-446655440000"

## Query parameters:

  - `by` (string)
    Specify lookup type for faster retrieval.
If omitted, defaults to looking up by ID first, then falls back to client key if not found.
Use by=key when you know you're providing a client key for best performance.
    Enum: "id", "key"

## Response 200 fields (application/json):

  - `data` (array)

  - `data.id` (string)

  - `data.paymentGroupId` (string)

  - `data.amount` (number)
    Amount applied to this invoice

  - `data.paymentDate` (string)

  - `data.reference` (string,null)
    Check number, transaction ID, etc.

  - `data.paymentMethodType` (string,null)
    Payment method (check, ach_wire, etc.)

  - `totalPaid` (number)

  - `openBalance` (number)

## Response 401 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message

## Response 404 fields (application/json):

  - `error` (string, required)
    Error code

  - `message` (string, required)
    Human-readable error message