GET///
List all transactions related to the specified transaction.
By default, this endpoint returns transactions conducted within the last 30 days. To return transactions older than 30 days, you must include the start_date and end_date query parameters in your request.
By default, this endpoint returns transactions of any state. To return transactions in specific states, you must include the state query parameter in your request.
This endpoint supports field filtering and pagination.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | The unique identifier of the transaction. Allowable Values: Existing transaction token |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | The number of transactions to retrieve. Allowable Values: 1-100 |
| start_index integer Optional | The sort order index of the first resource in the returned array. Allowable Values: Any integer |
| fields string Optional | Comma-delimited list of fields to return (field_1,field_2, and so on). Leave blank to return all fields.Allowable Values: Comma-delimited list of fields, or blank |
| sort_by string Optional | Field on which to sort. Use any field in the resource model, or one of the system fields lastModifiedTime or createdTime. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.Allowable Values: -created_time, created_time, -user_transaction_time, user_transaction_time |
| start_date string Optional | The starting date (or date-time) of a date range from which to return transactions. To return transactions for a single day, enter the same date in both the start_date and end_date fields.Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ss.SS |
| end_date string Optional | The ending date (or date-time) of a date range from which to return transactions. To return transactions for a single day, enter the same date in both the end_date and start_date fields.Allowable Values: Format: yyyy-MM-dd or yyyy-MM-ddThh:mm:ss.SS |
| type string Optional | Comma-delimited list of transaction types to include. Allowable Values: - account.credit- account.debit- account.funding.authorization- account.funding.authorization.reversal- account.funding.authorization.clearing- accountfunding.pull- accountfunding.pull.chargeback- accountfunding.pull.chargeback.rev- authorization- authorization.advice- authorization.atm.withdrawal- authorization.cashback- authorization.clearing- authorization.clearing.atm.withdrawal- authorization.clearing.cashback- authorization.clearing.chargeback- authorization.clearing.chargeback.completed- authorization.clearing.chargeback.provisional.credit- authorization.clearing.chargeback.provisional.debit- authorization.clearing.chargeback.reversal- authorization.clearing.chargeback.writeoff- authorization.clearing.quasi.cash- authorization.incremental- authorization.pin.change- authorization.pin.unblock- authorization.quasi.cash- authorization.reversal- authorization.reversal.issuerexpiration- authorization.standin- bacs.credit.open- bacs.credit.clear- bacs.credit.open.reverse- bacs.credit.clear.reverse- chaps.credit.open- chaps.credit.clear- chaps.credit.open.reverse- chaps.credit.clear.reverse- balanceinquiry- directdeposit.credit- directdeposit.credit.pending- directdeposit.credit.pending.reversal- directdeposit.credit.reject- directdeposit.credit.reversal- directdeposit.debit- directdeposit.debit.pending- directdeposit.debit.pending.reversal- directdeposit.debit.reject- directdeposit.debit.reversal- dispute.credit- dispute.debit- fee.charge- fee.charge.pending- fee.charge.pending.refund- fee.charge.reversal- funds.expire- gpa.credit- gpa.credit.authorization- gpa.credit.authorization.billpayment- gpa.credit.authorization.billpayment.reversal- gpa.credit.authorization.reversal- gpa.credit.billpayment- gpa.credit.chargeback- gpa.credit.chargeback.reversal- gpa.credit.issueroperator- gpa.credit.pending- gpa.credit.pending.reversal- gpa.credit.reversal- gpa.credit.networkload- gpa.credit.networkload.reversal- gpa.debit- gpa.debit.issueroperator- gpa.debit.networkload- gpa.debit.pending- gpa.debit.pending.reversal- gpa.debit.reversal- gpa.grant- original.credit.authorization- original.credit.authorization.clearing- original.credit.authorization.reversal- original.credit.auth_plus_capture- original.credit.auth_plus_capture.reversal- pin.change.reversal- pin.change.reversal.advice- pindebit- pindebit.atm.withdrawal- pindebit.authorization- pindebit.authorization.clearing- pindebit.authorization.reversal- pindebit.authorization.reversal.issuerexpiration- pindebit.balanceinquiry- pindebit.cashback- pindebit.chargeback- pindebit.chargeback.completed- pindebit.chargeback.provisional.credit- pindebit.chargeback.provisional.debit- pindebit.chargeback.reversal- pindebit.chargeback.writeoff- pindebit.credit.adjustment- pindebit.pin.change- pindebit.pin.unblock- pindebit.quasicash- pindebit.refund- pindebit.refund.reversal- pindebit.reversal- pindebit.transfer- product.inquiry- programreserve.credit- programreserve.debit- pullfromcard.pull- pullfromcard.pull.chargeback- pullfromcard.pull.chargeback.rev- pullfromcard.pull.reversal- pushtocard.debit- pushtocard.reversal- refund- refund.authorization- refund.authorization.advice- refund.authorization.clearing- refund.authorization.reversal- reward.earn- token.activation-request- token.advice- transfer.fee- transfer.peer- transfer.program- transit.offer- unknown |
| state string Optional | Comma-delimited list of transaction states to display. Allowable Values: PENDING, CLEARED, COMPLETION, DECLINED, ERROR, ALL |
| version string Optional | Specifies the API version for the request. Allowable Values: v1, v2, v3 |
Response body
| Fields | Description |
|---|---|
| count integer Conditionally returned | The number of resources to retrieve. This field is returned if there are resources in your returned array. Allowable Values: 1-10 |
| data array of objects Conditionally returned | An array of transaction objects. See the Transaction object description at the top of this page. Objects are returned as appropriate to your query. Allowable Values: Valid array of one or more transaction objects |
| end_index integer Conditionally returned | The sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
| is_more boolean Conditionally returned | A value of true indicates that more unreturned resources exist. A value of false indicates that no more unreturned resources exist.This field is returned if there are resources in your returned array. Allowable Values: true, false |
| start_index integer Conditionally returned | The sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. Allowable Values: Any integer |
Sample response body
JSON
{
"count": 1,
"start_index": 0,
"end_index": 0,
"is_more": false,
"data": [
{
"type": "gpa.credit.authorization",
"state": "PENDING",
"token": "cd22cff7-2845-4508-a916-cf89fd9edae1",
"user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"acting_user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"card_token": "02cc766c-24a5-4c3b-adcf-0e5e27b09329",
"preceding_related_transaction_token": "06a8fe88-58b1-4682-a8ad-96eb973e1d74",
"gpa": {
"currency_code": "USD",
"ledger_balance": 20,
"available_balance": 0,
"credit_balance": 0,
"pending_credits": 0,
"impacted_amount": 10,
"balances": {
"USD": {
"currency_code": "USD",
"ledger_balance": 20,
"available_balance": 0,
"credit_balance": 0,
"pending_credits": 0,
"impacted_amount": 10
}
}
},
"gpa_order": {
"token": "592b8164-a4af-45ee-ab24-13a4bb43e6b2",
"amount": 10,
"created_time": "2024-08-21T17:26:30Z",
"last_modified_time": "2024-08-21T17:26:30Z",
"transaction_token": "cd22cff7-2845-4508-a916-cf89fd9edae1",
"state": "PENDING",
"response": {
"code": "0000",
"memo": "Approved or completed successfully"
},
"funding": {
"amount": 10,
"source": {
"type": "programgateway",
"token": "**********dd5f",
"active": true,
"name": "PGFS for simulating transactions",
"is_default_account": false,
"created_time": "2024-08-21T17:25:43Z",
"last_modified_time": "2024-08-21T17:25:43Z"
},
"gateway_log": {
"order_number": "1200",
"transaction_id": "your-jit-funding-token",
"message": "Approved or completed successfully",
"duration": 481,
"timed_out": false,
"response": {
"code": "200",
"data": {
"jit_funding": {
"token": "your-jit-funding-token",
"method": "pgfs.authorization",
"user_token": "your-jit-funding-user",
"amount": 10,
"original_jit_funding_token": "your-jit-funding-token",
"address_verification": {
"gateway": {
"on_file": {
"street_address": "2000 High St",
"postal_code": 94601
},
"response": {
"code": "0000",
"memo": "Address and postal code match"
}
}
}
}
}
}
},
"funding_source_token": "**********dd5f",
"jit_funding": {
"token": "251bdc52-588a-4291-8c5d-6ded3a67e1a8",
"method": "pgfs.authorization",
"user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"acting_user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"amount": 10
},
"user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"currency_code": "USD"
}
},
"duration": 537,
"created_time": "2024-08-21T17:26:29Z",
"issuer_received_time": "2024-08-21T17:26:29Z",
"user_transaction_time": "2024-08-21T17:26:29Z",
"issuer_payment_node": "b9a60cd41a2cc1c23090ed3666bdbf1z",
"amount": 10,
"currency_code": "USD",
"response": {
"code": "0000",
"memo": "Approved or completed successfully"
},
"network": "MARQETA",
"subnetwork": "GATEWAY_JIT",
"acquirer": {
"institution_country": "840",
"institution_id_code": "428399181",
"retrieval_reference_number": "528294182583",
"system_trace_audit_number": "656761"
},
"user": {
"metadata": null
},
"card": {
"metadata": null
},
"card_security_code_verification": {
"type": "CVV1",
"response": {
"code": "0000",
"memo": "Card security code match"
}
},
"fraud": {
"network": {
"transaction_risk_score": 97,
"account_risk_score": "7"
}
},
"pos": {
"pan_entry_mode": "MAG_STRIPE",
"pin_entry_mode": "TRUE",
"terminal_attendance": "ATTENDED",
"card_holder_presence": false,
"card_presence": false,
"partial_approval_capable": false,
"purchase_amount_only": false,
"is_recurring": false
},
"transaction_metadata": {
"payment_channel": "OTHER"
}
}
]
}