> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://infonite.dev/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://infonite.dev/_mcp/server. # Client invoices GET https://clients.infonite.tech/api/executions/results/{execution_id}/commercial/v1/client-invoices Invoices your customer has **issued** — what they bill the people they sell to. The mirror of the supplier invoices, for accounts that sell: each entry carries its number and dates, the recipient, the amounts and taxes, and whether the original document is available. Together, the two sides describe the trading of a business without asking it for a spreadsheet. **The document is a separate call.** The invoice carries `attachments` — references by `id` — and the file comes from [Download a document](api:GET/executions/results/\{execution_id}/attachments/v1/\{attachment_id}), the same endpoint every other original goes through. Features are chosen when the execution **starts**, not here. An execution that did not ask for `client_invoices_read` answers `204`, and the only way to get the data is to run another one. | Status | Meaning | | :----- | :---------------------------------------------------------------------------------------------------------------------------------- | | `200` | The invoices. | | `202` | `feature_not_ready` — `client_invoices_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `client_invoices_read`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. Reference: https://infonite.dev/api-reference/direct-executions/direct-executions-api/fetching-the-results/commercial-data/direct-executions-v-1-results-commercial-client-invoices ## Authentication - `X-APP-SECRET` header (required) — Application Secret ## Servers - `https://clients.infonite.tech/api` (Legacy Server, default) - `https://clients.infonite.io/api` (Production Server) ## Request ### Path parameters - `execution_id` (string, required) — The execution, as the acceptance response returned it. ## Response ### 200 **200 OK**The invoices your customer **issues** — who they billed, for how much and when. Read together with the supplier invoices, it is a picture of a business’s trading rather than of its bank account. **An empty list is an answer, not a gap**: the feature ran and the source reported none. - `list of object` - `id` (string, required) — Invoice ID for the current execution. Note: it may change between executions. - `product` ("client_invoice", required) - `sub_family` (enum, required) - Allowed values: `client_invoice:receipt`, `client_invoice:standard`, `client_invoice:proforma`, `client_invoice:credit_memo`, `client_invoice:debit_memo`, `client_invoice:electronic`, `client_invoice:retail`, `client_invoice:commercial` - `fetch_date` (string, required) — Date this product was fetched - `identifier` (string, optional) — Invoice number - `contract` (string, optional) — Contract if any - `issue_date` (string, optional) — Issue date - `due_date` (string, optional) — Due date - `tax_details` (list of object, optional) — Tax details - `tax_type` (string, optional) — Tax type - `tax_rate` (object, optional) — Tax rate - `decimals` (integer, optional, default: 2) - `tax_amount` (object, optional) — Tax amount - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `total_tax_amount` (object, optional) — Total tax amount - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `total_discount_amount` (object, optional) — Total discount amount - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `total_amount` (object, optional) — Total amount - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `total_net_amount` (object, optional) — Total net amount - `currency` (string or "***", required) — Three-letter ISO currency code — or `***` when the source did not disclose the currency. - `amount` (string, required) — Decimal number with 2 digits precision - `issuer` (object, optional) — Issuer - `name` (string, optional) — Entity name - `tax_id` (string, optional) — Entity Tax ID - `address` (string, optional) — Entity address - `receiver` (object, optional) — Receiver - `name` (string, optional) — Entity name - `tax_id` (string, optional) — Entity Tax ID - `address` (string, optional) — Entity address - `attachments` (list of object, optional, default: []) — List of attached supporting documents - `sub_family` (enum, required) — What kind of document this is (e.g. `attachment:es-tgss-life-report`). - Allowed values: `attachment:attachment`, `attachment:supplier_invoice`, `attachment:client_invoice`, `attachment:es-tgss-life-report`, `attachment:es-tgss-contribution-base-report`, `attachment:es-aeat-model-100`, `attachment:es-cirbe-report`, `attachment:sepa-direct-debit-bill` - `id` (string, required) — Attachment identifier — use it to download the file through the execution's attachments endpoint. - `content_name` (string, required) — File name of the document. - `content_type` (string, required) — MIME type of the content. - `metadata` (map from string to any, required) — Extra facts about the document, as simple key-value pairs (e.g. its official verification code, its issue date). - `product` ("attachment", optional, default: attachment) — The product type identifier. Always `attachment`. - `content_hash` (string, optional) — Fingerprint of the content, to verify its integrity. ### 202 **202 Accepted**`feature_not_ready`: `client_invoices_read` is still running. **You do not have to wait for the whole execution** — every family answers as soon as its own feature closes, so a slow source does not hold up the ones that already finished. - `detail` (string, required) — Error message ## Errors ### 404 Not Found Error **404 Not Found**No execution with that id for your application, or it has been deleted. - `detail` (string, required) — Error message ### 422 Unprocessable Entity Error Validation Error - `detail` (list of object, optional) - `loc` (list of string or integer, required) - `msg` (string, required) - `type` (string, required) - `input` (any, optional) - `ctx` (object, optional) ## Examples ### One issued invoice **Response** ```json [ { "id": "6aa3d8c7f1b2a3d4e5f6071b", "product": "client_invoice", "sub_family": "client_invoice:standard", "fetch_date": "2026-09-12T10:17:44+00:00", "identifier": "2026/114", "issue_date": "2026-08-28T00:00:00+00:00", "due_date": "2026-09-27T00:00:00+00:00", "tax_details": [ {} ], "total_tax_amount": { "currency": "EUR", "amount": "210.00" }, "total_amount": { "currency": "EUR", "amount": "1210.00" }, "total_net_amount": { "currency": "EUR", "amount": "1000.00" }, "issuer": { "name": "DEMO CORP SL" }, "receiver": { "name": "CLIENTE EJEMPLO SL" } } ] ``` **SDK Code** ```python One issued invoice import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript One issued invoice const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices'; const options = {method: 'GET', headers: {'X-APP-SECRET': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go One issued invoice package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-APP-SECRET", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby One issued invoice require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-APP-SECRET"] = '' response = http.request(request) puts response.read_body ``` ```java One issued invoice import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices") .header("X-APP-SECRET", "") .asString(); ``` ```php One issued invoice request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp One issued invoice using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift One issued invoice import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ``` ### This family has not finished **Response** ```json { "detail": "feature_not_ready" } ``` **SDK Code** ```python This family has not finished import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript This family has not finished const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices'; const options = {method: 'GET', headers: {'X-APP-SECRET': ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go This family has not finished package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("X-APP-SECRET", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby This family has not finished require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["X-APP-SECRET"] = '' response = http.request(request) puts response.read_body ``` ```java This family has not finished import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices") .header("X-APP-SECRET", "") .asString(); ``` ```php This family has not finished request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp This family has not finished using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift This family has not finished import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/commercial/v1/client-invoices")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```