> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List transactions

> List all transactions.

GET/transactions

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](https://www.marqeta.com/docs/core-api/field-filtering.md) and [pagination](https://www.marqeta.com/docs/core-api/sorting-and-pagination.md).

## 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](https://www.marqeta.com/docs/core-api/transactions) 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 JSON expandable lines wrap theme={null}
{
  "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"
      }
    }
  ]
}
```


## Related topics

- [List transactions for a funding account](https://www.marqeta.com/docs/core-api/transactions/list-funding-account.md)
- [Transactions Overview](https://www.marqeta.com/docs/core-api/transactions.md)
- [List related transactions](https://www.marqeta.com/docs/core-api/transactions/list-related-transactions.md)
- [List associated transactions](https://www.marqeta.com/docs/core-api/disputes-visa/associated-transactions/list-associated-transactions.md)
- [List program reserve transactions](https://www.marqeta.com/docs/core-api/program-reserve/list-program-reserve-transactions.md)
