> For the complete documentation index, see [llms.txt](https://tri.gitbook.io/tri-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tri.gitbook.io/tri-doc/liquidity-pool/get-mastercard-transactions.md).

# Get MasterCard Transactions

### Liquidity Pool

<mark style="color:blue;">`GET`</mark> <https://sandbox.triangle.digital/api/v2/liquidity\\_pool/clients/{client\\_id}/mastercard/transactions>

Transaction notifications of the MasterCard card of one holder — an employee or an individual consumption. One endpoint for both, named the same way as everywhere else: exactly one of `employee_id` and `individual_consumption_id`.

The source is MasterCard's undelivered-notifications feed, filtered to this holder's card, so it is **not** a complete history: a notification MasterCard has already delivered is not returned again, and one call reads one page of up to 100 notifications. A holder with no MasterCard card answers 200 with an empty list.

The transaction objects are passed through exactly as MasterCard sends them — their field names are MasterCard's, not ours, and a field MasterCard adds shows up here without a change on this side. The fields listed below are the ones the notifications carry today.

The last 4 digits of a card become known only from these notifications. The first read that finds them stores them, so `card_last4` is filled from then on — here and in [Get Employees](/tri-doc/liquidity-pool/get-employees.md).

MasterCard cards are view-only: nothing is ever charged to them. Purchases are paid by the Stripe card or from the balance.

**Path parameters**

<table data-full-width="true" data-search="false"><thead><tr><th width="230">Name</th><th width="110">Type</th><th>Description</th><th width="210">Where to take it from</th></tr></thead><tbody><tr><td><code>client_id</code></td><td>integer</td><td><strong>Required.</strong> The client the holder belongs to.</td><td><a href="/tri-doc/liquidity-pool/get-clients.md">Get Clients</a> — <code>client_id</code></td></tr></tbody></table>

**Headers**

<table data-full-width="true"><thead><tr><th>Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr></tbody></table>

**Query parameters**

<table data-full-width="true" data-search="false"><thead><tr><th width="250">Name</th><th width="110">Type</th><th>Description</th><th width="260">Example</th></tr></thead><tbody><tr><td><code>hash</code></td><td>string</td><td><strong>Required.</strong> API key.</td><td>fk5f0iuy-rr06-j4x3-i75b-fy2s67s4ilo1</td></tr><tr><td><code>employee_id</code></td><td>integer</td><td>The employee whose card is read. Exactly one of <code>employee_id</code> and <code>individual_consumption_id</code> is required. From <a href="/tri-doc/liquidity-pool/get-employees.md">Get Employees</a> — <code>employee_id</code>.</td><td>345</td></tr><tr><td><code>individual_consumption_id</code></td><td>uuid</td><td>The individual consumption whose card is read; Business clients only. Exactly one of <code>employee_id</code> and <code>individual_consumption_id</code> is required. From <a href="/tri-doc/liquidity-pool/get-individual-consumptions.md">Get Individual Consumptions</a> — <code>individual_consumption_id</code>.</td><td>68117898-4278-499f-b96b-78173f3d2040</td></tr></tbody></table>

**Response fields**

<table data-full-width="true" data-search="false"><thead><tr><th width="330">Field</th><th width="110">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>message</code></td><td>string</td><td>Human-readable result of the call.</td></tr><tr><td><code>success</code></td><td>boolean</td><td>Whether the call succeeded; a refused call answers HTTP 400.</td></tr><tr><td><code>data.card.card_name</code></td><td>string</td><td>Label given to the card at enrolment; empty when none was given.</td></tr><tr><td><code>data.card.card_last4</code></td><td>string</td><td>Last 4 digits of the card; empty until a notification carries them.</td></tr><tr><td><code>data.employee</code></td><td>object</td><td>The holder when it is an employee — <code>employee_id</code>, <code>employee_number</code>, <code>employee_name</code>. Absent for an individual consumption.</td></tr><tr><td><code>data.individual_consumption</code></td><td>object</td><td>The holder when it is an individual consumption — <code>individual_consumption_id</code>, <code>name</code>, <code>email</code>. Absent for an employee.</td></tr><tr><td><code>data.transactions</code></td><td>array</td><td>The notifications of this card, newest first as MasterCard returns them; empty when the holder has no card or nothing is undelivered.</td></tr><tr><td><code>data.transactions[].transUid</code></td><td>string</td><td>MasterCard's identifier of the transaction.</td></tr><tr><td><code>data.transactions[].cardReference</code></td><td>string</td><td>The card the transaction belongs to — always the holder's card.</td></tr><tr><td><code>data.transactions[].cardLastNumbers</code></td><td>string</td><td>Last 4 digits of the card.</td></tr><tr><td><code>data.transactions[].transactionAmount</code></td><td>string</td><td>Amount of the transaction, as MasterCard sends it.</td></tr><tr><td><code>data.transactions[].transactionCurrency</code></td><td>string</td><td>Currency of the transaction.</td></tr><tr><td><code>data.transactions[].merchantName</code></td><td>string</td><td>Merchant.</td></tr><tr><td><code>data.transactions[].merchantCurrency</code></td><td>string</td><td>Currency of the merchant.</td></tr><tr><td><code>data.transactions[].merchantCategoryCode</code></td><td>string</td><td>Merchant category code.</td></tr><tr><td><code>data.transactions[].merchantCategoryDescription</code></td><td>string</td><td>Description of the merchant category code; <code>null</code> when no description is known for the code.</td></tr><tr><td><code>data.transactions[].cardAcceptorStateOrCountry</code></td><td>string</td><td>State or country of the card acceptor.</td></tr><tr><td><code>data.transactions[].transactionLocalDate</code></td><td>string</td><td>Local date of the transaction, as MasterCard sends it.</td></tr><tr><td><code>data.transactions[].transactionLocalTime</code></td><td>string</td><td>Local time of the transaction, as MasterCard sends it.</td></tr><tr><td><code>operations_count</code></td><td>integer</td><td>Always <code>1</code>.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}
{% code fullWidth="false" %}

