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

# Listar transacciones

> Este endpoint obtiene una lista paginada de transacciones de tarjeta con filtros opcionales

### Parámetros de consulta

<ParamField query="companyId" type="string">
  Filtrar transacciones por ID de empresa
</ParamField>

<ParamField query="userId" type="string">
  Filtrar transacciones por ID de usuario
</ParamField>

<ParamField query="cardId" type="string">
  Filtrar transacciones por ID de tarjeta
</ParamField>

<ParamField query="cursor" type="string">
  Cursor de paginación para obtener la siguiente página de resultados
</ParamField>

<ParamField query="limit" type="number">
  Cantidad de transacciones por página (1-100, por defecto: 20)
</ParamField>

### Respuesta

<ResponseField name="success" type="boolean">
  Indica si la operación fue exitosa
</ResponseField>

<ResponseField name="data" type="array">
  Arreglo de objetos de transacción

  <Expandable title="Objeto transaction">
    <ResponseField name="transactionId" type="string">
      Identificador único de la transacción
    </ResponseField>

    <ResponseField name="cardId" type="string">
      El ID de la tarjeta usada en la transacción
    </ResponseField>

    <ResponseField name="userId" type="string">
      El ID de usuario del titular de la tarjeta
    </ResponseField>

    <ResponseField name="amount" type="number">
      Monto de la transacción
    </ResponseField>

    <ResponseField name="currency" type="string">
      Código de moneda de la transacción (por ejemplo, "USD")
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado de la transacción: `pending`, `approved`, `declined` o `reversed`
    </ResponseField>

    <ResponseField name="merchantName" type="string">
      Nombre del comercio
    </ResponseField>

    <ResponseField name="merchantCategory" type="string">
      Código de categoría del comercio (MCC)
    </ResponseField>

    <ResponseField name="type" type="string">
      Tipo de transacción: `purchase`, `refund`, `withdrawal`, etc.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Fecha y hora (ISO 8601) de cuándo se creó la transacción
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Información de paginación

  <Expandable title="Objeto pagination">
    <ResponseField name="nextCursor" type="string">
      Cursor para la siguiente página (null si no hay más páginas)
    </ResponseField>

    <ResponseField name="hasMore" type="boolean">
      Si hay más resultados disponibles
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --location --request GET 'https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/transactions?cardId=7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d&limit=20' \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>'
  ```

  ```js Javascript theme={null}
  const response = await fetch('https://stablecoin-api.sandbox.getmeru.com/api/v1/cards-program/transactions?cardId=7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d&limit=20', {
    method: 'GET',
    headers: {
      'Content-Type': 'application/json',
      'api-key': '<api-key>'
    }
  });

  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": [
      {
        "transactionId": "txn_1a2b3c4d5e6f7g8h",
        "cardId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
        "userId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
        "amount": 49.99,
        "currency": "USD",
        "status": "approved",
        "merchantName": "Amazon.com",
        "merchantCategory": "5942",
        "type": "purchase",
        "createdAt": "2024-01-15T14:23:45Z"
      },
      {
        "transactionId": "txn_9h8g7f6e5d4c3b2a",
        "cardId": "7a8b9c0d-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
        "userId": "3ddd0e5b-6276-4b48-b756-c1fcc9a2efd1",
        "amount": 125.50,
        "currency": "USD",
        "status": "approved",
        "merchantName": "Whole Foods",
        "merchantCategory": "5411",
        "type": "purchase",
        "createdAt": "2024-01-14T09:15:22Z"
      }
    ],
    "pagination": {
      "nextCursor": "eyJpZCI6MTIzNDU2fQ==",
      "hasMore": true
    }
  }
  ```
</ResponseExample>

### Respuestas de error

<ResponseExample>
  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized. Please check your authentication credentials."
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "Invalid query parameters."
  }
  ```
</ResponseExample>