GET/
List all transactions.
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, GET /transactions returns transactions having either PENDING or COMPLETION states.
This endpoint supports field filtering and pagination.
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.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- 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.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 |
| user_token string Optional | The unique identifier of the user account holder. Allowable Values: Existing user token |
| business_token string Optional | The unique identifier of the business account holder. Allowable Values: Existing business token |
| acting_user_token string Optional | The unique identifier of the acting user. Allowable Values: Existing user token |
| card_token string Optional | The unique identifier of the card. Allowable Values: Existing card token |
| state string Optional | Comma-delimited list of transaction states to display. Allowable Values: PENDING, CLEARED, COMPLETION, DECLINED, ERROR |
| 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": 2,
"start_index": 0,
"end_index": 1,
"is_more": true,
"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"
}
},
{
"type": "authorization",
"state": "PENDING",
"token": "06a8fe88-58b1-4682-a8ad-96eb973e1d74",
"user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"acting_user_token": "99f323d4-298f-4b0c-93b1-19b2d9921eb8",
"card_token": "02cc766c-24a5-4c3b-adcf-0e5e27b09329",
"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": 622,
"created_time": "2024-08-21T17:26:29Z",
"issuer_received_time": "2024-08-21T17:26:29Z",
"user_transaction_time": "2024-08-21T17:26:29Z",
"settlement_date": "2024-08-21T00:00:00Z",
"issuer_payment_node": "b9a60cd41a2cc1c23090ed3666bdbf1z",
"request_amount": 10,
"amount": 10,
"currency_code": "USD",
"approval_code": "761515",
"response": {
"code": "0000",
"memo": "Approved or completed successfully"
},
"network": "VISA",
"subnetwork": "VISANET",
"acquirer_fee_amount": 0,
"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"
}
},
"card_acceptor": {
"mid": "000000000011111",
"mcc": "6411",
"name": "Aegis Fleet Services",
"street_address": "111 Main St",
"city": "Berkeley",
"country_code": "USA"
},
"pos": {
"pan_entry_mode": "MAG_STRIPE",
"pin_entry_mode": "TRUE",
"terminal_id": "TR100000",
"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"
}
}
]
}