Customer invoices for payment

Lists open invoices for a customer when recording a payment.

GEThttps://api.tracksales.co/api/v1/payments/customer/{customerUuid}/invoices

Required scope: payments:read

Path Params

customerUuidstringrequired

Customer UUID

Query Params

payment_idinteger

Existing payment ID when editing a payment (includes invoices already linked to that payment)

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Customer was not found.

422Validation Error

Request validation failed.

curl -X GET 'https://api.tracksales.co/api/v1/payments/customer/{customerUuid}/invoices' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json'

{
    "success": true,
    "data": {
        "invoices": [
            {
                "invoice_id": 301,
                "balance": 6600
            }
        ]
    }
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Customer not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}