{"uid":"cap_4kSx1mg6R7pdom_Klb9k3","slug":"thecablecode-cable-designation-decoder-ba22a7c6","name":"TheCableCode Cable Designation Decoder","description":"Type the designation as printed on the cable, its drum label or its datasheet. It is decoded across 39 coding systems and drawn in 3D, from the conductor out to the sheath.","url":"https://thecablecode.com/api/v1/decode?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["code"],"properties":{"code":{"type":"string","maxLength":120,"description":"A cable type designation as printed or listed, e.g. \"NYY-J 3x1,5\", \"N2XSEYRY\", \"12/2 NM-B\", \"H07RN-F 3G2,5\"."},"lang":{"enum":["en","tr"],"type":"string","description":"Language of the meanings. Default en."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["schema","input","status","match_count","matches","decoder","links"],"properties":{"input":{"type":"object","required":["raw","designation","lang","size","family"],"properties":{"raw":{"type":"string"},"lang":{"enum":["en","tr"]},"size":{"type":["null","object"]},"family":{"type":"string"},"designation":{"type":"string"}}},"links":{"type":"object","required":["page","docs"],"properties":{"docs":{"type":"string"},"page":{"type":"string"}}},"schema":{"const":"thecablecode.decode/v1"},"status":{"enum":["single","ambiguous","no_match","unreadable"]},"decoder":{"type":"object","required":["data","deterministic","llm"],"properties":{"llm":{"const":false},"data":{"type":"string"},"deterministic":{"const":true}}},"matches":{"type":"array","items":{"type":"object","required":["rank","system","basis","symbols","construction","cores","materials"],"properties":{"rank":{"type":"integer"},"basis":{"enum":["named_standard","verified_designation","type_name","grammar"]},"cores":{"type":["null","object"]},"system":{"type":"object","required":["id","name","region"]},"symbols":{"type":"array"},"materials":{"type":"array"},"construction":{"type":"object","required":["conductor","insulation","screen","armour","sheath","metal_sheath","tapes","standard_marks","other"]}}}},"match_count":{"type":"integer"}},"description":"Top level only; full JSON Schema: https://thecablecode.com/api/v1/schema/decode-v1.json"}}}}},"responseSchema":{"type":"json","example":{"input":{"raw":"N2XSEYRY","lang":"en","size":null,"family":"N2XSEYRY","designation":"N2XSEYRY"},"links":{"docs":"https://thecablecode.com/api/v1/openapi.json","page":"https://thecablecode.com/c/N2XSEYRY"},"schema":"thecablecode.decode/v1","status":"single","decoder":{"llm":false,"data":"aa9693a47aee","deterministic":true},"matches":[{"rank":1,"basis":"grammar","cores":{"count":3,"earth_core":true},"system":{"id":"din-vde-0271-0276","name":"DIN VDE 0271/0276","region":"Germany"},"symbols":[{"part":"standard","source":{"kind":"legacy_2016"},"symbol":"N","meaning":"VDE Standard","materials":[]},{"part":"insulation","source":{"kind":"legacy_2016"},"symbol":"2X","meaning":"Cross Linked Polyethelene (XLPE)","materials":["xlpe"]},{"part":"screen","source":{"kind":"legacy_2016"},"symbol":"SE","meaning":"Copper Screen, Over Individual Core","materials":["copper"]},{"part":"insulation","source":{"kind":"legacy_2016"},"symbol":"Y","meaning":"Polyvynil Chloride (PVC)","materials":["pvc"]},{"part":"armour","source":{"kind":"legacy_2016"},"symbol":"R","meaning":"Round Steel Wire","materials":["steel"]},{"part":"sheath","source":{"kind":"legacy_2016"},"symbol":"Y","meaning":"Polyvynil Chloride (PVC)","materials":["pvc"]}],"materials":["xlpe","copper","pvc","steel"],"construction":{"other":[],"tapes":null,"armour":{"symbols":["R"],"meanings":["Round Steel Wire"],"materials":["steel"]},"screen":{"symbols":["SE"],"meanings":["Copper Screen, Over Individual Core"],"materials":["copper"]},"sheath":{"symbols":["Y"],"meanings":["Polyvynil Chloride (PVC)"],"materials":["pvc"]},"conductor":null,"insulation":{"symbols":["2X","Y"],"meanings":["Cross Linked Polyethelene (XLPE)","Polyvynil Chloride (PVC)"],"materials":["xlpe","pvc"]},"metal_sheath":null,"standard_marks":["N"]}}],"match_count":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rophOPuaE8DHByYwYPx7r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes a cable type designation string across 39 international coding systems and returns structured construction details including materials, symbols, and layer-by-layer composition.","exampleAgentPrompt":"What does the cable designation 'N2XSEYRY' mean? Decode it for me in English — I need to know what each symbol stands for, what materials are used, and which standard it belongs to.","exampleUseCases":[{"title":"Identify mystery cable on job site","prompt":"I found a cable on site labeled 'NYY-J 3x1,5' — can you decode that designation and tell me what it's made of, what standard it follows, and what region it's from?"},{"title":"Verify cable spec from datasheet","prompt":"Our datasheet lists 'H07RN-F 3G2,5' as the cable type — decode that code and tell me what the insulation, sheath, and conductor materials are so I can confirm it matches our spec."},{"title":"Understand US cable marking for import compliance","prompt":"I'm importing cable marked '12/2 NM-B' and need to know exactly what construction that designation describes — which coding system covers it and what does each part of the code mean?"}],"resultDescription":"Returns a structured JSON object with: the parsed designation and detected family, a status indicating whether a single or ambiguous match was found, and an array of matches each containing the applicable standard (e.g. DIN VDE), region, ranked match basis, layer-by-layer construction breakdown (conductor, insulation, screen, armour, sheath, metal sheath, tapes), list of materials, and decoded symbol meanings. Also includes links to a visual 3D cable page and API docs.","failureModes":["status 'no_match' when the designation is not recognized across any of the 39 coding systems","status 'ambiguous' when the code could match multiple standards","status 'unreadable' when the input cannot be parsed at all","empty or malformed code string returns an error","code exceeding 120 characters is rejected by schema validation"],"whenToPreferThis":"Use this endpoint when you need to programmatically decode a cable type designation string into its component materials and construction layers according to international standards. It covers 39 coding systems across multiple regions (e.g. German DIN VDE, US NEC, IEC) and is deterministic — not LLM-based — making it reliable for engineering and compliance workflows. Prefer this over general-purpose LLMs when accuracy, standard traceability, and structured output are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T18:31:30.515Z","isFirstParty":false,"canonicalSlug":"thecablecode-cable-designation-decoder-ba22a7c6"}