API Reference

Get Payments

Retrieve paginated payments using optional filters. Permission: Read Payments

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
Defaults to page=1

The page number for paginated results. Defaults to 1. Used to traverse the paginated response

string
Defaults to sort=+createdAt

The field to sort results by. Prefix with '-' for descending order (e.g., '-createdAt'). Sortable fields are indicated in each field's description. Used to sort the response in ascending or descending order of an attribute

string
Defaults to createdAt=eq:2022-01-01

Filter expression in the format: filter[field][operator]=value. See individual field descriptions for available operators. Example: filter[status][eq]=Funded. Used to filter the response on an attribute value

integer

The total payment amount in dollars. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn

string

When the payment was created. ISO 8601 datetime format. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

The name of the CSO that processed the payment. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

A description of the payment. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

Additional payment details. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

An external identifier from a third-party system. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

When the payment failed. ISO 8601 datetime format. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

The error code from the payment processor. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

integer

The fee portion of the payment, in dollars. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

integer

The interest portion of the payment, in dollars. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

The UUID of the loan group. Use the GET /api/loan-groups endpoint to find available values. Sortable: Yes. Filter Operators: eq, ne, neq, nn, null

string

The UUID of the loan type. Use the GET /api/loan-types endpoint to find available values. Sortable: Yes. Filter Operators: eq, ne, neq, nn, null

string

The UUID of the loan this payment is applied to. Sortable: Yes. Filter Operators: eq, ne, neq, nn, null

string

How the payment was initiated. Possible values: Adjustment, Admin, Agent, Api, Auto Schedule, Cash, Collector, Customer, EFT Returned, External Loan Payoff, Funding, Import, Line of Credit Advance, Miscellaneous Payment, Paydit, Payment Plan, Prenote, Refund, Retry, Scheduled, Settlement, Subscription, Transfer, Withdraw Funds. Sortable: Yes. Filter Operators: eq, neq, in, nin

string

The type of payment. Possible values: Adjustment, Final, First, Funding, Late, Prenote, Transfer, Scheduled, Unscheduled. Sortable: Yes. Filter Operators: eq, in, nin, ne, neq, nn, null

string

When the payment was posted. ISO 8601 datetime format. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

integer

The principal portion of the payment, in dollars. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

When the payment was submitted to the processor. ISO 8601 datetime format. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

The payment processor that handled the transaction. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

A reference ID for tracking and reconciliation. Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

The return code from the processor (e.g., R01 for insufficient funds). Sortable: Yes. Filter Operators: eq, neq, nn, null, in, nin

string

When the payment was returned. ISO 8601 datetime format. Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

When the payment was settled. ISO 8601 date format (YYYY-MM-DD). Sortable: Yes. Filter Operators: eq, gt, gte, lt, lte, ne, neq, nn, null

string

The current payment status. Possible values: Completed, Failed, Held, Pending, Posted, Processing, Rejected, Returned, Settled, Voided. Sortable: Yes. Filter Operators: eq, in, nin, ne, neq, nn, null

string

The payment's unique identifier (UUID v4 format). Sortable: Yes. Filter Operators: eq, ne, neq, nn, null

Headers
string
required
Defaults to application/vnd.totality.v1+json

Must be application/json.

string
required
Defaults to application/json

Must be application/json.

Responses

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
application/json