Skip to main content

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).

Required scope: accounting:read

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Permission: Integrations → List (integrations.index).

Each row carries event_label, a friendly name for its PayPal event code (event_code), e.g. "Refund" for T1107 or "Fee reversal" for T1108. match_status can also be reviewed (an unmatched transaction staff marked reviewed; see Mark PayPal Transaction Reviewed), with reviewed_at.

Request​

Responses​

OK

Response Headers
    Content-Type