List PayPal Transactions
GET/api/paypal/integrations/:id/transactions
Lists PayPal account activity imported for one PayPal integration: payments, refunds, chargebacks, bank transfers, holds and fees, each classified against the payments SKU.io has recorded.
Authentication: Requires Bearer token.
match_status values: matched (linked to a payment SKU.io recorded, or a refund of one), recovered (a pay-link payment whose notification was missed; the import recorded the payment), unmatched (a completed payment no SKU.io pay link references), pending (e.g. an eCheck still clearing), denied, disputed (chargeback), not_applicable (transfers, holds, currency conversions).
type values: payment, refund, chargeback, transfer, fee, hold, currency_conversion, other (derived from PayPal's T-code in event_code).
Amounts: signed as PayPal reports them; fee_amount is negative for fees charged, net_amount = gross + fee.
Advanced filters: pass a base64-encoded filter_groups tree with {column}.{operator} conditions on transaction_id, event_code, payer_email, payer_name (text operators), gross_amount, fee_amount, net_amount (numeric operators) and transaction_date (datetime operators).
Sorts: transaction_date, gross_amount, fee_amount, net_amount, id (prefix with - for descending; default -transaction_date).
Pagination: page, per_page (default 15).
This endpoint currently requires session authentication; Personal Access Token scope support is in progress.
Request
Responses
- 200
- 401
- 403
- 404
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not Found
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.