> 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-clients.md).

# Get Clients

### Liquidity Pool

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

Clients available to the API key, with their consumption and purchase totals. The whole list is returned in one answer.

**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="200">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></tbody></table>

**Response fields**

<table data-full-width="true" data-search="false"><thead><tr><th width="300">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 failed call answers HTTP 400.</td></tr><tr><td><code>data[].client_id</code></td><td>integer</td><td>The client. Use it as <code>client_id</code> in every <code>clients/{client_id}</code> endpoint.</td></tr><tr><td><code>data[].client_name</code> / <code>client_email</code> / <code>region</code></td><td>string</td><td>Name, email and region of the client.</td></tr><tr><td><code>data[].balance</code></td><td>number</td><td>Spending Capacity balance of the client, US dollars (see <a href="/tri-doc/liquidity-pool/balance.md">Balance</a>). A Carbon Pool Partner answers <code>0.0</code> — its balances belong to its employees and individual consumptions.</td></tr><tr><td><code>data[].autofill_balance</code></td><td>boolean</td><td>Whether the client's balance is topped up from the saved card, in $25 units, when a purchase paid from the balance needs more than it holds.</td></tr><tr><td><code>data[].total_ai_compute</code> / <code>total_air_travel</code> / <code>total_vehicle</code> / <code>total_lodging</code> / <code>total_food</code></td><td>object</td><td>Invoiced totals per expense type — <code>co2</code> (tons) and <code>amount</code> (USD).</td></tr><tr><td><code>data[].total_amount</code></td><td>number</td><td>Invoiced amount over all expense types, USD.</td></tr><tr><td><code>data[].total_co2</code></td><td>number</td><td>Invoiced quantity over all expense types, tons.</td></tr><tr><td><code>data[].total_purchased_co2</code></td><td>number</td><td>Quantity already purchased, tons.</td></tr><tr><td><code>data[].total_net_co2</code></td><td>number</td><td>Invoiced minus purchased, tons.</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": [
        {
            "client_id": 948,
            "client_name": "Company QA",
            "client_email": "company.qa@triangle.digital",
            "region": "Poland",
            "balance": 3.15,
            "autofill_balance": true,
            "total_ai_compute": {
                "co2": 0.0,
                "amount": 0.0
            },
            "total_air_travel": {
                "co2": 361.0518,
                "amount": 233524.56
            },
            "total_vehicle": {
                "co2": 324.0,
                "amount": 436.0
            },
            "total_lodging": {
                "co2": 0.0,
                "amount": 324.0
            },
            "total_food": {
                "co2": 0.0,
                "amount": 0.0
            },
            "total_amount": 234284.56,
            "total_co2": 778.0,
            "total_purchased_co2": 92.9482,
            "total_net_co2": 685.0518
        }
    ],
    "operations_count": 1
}
```

{% endcode %}
{% endtab %}

{% tab title="400" %}
The hash is unknown or missing; the message says what exactly.

```json
{
    "message": "Error! No such hash.",
    "success": false
}
```

{% endtab %}
{% endtabs %}