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

# Get Invoices

### Liquidity Pool

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

Carbon Pool invoices of the client, one row per invoice, newest first. The whole list is returned in one answer, up to 1000 rows.

**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 invoices 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="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[].invoice_id</code></td><td>integer</td><td>The invoice. Pass it in <code>invoice_ids</code> of <a href="/tri-doc/liquidity-pool/get-available-assets.md">Get Available Assets</a> and <a href="/tri-doc/liquidity-pool/purchase-assets.md">Purchase Assets</a>.</td></tr><tr><td><code>data[].invoice_number</code></td><td>string</td><td>Invoice number as entered.</td></tr><tr><td><code>data[].employee_id</code></td><td>integer</td><td>Employee of the invoice, as in <a href="/tri-doc/liquidity-pool/get-employees.md">Get Employees</a> — <code>employee_id</code>; 0 when the invoice has none.</td></tr><tr><td><code>data[].employee_number</code></td><td>string</td><td>Client-facing Employee ID.</td></tr><tr><td><code>data[].employee_name</code></td><td>string</td><td>Employee name.</td></tr><tr><td><code>data[].transaction_date</code></td><td>string</td><td>Invoice date, MM/DD/YYYY; empty when not set.</td></tr><tr><td><code>data[].transaction_type</code></td><td>string</td><td>Transaction Type of the invoice when all its expense lines carry the same one: one of <code>business_travel</code>, <code>employee_commuting</code>, <code>purchased_goods_and_services</code>. <code>null</code> when the lines carry different types — see <code>transaction_types</code>. Empty when none is set.</td></tr><tr><td><code>data[].transaction_types</code></td><td>array</td><td>Every Transaction Type the invoice's expense lines carry, each once, in the order of the lines. <code>[]</code> when none is set.</td></tr><tr><td><code>data[].credit_card</code></td><td>boolean</td><td>Whether the employee of the invoice has a card attached.</td></tr><tr><td><code>data[].ai_compute</code> / <code>air_travel</code> / <code>vehicle</code> / <code>lodging</code> / <code>food</code></td><td>object</td><td>Per expense type — <code>co2</code> (tons) and <code>amount</code> (USD).</td></tr><tr><td><code>data[].expense_lines</code></td><td>array</td><td>The expense lines the invoice was entered as. The per-expense-type objects above are their totals, and a purchase reduces those totals without touching the lines — so on a partly purchased invoice the lines add up to more than what is left. Empty for an invoice entered without lines. A field the invoice does not carry comes back as null.</td></tr><tr><td><code>data[].expense_lines[].expense_type</code></td><td>string</td><td><strong>Required.</strong> One of: <code>ai_compute</code>, <code>air_travel</code>, <code>vehicle</code>, <code>lodging</code>, <code>food</code>.</td></tr><tr><td><code>data[].expense_lines[].amount</code></td><td>number</td><td>USD of this line.</td></tr><tr><td><code>data[].expense_lines[].co2</code></td><td>number</td><td>Tons of CO<sub>2</sub> of this line.</td></tr><tr><td><code>data[].expense_lines[].transaction_type</code></td><td>string</td><td>Transaction Type of this line, one of <code>business_travel</code>, <code>employee_commuting</code>, <code>purchased_goods_and_services</code>; <code>null</code> when none is set.</td></tr><tr><td><code>data[].expense_lines[].date</code></td><td>string</td><td>Air Travel and Lodging. Date of the flight or of the stay, MM/DD/YYYY.</td></tr><tr><td><code>data[].expense_lines[].flight_origin</code></td><td>string</td><td>Air Travel only. Airport or city the flight departs from.</td></tr><tr><td><code>data[].expense_lines[].destination</code></td><td>string</td><td>Air Travel only. Airport or city the flight arrives at.</td></tr><tr><td><code>data[].expense_lines[].provider</code></td><td>string</td><td>Air Travel and Lodging. Airline or hotel of the line.</td></tr><tr><td><code>data[].expense_lines[].distance_miles</code></td><td>number</td><td>Air Travel only. Distance in miles, up to 4 decimal places.</td></tr><tr><td><code>data[].expense_lines[].round_trip</code></td><td>boolean</td><td>Air Travel only. Whether the flight is a round trip.</td></tr><tr><td><code>data[].expense_lines[].nights</code></td><td>integer</td><td>Lodging only. Number of nights, a whole number.</td></tr><tr><td><code>data[].expense_lines[].region</code></td><td>string</td><td>Lodging only. Region of the stay.</td></tr><tr><td><code>data[].total_co2</code></td><td>number</td><td>Sum of the <code>co2</code> values, 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": [
        {
            "invoice_id": 61,
            "invoice_number": "56WFFS23",
            "employee_id": 18,
            "employee_number": "D2354324",
            "employee_name": "John Smith",
            "transaction_date": "07/07/2026",
            "transaction_type": "business_travel",
            "transaction_types": ["business_travel"],
            "credit_card": false,
            "ai_compute": {
                "co2": 0.0,
                "amount": 0.0
            },
            "air_travel": {
                "co2": 3.0,
                "amount": 1.0
            },
            "vehicle": {
                "co2": 0.0,
                "amount": 0.0
            },
            "lodging": {
                "co2": 0.0,
                "amount": 0.0
            },
            "food": {
                "co2": 0.0,
                "amount": 0.0
            },
            "expense_lines": [
                {
                    "expense_type": "air_travel",
                    "amount": 1.0,
                    "co2": 3.0,
                    "transaction_type": "business_travel",
                    "date": "09/01/2026",
                    "flight_origin": "JFK",
                    "destination": "LHR",
                    "provider": "Delta",
                    "distance_miles": 3450,
                    "round_trip": true
                }
            ],
            "total_co2": 3.0
        }
    ],
    "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 %}
