{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"62c98fdf-2d28-4ec9-aaa8-273642256bcb","name":"Clients API","description":"### **Introduction**\n\nThe KENO B2B Clients API provides a RESTful interface for accessing structured data from the KENO B2B platform. It enables external systems to retrieve key information such as:\n\n- Product details\n    \n- Documentation\n    \n- Stock levels\n    \n- Pricing\n    \n- Technical parameters\n    \n\nAll communication is conducted using JSON format.\n\n---\n\n### **Integration**\n\nIntegration with the API requires implementation on the client side. The API is publicly documented and intended for use by developers with the necessary technical expertise.\n\nThe API is **read-only**, and all methods follow a unified query structure. Integration is available exclusively to users who hold an active account on the KENO B2B platform.\n\n---\n\n### **Authentication and Access**\n\nTo access the API, a unique access key (token) is required. This token:\n\n- Is issued upon request to verified business partners of KENO\n    \n- Access keys can be generated directly by the verified user within the B2B platform\n    \n- Must be included as a `key` parameter in the URL of each API request\n    \n- Remains valid indefinitely, unless manually revoked by KENO\n    \n\nIn exceptional cases, KENO reserves the right to deactivate the key and block API access without prior notice (e.g., due to overdue payments or termination of partnership).\n\nTo request access, email: [<b>helpdesk@b2b.keno-energy.com</b>](https://null)\n\n---\n\n### **Rate Limiting**\n\nAPI requests are subject to a minimum interval of **100ms** between queries. Exceeding this threshold may result in throttling or temporary blocking.\n\n---\n\n### **Request Format**\n\nAll API requests share the same structure and must include the following:\n\n- **`method`** (string): The name of the method to be executed. Invalid method names result in an error.\n    \n- **`data`** (object): An object containing required and optional parameters for the method. If a method requires no parameters, pass an empty object.\n    \n\n**Example Request Payload:**\n\n``` json\n{\n  \"method\": \"GetDocuments\",\n  \"data\": {\n    \"index\": \"ABC\"\n  }\n}\n\n ```\n\n---\n\n### **Response Format**\n\nResponses are returned in JSON format with HTTP status code `200` on success.\n\n**Examples:**\n\n- **Empty result (no data to return):**\n    \n\n``` json\n{\n}\n\n ```\n\n- **Single object response:**\n    \n\n``` json\n{\n  \"index\": \"ABC\"\n}\n\n ```\n\n- **List of results with pagination:**\n    \n\n``` json\n{\n  \"page\": 1,\n  \"pages\": 1,\n  \"results\": [\n    {\n      \"id\": 1,\n      \"index\": \"ABC\"\n    },\n    {\n      \"id\": 2,\n      \"index\": \"XYZ\"\n    }\n  ]\n}\n\n ```\n\nData structures returned for each method are described in detail in the public API documentation.\n\n---\n\n### **Response Language Selection**\n\nTo localize response content (e.g., names, descriptions, error messages), use the optional `X-Response-Language` header in the request.\n\n- If the header is missing or contains an unsupported code, the default response language is **English**.\n    \n- Language codes follow the ISO 639-1 (alpha-2) standard.\n    \n\n**Example Header:**\n\n```\nX-Response-Language: en\n\n ```\n\n**Supported Languages:**\n\n- `en` – English\n    \n- `pl` – Polish\n    \n- `de` – German\n    \n- `cs` – Czech\n    \n- `sk` – Slovak\n    \n- `hu` – Hungarian\n    \n- `ro` – Romanian\n    \n\n---\n\n### **Error Responses**\n\nIn the event of an invalid request or method execution failure, the API returns a JSON error response with the following structure:\n\n#### **Error Response Format**\n\n``` json\n{\n  \"status\": \"error\",\n  \"message\": \"There is already an account assigned to this email address\",\n  \"details\": false,\n  \"additional\": {}\n}\n\n ```\n\n#### **Field Descriptions**\n\n| **Field** | **Type** | **Description** |\n| --- | --- | --- |\n| `status` | `string` | Always set to `\"error\"` when an error occurs. |\n| `message` | `string` | User-friendly error message, localized based on the `X-Response-Language` header. |\n| `details` | `bool` or `string` | Optional developer-facing technical explanation. Defaults to `false`. If provided as a string, it contains internal debug information. |\n| `additional` | `object` | Optional. Contains extra context data when applicable (e.g., problematic product ID, validation fields, etc.). |\n\n---\n\nThe `message` field is automatically returned in the appropriate language according to the `X-Response-Language` request header. If the header is not provided or the language code is unsupported, the message defaults to English.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"24105792","collectionId":"62c98fdf-2d28-4ec9-aaa8-273642256bcb","publishedId":"2sB3BBor4J","public":true,"publicUrl":"https://b2b.api.keno-energy.com","privateUrl":"https://go.postman.co/documentation/24105792-62c98fdf-2d28-4ec9-aaa8-273642256bcb","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"ed7624"},"documentationLayout":"classic-single-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":"KENO B2B Clients API"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/857a72de-8564-4eb8-9a90-164a4a11ab4c/S0VOT19OT19MQU5HLnBuZw==","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"ed7624"}},{"name":"light","logo":"https://content.pstmn.io/857a72de-8564-4eb8-9a90-164a4a11ab4c/S0VOT19OT19MQU5HLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"ed7624"}}]}},"version":"8.10.0","publishDate":"2025-11-24T14:45:09.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"KENO B2B Clients API","description":""},"logos":{"logoLight":"https://content.pstmn.io/857a72de-8564-4eb8-9a90-164a4a11ab4c/S0VOT19OT19MQU5HLnBuZw==","logoDark":"https://content.pstmn.io/857a72de-8564-4eb8-9a90-164a4a11ab4c/S0VOT19OT19MQU5HLnBuZw=="}},"statusCode":200},"environments":[{"name":"Production","id":"b8b2e7d1-c49c-4583-9eff-6f57b3a447ef","owner":"24105792","values":[{"key":"url","value":"https://b2b.keno-energy.com/API/clt","enabled":true,"type":"default"},{"key":"key","value":"skmdSdsS324Fit","enabled":true,"type":"secret"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/768118b36f06c94b0306958b980558e6915839447e859fe16906e29d683976f0","favicon":"https://keno-energy.com/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"Production","value":"24105792-b8b2e7d1-c49c-4583-9eff-6f57b3a447ef"}],"canonicalUrl":"https://b2b.api.keno-energy.com/view/metadata/2sB3BBor4J"}