# TheCableCode: Cable Designation Decoder with 3D Visualization

> TheCableCode: Cable Designation Decoder with 3D Visualization is a paid API for AI agents from thecablecode.com, paid per call via x402, $0.5/call, status unknown (last checked 2026-10-22).

Decodes an electrical cable designation string across 39 coding systems and returns a full structured design plus 3D visualization files (SVG, DXF, GLB, CSV, XML).

## Facts

- Endpoint: GET https://thecablecode.com/api/v1/design?utm_source=zero.xyz
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/thecablecode-cable-designation-decoder-with-3d-visualization-333c6af6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wfYJSZBKQxWc9DG-6yYMH

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability thecablecode-cable-designation-decoder-with-3d-visualization-333c6af6
```

Example prompt: Can you decode the cable designation NA2XS(F)2Y 1x240 RM/25 12/20 kV for me and give me a 3D visualization and SVG cross-section? I need the full breakdown of conductor, insulation, sheath, and armour details.

## When to prefer this

Choose this endpoint when you need to programmatically decode an electrical cable designation code (as printed on a cable drum, datasheet, or label) into structured engineering specifications, or when you need 2D/3D visualization files (SVG cross-section, DXF, GLB) of the cable construction. It covers 39 international coding systems including IEC, BS, and HD standards. Prefer it over generic LLM-based cable interpretation because it is explicitly deterministic and standards-based, not AI-guessed.

## Known failure modes

- Unrecognised designation string returns warnings or empty design with explanation of what could not be parsed
- Designation ambiguous across multiple standards returns warnings listing alternatives
- Required 'sentence' query parameter missing causes validation error
- Designation too long (over 300 characters) rejected by schema
- Unsupported format value in 'formats' parameter causes error
- Language enum value other than 'en' or 'tr' rejected

## How this service works

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.

## Output

Returns a structured JSON object conforming to the thecablecode.design/v1 schema, containing: the decoded cable design (conductor, cores, insulation, sheath, armour, voltage, standard), overall diameter in mm, a read-back of interpreted parameters, any warnings about assumptions or defaults, and optionally base64-encoded or URL-linked files in SVG, DXF, GLB, CSV, and/or XML formats. Also includes links to the interactive designer and decode page.

## Request schema (JSON Schema)

```json
{
 "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": [
      "sentence"
     ],
     "properties": {
      "lang": {
       "enum": [
        "en",
        "tr"
       ],
       "type": "string"
      },
      "formats": {
       "type": "string",
       "description": "Comma separated: xml, dxf, svg, csv, glb, step, pdf"
      },
      "sentence": {
       "type": "string",
       "maxLength": 300,
       "description": "The cable in words, Turkish or English: voltage, cores, section, conductor metal, screen, sheath, watertightness, armour. What is not said takes a default, and the answer lists which."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "files": {
       "type": "object",
       "properties": {
        "csv": {
         "type": "string"
        },
        "dxf": {
         "type": "string"
        },
        "svg": {
         "type": "string"
        },
        "xml": {
         "type": "string"
        },
        "step": {
         "type": "string"
        },
        "glb_base64": {
         "type": "string"
        },
        "pdf_base64": {
         "type": "string"
        }
       }
      },
      "heard": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "input": {
       "type": "object",
       "properties": {
        "kind": {
         "enum": [
          "sentence",
          "spec",
          "design"
         ]
        },
        "lang": {
         "enum": [
          "en",
          "tr"
         ]
        },
        "sentence": {
         "type": "string"
        }
       }
      },
      "links": {
       "type": "object",
       "properties": {
        "docs": {
         "type": "string"
        },
        "decode": {
         "type": "string"
        },
        "designer": {
         "type": "string"
        }
       }
      },
      "design": {
       "type": "object",
       "properties": {
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "schema": "thecablecode.design/v1",
  "dimensions": {
   "overall_diameter_mm": 39.8
  },
  "designation": {
   "full": "NA2XS(F)2Y 1x240 RM/25 12/20 kV"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/thecablecode-cable-designation-decoder-with-3d-visualization-333c6af6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from thecablecode.com](https://www.zero.xyz/host/thecablecode.com/llms.txt)