> ## 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 related transactions

> List all transactions related to the specified transaction.

GET/transactions/\{token}/related

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

## 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](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": 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"
      }
    }
  ]
}
```


## Related topics

- [Transactions Overview](https://www.marqeta.com/docs/core-api/transactions.md)
- [List related bundles](https://www.marqeta.com/docs/core-api/credit-bundles/list-related-bundles.md)
- [Managing Customers in the Marqeta Dashboard](https://www.marqeta.com/docs/developer-guides/customers-dashboard.md)
- [List transactions](https://www.marqeta.com/docs/core-api/transactions/list-transactions.md)
- [Transaction Details in the Marqeta Dashboard](https://www.marqeta.com/docs/developer-guides/transaction-details-dashboard.md)
