> 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. # Direct debits GET https://clients.infonite.tech/api/executions/results/{execution_id}/financial/v1/direct-debits Standing charges against your customer's accounts. Each entry carries the creditor, the mandate reference, the account charged, the amounts seen and the periodicity the institution reports. Field by field in [Direct debits](/guides/data-models/banking/direct-debits). **The fastest read of somebody's fixed costs.** Rent, utilities, insurance, subscriptions — the recurring commitments, without parsing every transaction of every account to find them. Features are chosen when the execution **starts**, not here. An execution that did not ask for `direct_debits_read` answers `204`, and the only way to get the data is to run another one. | Status | Meaning | | :----- | :-------------------------------------------------------------------------------------------------------------------------------- | | `200` | The mandates. | | `202` | `feature_not_ready` — `direct_debits_read` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `direct_debits_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/financial-data/direct-executions-v-1-results-financial-direct-debits ## 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 SEPA mandates charged against the accounts: who collects, how often, and how much the last charges were. It is the cheapest read of somebody’s recurring commitments. **An empty list is an answer, not a gap**: the feature ran and the source reported none. - `list of object` - `id` (string, required) — Product ID for the current execution. It may change between executions. - `product` ("direct_debit", required) - `sub_family` ("direct_debit:sepa", required) - `fetch_date` (string, required) — Date this product was fetched. - `account` (object, required) — The customer's account the debit is charged to. - `type`: `clabe` (CLABE) - `control_digits` (string, required) — Control digit - `entity_code` (string, required) — Bank code - `entity_country` (string, required) — Bank Country - `entity_office` (string, required) — Bank office - `masked` (string, required) — Partial Clabe - `value` (string, required) — Clave Bancaria Estandarizada - `type`: `generic` (Generic Identifier) - `value` (string, required) — Identifier - `control_digits` (string, optional) — Control digits - `entity_code` (string, optional) — Entity code - `entity_country` (string, optional) — Entity country - `entity_office` (string, optional) — Entity office - `type`: `iban` (IBAN) - `control_digits` (string, required) — Control digits - `entity_code` (string, required) — Bank code - `entity_country` (string, required) — Bank Country - `entity_office` (string, required) — Bank office - `masked` (string, required) — Partial IBAN - `value` (string, required) — International Bank Account Number - `status` (enum, required) — Status of the direct debit authorization. - Allowed values: `unknown`, `active`, `cancelled`, `suspended`, `expired` - `customer_segment` (enum, required) — Whether the account belongs to a personal or a business relationship. - Allowed values: `not_assigned`, `personal`, `business`, `corporate`, `private`, `retail` - `beneficiary` (object, required) — Who collects the debit. - `identifier` (string, optional) — Beneficiary identifier, as the bank reports it. - `name` (string, optional) — Beneficiary name. - `account` (object, optional) — Account the beneficiary collects into, when the bank discloses it. - `type`: `clabe` (CLABE) - `control_digits` (string, required) — Control digit - `entity_code` (string, required) — Bank code - `entity_country` (string, required) — Bank Country - `entity_office` (string, required) — Bank office - `masked` (string, required) — Partial Clabe - `value` (string, required) — Clave Bancaria Estandarizada - `type`: `generic` (Generic Identifier) - `value` (string, required) — Identifier - `control_digits` (string, optional) — Control digits - `entity_code` (string, optional) — Entity code - `entity_country` (string, optional) — Entity country - `entity_office` (string, optional) — Entity office - `type`: `iban` (IBAN) - `control_digits` (string, required) — Control digits - `entity_code` (string, required) — Bank code - `entity_country` (string, required) — Bank Country - `entity_office` (string, required) — Bank office - `masked` (string, required) — Partial IBAN - `value` (string, required) — International Bank Account Number - `tax_id` (string, optional) — Beneficiary tax ID, when the bank discloses it. - `payer` (object, required) — Who pays the debit. - `name` (string, optional) — Payer name. - `identifier` (string, optional) — Payer identifier, as the bank reports it. - `transactions` (list of object, required) — Recent charges of this debit, as reported by the bank. - `status` (enum, required) — Status of this charge. - Allowed values: `unknown`, `pending`, `booked`, `cancelled`, `failed`, `reversed` - `issue_date` (string, optional) — Date the charge was issued. - `payment_date` (string, optional) — Date the charge was paid. - `concept` (string, optional) — Concept of the charge, as the bank reports it. - `amount` (object, optional) — Amount of the charge. - `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 - `debit_reference` (string, optional) — Mandate/debit reference, as the bank reports it. - `attachments` (list of object, optional, default: []) — Supporting documents of the debit — e.g. the receipt of the most recent charge. Each entry's `id` downloads the file through the execution's attachments endpoint. - `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`: `direct_debits_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 ### A monthly bill charged to an account **Response** ```json [ { "id": "6aa3d8c7f1b2a3d4e5f60721", "product": "direct_debit", "sub_family": "direct_debit:sepa", "fetch_date": "2026-09-12T10:17:44+00:00", "account": { "type": "iban", "control_digits": "45", "entity_code": "2100", "entity_country": "ES", "entity_office": "0418", "masked": "ES91 **** **** **** **** 1332", "value": "ES9121000418450200051332" }, "status": "active", "customer_segment": "personal", "beneficiary": { "identifier": "ES04000A81948077", "name": "ENDESA ENERGIA SAU" }, "payer": { "name": "ELIGIO LUNA BARRAGÁN" }, "transactions": [ { "status": "booked", "concept": "Factura electricidad agosto", "amount": { "currency": "EUR", "amount": "78.42" } }, { "status": "booked", "concept": "Factura electricidad julio", "amount": { "currency": "EUR", "amount": "71.05" } } ], "debit_reference": "MND-2021-00041832" } ] ``` **SDK Code** ```python A monthly bill charged to an account import requests url = "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits" headers = {"X-APP-SECRET": ""} response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript A monthly bill charged to an account const url = 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits'; 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 A monthly bill charged to an account package main import ( "fmt" "net/http" "io" ) func main() { url := "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits" 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 A monthly bill charged to an account require 'uri' require 'net/http' url = URI("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits") 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 A monthly bill charged to an account import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits") .header("X-APP-SECRET", "") .asString(); ``` ```php A monthly bill charged to an account request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits', [ 'headers' => [ 'X-APP-SECRET' => '', ], ]); echo $response->getBody(); ``` ```csharp A monthly bill charged to an account using RestSharp; var client = new RestClient("https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits"); var request = new RestRequest(Method.GET); request.AddHeader("X-APP-SECRET", ""); IRestResponse response = client.Execute(request); ``` ```swift A monthly bill charged to an account import Foundation let headers = ["X-APP-SECRET": ""] let request = NSMutableURLRequest(url: NSURL(string: "https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits")! 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/financial/v1/direct-debits" 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/financial/v1/direct-debits'; 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/financial/v1/direct-debits" 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/financial/v1/direct-debits") 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/financial/v1/direct-debits") .header("X-APP-SECRET", "") .asString(); ``` ```php This family has not finished request('GET', 'https://clients.infonite.tech/api/executions/results/6aa3d8b418d1c5dc9a8e3d36/financial/v1/direct-debits', [ '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/financial/v1/direct-debits"); 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/financial/v1/direct-debits")! 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() ```