Skip to main content
GET
Query Transactions

Overview

GET /payment/transactions returns a paginated list of your company’s payment transactions (collections and payouts), with optional filtering by status, type, external ID, or date range.

When to use it

  • Reconcile your books against Cartevo’s records.
  • Find a transaction by external_id when you’ve lost the Cartevo transaction_id.
  • Build a dashboard view of recent payment activity.

Prerequisites

  • Authenticated as a company user.

Request

Headers

Query parameters

Response

200 — Success

The per-transaction shape matches GET /payment/transactions/{id}/status.

Error responses

Code examples

cURL

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

status
enum<string>

Filter by status (PENDING, SUCCESS, FAILED)

Available options:
PENDING,
SUCCESS,
FAILED,
PROCESSING
type
enum<string>

Filter by type (COLLECTION, PAYOUT)

Available options:
COLLECTION,
PAYOUT
external_id
string

Filter by external ID (partial match)

from_date
string<date-time>

Start date (ISO 8601)

to_date
string<date-time>

End date (ISO 8601)

page
integer

Page number

Example:

1

limit
integer

Items per page

Example:

20

Response

200 - application/json

Transactions retrieved successfully

success
boolean
Example:

true

message
string
Example:

"Transactions retrieved successfully"

data
object[]
pagination
object