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

# Get Companies

### Liquidity Pool

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

Carbon Pool companies of the client, sorted by company name, up to 1000 rows in one answer. Business accounts only.

**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 whose companies are read.</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="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="280">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[].company_id</code></td><td>uuid</td><td>The company. Use it wherever a <code>company_id</code> is expected (<a href="/tri-doc/liquidity-pool/buy-carbon-pool.md">Buy Carbon Pool</a>, <a href="/tri-doc/liquidity-pool/get-carbon-transactions.md">Get Carbon Transactions</a>, <a href="/tri-doc/liquidity-pool/get-employees.md">Get Employees</a>).</td></tr><tr><td><code>data[].client_company_id</code></td><td>string</td><td>Company ID as entered by the client.</td></tr><tr><td><code>data[].company_name</code> / <code>first_name</code> / <code>last_name</code> / <code>email</code> / <code>telephone</code></td><td>string</td><td>The stored values; empty string when not filled.</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": [
        {
            "company_id": "96b3c062-e7da-4c3e-98d4-029de59c9dc7",
            "client_company_id": "119401",
            "company_name": "Triangle Digital",
            "first_name": "John",
            "last_name": "Smith",
            "email": "support@triangle.digital",
            "telephone": "+1 (555) 555-0199"
        }
    ],
    "operations_count": 1
}
```

{% endcode %}
{% endtab %}

{% tab title="400" %}
The hash is unknown, or the client is not a Business account; the message says what exactly.

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

{% endtab %}
{% endtabs %}