```json
{
    "message": "Data received successfully.",
    "success": true,
    "data": {
        "card": {
            "card_name": "Corporate",
            "card_last4": "4242"
        },
        "employee": {
            "employee_id": 345,
            "employee_number": "D2354324",
            "employee_name": "John Smith"
        },
        "transactions": [
            {
                "transUid": "9f1c7a52-3d84-4b1e-9c07-5ab2e6d41f30",
                "cardReference": "a1b2c3d4-5e6f-7081-92a3-b4c5d6e7f809",
                "cardLastNumbers": "4242",
                "transactionAmount": "378.30",
                "transactionCurrency": "USD",
                "merchantName": "UNITED AIRLINES",
                "merchantCurrency": "USD",
                "merchantCategoryCode": "3000",
                "merchantCategoryDescription": "UNITED AIRLINES",
                "cardAcceptorStateOrCountry": "NY",
                "transactionLocalDate": "2026-08-05",
                "transactionLocalTime": "11:46:50"
            }
        ]
    },
    "operations_count": 1
}
```

{% endcode %}
{% endtab %}

{% tab title="400" %}
Nothing was read. The `message` says what exactly: `Provide either employee_id or individual_consumption_id.` or `Provide either employee_id or individual_consumption_id, not both.`; `'employee_id' must be a positive integer.`; `Employee not found for this client.` or `Individual consumption not found for this client.`; `This client is not a Business account.` — an individual consumption was named for a non-Business client; `MasterCard API error (HTTP <code>)` or `Unable to retrieve MasterCard transactions.` — MasterCard did not answer, try again.

```json
{
    "message": "Employee not found for this client.",
    "success": false,
    "data": [],
    "operations_count": 1
}
```

{% endtab %}
{% endtabs %}