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

# List Transactions

> Retrieve a list of transactions across your merchant account.

Retrieve a paginated list of all successful and failed transactions processed across all delegates connected to your merchant account.

### Headers

<ParamField header="X-Delegare-Merchant-Id" type="string" required>
  Your merchant identifier.
</ParamField>

<ParamField header="X-Delegare-Api-Key" type="string" required>
  Your merchant API key.
</ParamField>

### Query Parameters

<ParamField query="limit" type="integer" default="10">
  A limit on the number of objects to be returned, between 1 and 100.
</ParamField>

<ParamField query="starting_after" type="string">
  A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list.
</ParamField>

### Response

<ResponseField name="hasMore" type="boolean">
  Whether there are more transactions available in the list.
</ResponseField>

<ResponseField name="data" type="array">
  An array of transaction objects.

  <Expandable title="properties">
    <ResponseField name="id" type="string">
      Unique identifier for the transaction.
    </ResponseField>

    <ResponseField name="delegateId" type="string">
      The ID of the Intent Mandate used for the transaction.
    </ResponseField>

    <ResponseField name="amountCents" type="integer">
      The transaction amount in cents (USD).
    </ResponseField>

    <ResponseField name="status" type="string">
      The status of the transaction (`succeeded`, `failed`, `pending`).
    </ResponseField>

    <ResponseField name="rail" type="string">
      The rail used for settlement (`stripe` or `base`).
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      ISO 8601 timestamp of when the transaction occurred.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl -X GET "https://api.sandbox.delegare.dev/v1/merchants/transactions?limit=10" \
    -H "X-Delegare-Merchant-Id: your_merchant_id" \
    -H "X-Delegare-Api-Key: your_api_key"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "hasMore": false,
    "data": [
      {
        "id": "txn_123456789",
        "delegateId": "del_987654321",
        "amountCents": 500,
        "status": "succeeded",
        "rail": "base",
        "createdAt": "2024-03-27T10:00:00Z"
      },
      {
        "id": "txn_223456789",
        "delegateId": "del_187654321",
        "amountCents": 1200,
        "status": "succeeded",
        "rail": "stripe",
        "createdAt": "2024-03-26T14:30:00Z"
      }
    ]
  }
  ```
</ResponseExample>
