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

# Retrieve recurring transactions

> The /v3/cards/{cardtoken}/transactions endpoint allows you to retrieve recurring transactions from the last six months using the isrecurring query parameter.

GET/v3/cards/\{card\_token}/transactions

The `/v3/cards/{card_token}/transactions` endpoint allows you to retrieve recurring transactions from the last six months using the `is_recurring` query parameter.

## Path parameters

| Fields | Description |
| - | - |
| card\_token string  Required | Token of the card for which to retrieve transactions. **Allowable Values:**  Existing card token |

## URL query parameters

| Fields | Description |
| - | - |
| is\_recurring boolean  Required | Set to `true` to filter only recurring transactions. **Allowable Values:**  `true`, `false` **Default:** `false` |
| start\_date string  Optional | Start of the date range filter. If a value for this field is provided, a value for `end_date` must also be specified. If there are no values provided for both `start_date` and `end_date`, then the endpoint retrieves results for the six months prior to the current date. The maximum window allowed between `start_date` and `end_date` is six months. If the date range exceeds six months, the endpoint returns `400 Bad Request`. **Allowable Values:**  Date in `yyyy-MM-dd` or `yyyy-MM-ddThh:mm:ssZ` format |
| end\_date string  Optional | Ending date of the range provided for the filter. If a value for `end_date` is provided, then `start_date` must also be specified. If there are no values provided for both `start_date` and `end_date`, then the endpoint retrieves results for the six months prior to the current date. The maximum window allowed between `start_date` and `end_date` is six months. If the date range exceeds six months, then the endpoint returns `400 Bad Request`. **Allowable Values:**  Date in `yyyy-MM-dd` or `yyyy-MM-ddThh:mm:ssZ` format |

## Response body

| Fields | Description |
| - | - |
| count integer  Conditionally returned | 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 | Valid array of transaction objects. For more information, see the description of the [transaction object](/docs/core-api/transactions) on the Transactions page. Objects are returned based on your query. **Allowable Values:**  Valid array of one or more transaction objects |
| end\_index integer  Conditionally returned | 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 all resources have been returned. This field is returned if there are resources in your returned array. **Allowable Values:**  `true`, `false` |
| start\_index integer  Conditionally returned | 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

```json JSON lines wrap theme={null}
{
  "count": 2,
  "start_index": 0,
  "end_index": 1,
  "is_more": false,
  "data": [
    {
      "type": "authorization",
      "state": "PENDING",
      "identifier": "14814131",
      "token": "019c58db-b18f-76c3-8977-ac7a073f9571",
      "user_token": "my-user-new-pan",
      "acting_user_token": "my-user-new-pan",
      "card_token": "my-card-test-14",
      "card_product_token": "4d4183e1-957c-45fd-b028-438ab39e9570",
      "is_recurring": true,
      "created_time": "2026-02-13T21:15:18Z",
      "user_transaction_time": "2026-02-13T21:15:18Z",
      "settlement_date": "2026-02-13T00:00:00Z",
      "request_amount": 20.00,
      "amount": 20.00,
      "currency_code": "USD",
      "approval_code": "816315",
      "response": {
        "code": "0000",
        "memo": "Approved or completed successfully"
      },
      "network": "VISA",
      "subnetwork": "VISANET",
      "card_acceptor": {
        "mid": "000696875727497",
        "mcc": "6411",
        "name": "Marqeta Storefront",
        "street_address": "1000 Main St",
        "city": "St. Petersburg",
        "state": "FL",
        "postal_code": "33705",
        "country_code": "USA"
      },
      "pos": {
        "pan_entry_mode": "CARD_ON_FILE",
        "card_holder_presence": true,
        "card_presence": false,
        "is_recurring": true,
        "is_installment": false
      }
    },
    {
      "type": "authorization.clearing",
      "state": "COMPLETION",
      "identifier": "14814132",
      "token": "019c58e1-085d-7b16-9608-d40413fd7ba7",
      "user_token": "my-user-new-pan",
      "acting_user_token": "my-user-new-pan",
      "card_token": "my-card-test-14",
      "card_product_token": "4d4183e1-957c-45fd-b028-438ab39e9570",
      "is_recurring": true,
      "preceding_related_transaction_token": "019c58db-b18f-76c3-8977-ac7a073f9571",
      "original_transaction_token": "019c58db-b18f-76c3-8977-ac7a073f9571",
      "created_time": "2026-02-13T21:21:08Z",
      "user_transaction_time": "2026-02-13T21:15:18Z",
      "settlement_date": "2026-02-13T00:00:00Z",
      "request_amount": 20.00,
      "amount": 20.00,
      "currency_code": "USD",
      "approval_code": "639534",
      "response": {
        "code": "0000",
        "memo": "Approved or completed successfully"
      },
      "network": "VISA",
      "subnetwork": "VISANET",
      "card_acceptor": {
        "mid": "000696875727497",
        "mcc": "6411",
        "name": "Marqeta Storefront",
        "street_address": "1000 Main St",
        "city": "St. Petersburg",
        "state": "FL",
        "postal_code": "33705",
        "country_code": "USA"
      },
      "pos": {
        "card_presence": false,
        "is_recurring": true,
        "is_installment": false
      }
    }
  ]
}
```


## Related topics

- [Subscription Management Overview](/docs/core-api/subscription-management.md)
- [Dispute Reason Codes (Visa)](/docs/core-api/dispute-reason-codes-visa.md)
- [Creating Disputes](/docs/developer-guides/disputes-create.md)
- [Retrieve transaction](/docs/core-api/transactions/retrieve-transaction.md)
- [Core API Transaction Token](/docs/diva-api/core-api-transaction-token.md)
