Included with active API and MAX subscriptions. Use a standard API key with vdb_read, or a restricted key with ecu_observe. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the /v2/ecu/ prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.
Reuse this key only for retries of the same operation and parameters. Keys are scoped to the account. A retry returns the original job, including after service updates; use a new key to request a fresh analysis.
Required string length: 1 - 128
Pattern: ^[!-~]+$
Body
application/json
Option 1
Option 2
file_id
string<uuid>
required
Opaque account-owned identifier.
operation
enum<string>
required
Available options:
identify
Response
Accepted background job.
job_id
string<uuid>
required
Opaque account-owned identifier.
operation
enum<string>
required
Available options:
identify,
inspect,
maps,
map-grid,
diff
status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
cancelled,
expired
message
string
required
expires_at
string<date-time> | null
required
created_at
string<date-time>
required
status_url
string
required
result
object
Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.
Option 1
Option 2
Option 3
Option 4
Option 5
Show child attributes
Example:
{ "operation": "inspect", "message": "ECU identification completed.", "identification": { "status": "identified", "confidence": { "level": "medium", "explanation": "Useful identification evidence was found, but confirmation is recommended." }, "manufacturer": "Bosch", "family": "MED9", "variant": "MED91", "byte_order": "big", "cell_width_bytes": 2 }, "layout": { "file_size_bytes": 2097152, "region_count": 9, "bytes_by_kind": { "code": 1310720, "calibration": 131072, "erased": 196608, "mixed": 458752, "unknown": 0 }, "identification_block_count": 1, "offsets": "Zero-based byte offsets; start inclusive, end exclusive.", "message": "Regions are heuristic classifications of file contents, not verified memory definitions." }, "condition": { "status": "review_recommended", "coverage": "partial", "message": "Some observations need review; they do not prove tuning or damage.", "checks": [ { "code": "embedded_erased_regions", "title": "Internal blank regions", "status": "review_recommended", "message": "Repeated-byte fill can be normal; it does not prove that maps were erased.", "evidence": { "erased_region_count": 2, "embedded_region_count": 1, "minimum_region_bytes": 16384, "interior_margin_bytes": 4096, "erased_bytes": 196608, "embedded_bytes": 131072 } }, { "code": "map_count_envelope", "title": "Map count", "status": "no_issues_detected", "message": "The expected range is a heuristic for high-score candidates in the health scan, separate from the layout-filtered map list.", "evidence": { "candidate_count": 118, "expected_min": 78, "expected_max": 196, "relation": "within" } }, { "code": "axis_plausibility", "title": "Axis plausibility", "status": "review_recommended", "message": "Counts cover high-score tables. Byte order and false candidates can explain warnings. Reliable per-axis locations are unavailable.", "evidence": { "table_count": 118, "flagged_axis_count": 21, "locations_available": false } }, { "code": "supported_checksums", "title": "Checksums", "status": "unavailable", "message": "Only detected, supported checksum checks are assessed; this does not establish whole-file validity.", "evidence": { "reason": "no_supported_scheme_detected" } } ] }, "checksums": { "status": "unknown", "reason": "no_supported_scheme_detected", "message": "No supported checksum scheme was detected; validity remains unknown." }, "maps": { "available": 701, "returned": 1, "omitted": 700, "message": "These are map candidates. Names, units and scaling are not established.", "axes_count": 3903, "excluded_by_layout": 22, "detected_before_layout": 723, "layout_filtered": true }, "notices": [ { "code": "embedded_erased_regions", "message": "Internal blank regions were found. They can be normal and do not prove erased maps." }, { "code": "axis_plausibility", "message": "Some candidate axes look unusual. Review their raw values and byte order." }, { "code": "partial_coverage", "message": "Some checks are unavailable for this file." }, { "code": "observation_only", "message": "These observations do not establish originality, tuning or flash safety." } ] }
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Remapdb Docs","colors":{"primary":"#31374A","light":"#ffffff","dark":"#ffffff"},"logo":{"light":"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-logo-small-full-light.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=43a8b24bbe8a0dbd37bf83eb53389324","dark":"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-logo-small-full-dark.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=f46eb40e1d7f5b94d72d19d2d42a13ef","href":"/"},"favicon":"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-favicon.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=0fcc7a0b57d48d4b33a6d3991596ef33","background":{"color":{"light":"#ffffff","dark":"#0F111A"}},"navbar":{"links":[{"href":"https://app.remapdb.com/support","label":"Get support"}],"primary":{"type":"button","label":"Get started","href":"https://app.remapdb.com/signup"}},"fonts":{"family":"Nunito Sans"},"icons":{"library":"lucide"},"contextual":{"options":["copy","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"thumbnails":{"appearance":"light","background":"https://mintlify.s3.us-west-1.amazonaws.com/remapdb/%23F5F7FB"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"remapdb","hasAudioNarration":false,"actualSubdomain":"remapdb","customDomains":["docs.remapdb.com"],"gitSource":{"type":"github","owner":"bitmeshltd","repo":"remapdb-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb1892eb13d58ceec02d70","clientVersion":"0.0.4160","searchFilterCounts":[{"language":"default","tag":"Documentation","count":59},{"language":"default","tag":"API reference","count":42},{"language":"default","tag":"API v2","count":29},{"language":"default","tag":"Widget","count":25},{"language":"default","tag":"ECU observation","count":12},{"language":"default","tag":"API","count":11},{"language":"default","tag":"Settings","count":11},{"language":"default","tag":"API v1 (deprecated)","count":11},{"language":"default","tag":"Quoting","count":8},{"language":"default","tag":"Branding","count":7}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"help/style.css","content":":root{--rdb-radius: .125rem;--rdb-nav-active-bg: #d2d7e1;--rdb-nav-active-fg: #2f3850;--rdb-nav-active-bg-dark: #343c53;--rdb-nav-active-fg-dark: #f3f6ff;--rdb-gray-900: #31374A;--rdb-gray-200: #E3E6ED;--rdb-gray-300: #CBD0DD;--rdb-gray-500: #8A94AD}.rounded-sm,.callout{border-radius:var(--rdb-radius)!important}#navbar nav ul li>a,#navbar nav ul li>button,#navbar .navbar-link>a,#sidebar-content a,#sidebar-content button,#navigation-items a,#navigation-items button,#search-bar-entry,#assistant-entry,#search-bar-entry-mobile,#assistant-entry-mobile,#topbar-cta-button>a,#topbar-cta-button>a>span,#page-context-menu,#page-context-menu>button,#page-context-menu>div,#page-context-menu>div>button,#pagination>a{border-radius:var(--rdb-radius)!important}[data-component-name=\"theme-toggle\"],[data-component-name=\"theme-toggle\"]:hover{border-radius:var(--rdb-radius)!important}#sidebar-content .sidebar-group-header,#sidebar-content .sidebar-group-header h5{font-size:14px!important;font-weight:400!important}.dark #sidebar-content .sidebar-group-header,.dark #sidebar-content .sidebar-group-header h5{color:var(--rdb-gray-500)!important}#navigation-items li[data-active=\"true\"]>a,#sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg)!important;color:var(--rdb-nav-active-fg)!important;font-weight:700!important;border-radius:var(--rdb-radius)!important}#navigation-items li[data-active=\"true\"]>a :is(span,svg),#sidebar-content li[data-active=\"true\"]>a :is(span,svg){color:var(--rdb-nav-active-fg)!important}.dark #content-area{color:var(--rdb-gray-300)!important}.dark #navigation-items li[data-active=\"true\"]>a,.dark #sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg-dark)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-active=\"true\"]>a :is(span,svg),.dark #sidebar-content li[data-active=\"true\"]>a :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li:not([data-active=\"true\"])>a,.dark #navigation-items li:not([data-active=\"true\"])>button,.dark #sidebar-content li:not([data-active=\"true\"])>a,.dark #sidebar-content li:not([data-active=\"true\"])>button{color:var(--rdb-gray-500)!important}.dark #navigation-items li:not([data-active=\"true\"])>a :is(span,svg),.dark #navigation-items li:not([data-active=\"true\"])>button :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>a :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>button :is(span,svg){color:var(--rdb-gray-500)!important}.dark #navigation-items li[data-group-tag]>button:hover,.dark #sidebar-content li[data-group-tag]>button:hover{background:color-mix(in srgb, var(--rdb-nav-active-bg-dark) 40%, transparent)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag]>button:hover :is(div,svg),.dark #sidebar-content li[data-group-tag]>button:hover :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button,.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button{background:transparent!important;color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button :is(div,svg),.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover,.dark #navigation-items button:hover,.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover :is(span,svg),.dark #navigation-items button:hover :is(span,svg),.dark #sidebar-content a:hover :is(span,svg),.dark #sidebar-content button:hover :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents-content a{color:var(--rdb-gray-500)!important}#table-of-contents-content li.active>a,#table-of-contents-content li[data-active=\"true\"]>a,#table-of-contents-content a[aria-current=\"true\"],#table-of-contents-content a[aria-current=\"location\"],#table-of-contents-content a[aria-current=\"page\"]{font-weight:600!important}.dark #table-of-contents-content li.active>a,.dark #table-of-contents-content li[data-active=\"true\"]>a,.dark #table-of-contents-content a[aria-current=\"true\"],.dark #table-of-contents-content a[aria-current=\"location\"],.dark #table-of-contents-content a[aria-current=\"page\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #table-of-contents-content li.active::before,.dark #table-of-contents-content li[data-active=\"true\"]::before{background-color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents a[class*=\"text-primary\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important}.dark #content-area .eyebrow{color:var(--rdb-nav-active-fg-dark)!important}.dark [data-component-part=\"card-title\"],.dark [data-component-part=\"card-content\"]{color:var(--rdb-gray-300)!important}.dark [data-component-part=\"card-icon\"]>svg,.dark #card-link-arrow-icon{color:var(--rdb-gray-300)!important;background-color:var(--rdb-gray-300)!important}#navbar nav ul li>a.link{font-weight:700!important}#topbar-cta-button>a{font-weight:700!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{border-radius:var(--rdb-radius)!important;border:2px solid var(--rdb-gray-900)!important;font-weight:700!important;text-decoration:none!important;background:transparent!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important;background:color-mix(in srgb, var(--rdb-gray-900) 15%, transparent)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{color:var(--rdb-gray-300)!important;border-color:var(--rdb-gray-300)!important}.dark #topbar-cta-button>a{background:var(--rdb-nav-active-bg-dark)!important}.dark #topbar-cta-button>a span{color:var(--rdb-nav-active-fg-dark)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,.dark #navbar nav a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-200)!important;color:var(--rdb-gray-200)!important;background:color-mix(in srgb, var(--rdb-gray-300) 25%, transparent)!important}"},{"filePath":"style.css","content":":root{--rdb-radius: .125rem;--rdb-nav-active-bg: #d2d7e1;--rdb-nav-active-fg: #2f3850;--rdb-nav-active-bg-dark: #343c53;--rdb-nav-active-fg-dark: #f3f6ff;--rdb-gray-900: #31374A;--rdb-gray-200: #E3E6ED;--rdb-gray-300: #CBD0DD;--rdb-gray-500: #8A94AD;--rdb-gray-900: #31374a;--rdb-cyan-50: #f0faff;--rdb-cyan-500: #0097eb;--rdb-cyan-1000: #072b3a}.rounded-sm,.callout{border-radius:var(--rdb-radius)!important}.callout[data-callout-type=\"info\"]{border:1px solid var(--rdb-cyan-500)!important;background:var(--rdb-cyan-50)!important;color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(p,span,strong,em,li,code){color:inherit!important}.callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.dark .callout[data-callout-type=\"info\"]{border-color:var(--rdb-cyan-500)!important;background:var(--rdb-cyan-1000)!important;color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.code-block,[data-component-part=\"code-block-root\"]{border-radius:var(--rdb-radius)!important}#navbar nav ul li>a,#navbar nav ul li>button,#navbar .navbar-link>a,#sidebar-content a,#sidebar-content button,#navigation-items a,#navigation-items button,#search-bar-entry,#assistant-entry,#search-bar-entry-mobile,#assistant-entry-mobile,#topbar-cta-button>a,#topbar-cta-button>a>span,#page-context-menu,#page-context-menu>button,#page-context-menu>div,#page-context-menu>div>button,#pagination>a{border-radius:var(--rdb-radius)!important}[data-component-name=\"theme-toggle\"],[data-component-name=\"theme-toggle\"]:hover{border-radius:var(--rdb-radius)!important}#sidebar-content .sidebar-group-header,#sidebar-content .sidebar-group-header h5{font-size:14px!important;font-weight:400!important}.dark #sidebar-content .sidebar-group-header,.dark #sidebar-content .sidebar-group-header h5{color:var(--rdb-gray-500)!important}#navigation-items li[data-active=\"true\"]>a,#sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg)!important;color:var(--rdb-nav-active-fg)!important;font-weight:700!important;border-radius:var(--rdb-radius)!important}#navigation-items li[data-active=\"true\"]>a>div:last-child,#navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),#sidebar-content li[data-active=\"true\"]>a>div:last-child,#sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg)!important}#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child),#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div){color:#fff!important}.dark #content-area{color:var(--rdb-gray-300)!important}.dark #navigation-items li[data-active=\"true\"]>a,.dark #sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg-dark)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-active=\"true\"]>a>div:last-child,.dark #navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child,.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li:not([data-active=\"true\"])>a,.dark #navigation-items li:not([data-active=\"true\"])>button,.dark #sidebar-content li:not([data-active=\"true\"])>a,.dark #sidebar-content li:not([data-active=\"true\"])>button{color:var(--rdb-gray-500)!important}.dark #navigation-items li:not([data-active=\"true\"])>a :is(span,svg),.dark #navigation-items li:not([data-active=\"true\"])>button :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>a :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>button :is(span,svg){color:var(--rdb-gray-500)!important}.dark #navigation-items li[data-group-tag]>button:hover,.dark #sidebar-content li[data-group-tag]>button:hover{background:color-mix(in srgb, var(--rdb-nav-active-bg-dark) 40%, transparent)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag]>button:hover :is(div,svg),.dark #sidebar-content li[data-group-tag]>button:hover :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button,.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button{background:transparent!important;color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button :is(div,svg),.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover,.dark #navigation-items button:hover,.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover :is(span,svg),.dark #navigation-items button:hover :is(span,svg),.dark #sidebar-content a:hover :is(span,svg),.dark #sidebar-content button:hover :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents-content a{color:var(--rdb-gray-500)!important}#table-of-contents-content li.active>a,#table-of-contents-content li[data-active=\"true\"]>a,#table-of-contents-content a[aria-current=\"true\"],#table-of-contents-content a[aria-current=\"location\"],#table-of-contents-content a[aria-current=\"page\"]{font-weight:600!important}.dark #table-of-contents-content li.active>a,.dark #table-of-contents-content li[data-active=\"true\"]>a,.dark #table-of-contents-content a[aria-current=\"true\"],.dark #table-of-contents-content a[aria-current=\"location\"],.dark #table-of-contents-content a[aria-current=\"page\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #table-of-contents-content li.active::before,.dark #table-of-contents-content li[data-active=\"true\"]::before{background-color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents a[class*=\"text-primary\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important}.dark #content-area .eyebrow{color:var(--rdb-nav-active-fg-dark)!important}.dark [data-component-part=\"card-title\"],.dark [data-component-part=\"card-content\"]{color:var(--rdb-gray-300)!important}.dark [data-component-part=\"card-icon\"]>svg,.dark #card-link-arrow-icon{color:var(--rdb-gray-300)!important;background-color:var(--rdb-gray-300)!important}#navbar nav ul li>a.link{font-weight:700!important}#topbar-cta-button>a{font-weight:700!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{border-radius:var(--rdb-radius)!important;border:2px solid var(--rdb-gray-900)!important;font-weight:700!important;text-decoration:none!important;background:transparent!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important;background:color-mix(in srgb, var(--rdb-gray-900) 15%, transparent)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{color:var(--rdb-gray-300)!important;border-color:var(--rdb-gray-300)!important}.dark #topbar-cta-button>a{background:var(--rdb-nav-active-bg-dark)!important}.dark #topbar-cta-button>a span{color:var(--rdb-nav-active-fg-dark)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,.dark #navbar nav a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-200)!important;color:var(--rdb-gray-200)!important;background:color-mix(in srgb, var(--rdb-gray-300) 25%, transparent)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input,.dark #content-area [id^=\"api-playground-\"] .text-playground-input{color:var(--rdb-gray-300)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input::placeholder,.dark [data-testid=\"api-playground-modal\"] input.text-playground-input::-webkit-input-placeholder,.dark [data-testid=\"api-playground-modal\"] textarea.text-playground-input::-webkit-input-placeholder,.dark #content-area [id^=\"api-playground-\"] .text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] input.text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] textarea.text-playground-input::placeholder{color:var(--rdb-gray-300)!important;opacity:1!important}.dark [data-testid=\"api-playground-modal\"] select.text-playground-input,.dark #content-area [id^=\"api-playground-\"] select.text-playground-input{color:var(--rdb-gray-300)!important}.dark #content-area [id^=\"api-playground-\"] .text-primary,.dark #content-area [id^=\"api-playground-\"] .dark\\\\:text-primary-light,.dark #content-area [id^=\"response-\"] .text-primary,.dark #content-area [id^=\"response-\"] .dark\\\\:text-primary-light,.dark #content-area .param-head .text-primary,.dark #content-area .param-head .dark\\\\:text-primary-light{color:var(--rdb-nav-active-fg-dark)!important}.plan-comparison-tables table{table-layout:fixed}.plan-comparison-tables table :is(th,td){min-width:0;overflow-wrap:anywhere}.plan-comparison-tables table th:first-child{width:34%}"},{"filePath":"docs/style.css","content":":root{--rdb-radius: .125rem;--rdb-nav-active-bg: #d2d7e1;--rdb-nav-active-fg: #2f3850;--rdb-nav-active-bg-dark: #343c53;--rdb-nav-active-fg-dark: #f3f6ff;--rdb-gray-900: #31374A;--rdb-gray-200: #E3E6ED;--rdb-gray-300: #CBD0DD;--rdb-gray-500: #8A94AD;--rdb-gray-900: #31374a;--rdb-cyan-50: #f0faff;--rdb-cyan-500: #0097eb;--rdb-cyan-1000: #072b3a}.rounded-sm,.callout{border-radius:var(--rdb-radius)!important}.callout[data-callout-type=\"info\"]{border:1px solid var(--rdb-cyan-500)!important;background:var(--rdb-cyan-50)!important;color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(p,span,strong,em,li,code){color:inherit!important}.callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-900)!important}.callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.dark .callout[data-callout-type=\"info\"]{border-color:var(--rdb-cyan-500)!important;background:var(--rdb-cyan-1000)!important;color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] a{color:var(--rdb-gray-300)!important}.dark .callout[data-callout-type=\"info\"] :is(svg,.material-symbols-outlined,[data-icon]){color:var(--rdb-cyan-500)!important}.code-block,[data-component-part=\"code-block-root\"]{border-radius:var(--rdb-radius)!important}#navbar nav ul li>a,#navbar nav ul li>button,#navbar .navbar-link>a,#sidebar-content a,#sidebar-content button,#navigation-items a,#navigation-items button,#search-bar-entry,#assistant-entry,#search-bar-entry-mobile,#assistant-entry-mobile,#topbar-cta-button>a,#topbar-cta-button>a>span,#page-context-menu,#page-context-menu>button,#page-context-menu>div,#page-context-menu>div>button,#pagination>a{border-radius:var(--rdb-radius)!important}[data-component-name=\"theme-toggle\"],[data-component-name=\"theme-toggle\"]:hover{border-radius:var(--rdb-radius)!important}#sidebar-content .sidebar-group-header,#sidebar-content .sidebar-group-header h5{font-size:14px!important;font-weight:400!important}.dark #sidebar-content .sidebar-group-header,.dark #sidebar-content .sidebar-group-header h5{color:var(--rdb-gray-500)!important}#navigation-items li[data-active=\"true\"]>a,#sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg)!important;color:var(--rdb-nav-active-fg)!important;font-weight:700!important;border-radius:var(--rdb-radius)!important}#navigation-items li[data-active=\"true\"]>a>div:last-child,#navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),#sidebar-content li[data-active=\"true\"]>a>div:last-child,#sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg)!important}#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child),#navigation-items li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child),#sidebar-content li[data-active=\"true\"]>a>div:first-child:not(:last-child) :is(span,div){color:#fff!important}.dark #content-area{color:var(--rdb-gray-300)!important}.dark #navigation-items li[data-active=\"true\"]>a,.dark #sidebar-content li[data-active=\"true\"]>a{background:var(--rdb-nav-active-bg-dark)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-active=\"true\"]>a>div:last-child,.dark #navigation-items li[data-active=\"true\"]>a>div:last-child :is(span,svg),.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child,.dark #sidebar-content li[data-active=\"true\"]>a>div:last-child :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li:not([data-active=\"true\"])>a,.dark #navigation-items li:not([data-active=\"true\"])>button,.dark #sidebar-content li:not([data-active=\"true\"])>a,.dark #sidebar-content li:not([data-active=\"true\"])>button{color:var(--rdb-gray-500)!important}.dark #navigation-items li:not([data-active=\"true\"])>a :is(span,svg),.dark #navigation-items li:not([data-active=\"true\"])>button :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>a :is(span,svg),.dark #sidebar-content li:not([data-active=\"true\"])>button :is(span,svg){color:var(--rdb-gray-500)!important}.dark #navigation-items li[data-group-tag]>button:hover,.dark #sidebar-content li[data-group-tag]>button:hover{background:color-mix(in srgb, var(--rdb-nav-active-bg-dark) 40%, transparent)!important;color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag]>button:hover :is(div,svg),.dark #sidebar-content li[data-group-tag]>button:hover :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button,.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button{background:transparent!important;color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #navigation-items li[data-group-tag][data-active=\"true\"]>button :is(div,svg),.dark #sidebar-content li[data-group-tag][data-active=\"true\"]>button :is(div,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover,.dark #navigation-items button:hover,.dark #sidebar-content a:hover,.dark #sidebar-content button:hover{color:var(--rdb-nav-active-fg-dark)!important}.dark #navigation-items a:hover :is(span,svg),.dark #navigation-items button:hover :is(span,svg),.dark #sidebar-content a:hover :is(span,svg),.dark #sidebar-content button:hover :is(span,svg){color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents-content a{color:var(--rdb-gray-500)!important}#table-of-contents-content li.active>a,#table-of-contents-content li[data-active=\"true\"]>a,#table-of-contents-content a[aria-current=\"true\"],#table-of-contents-content a[aria-current=\"location\"],#table-of-contents-content a[aria-current=\"page\"]{font-weight:600!important}.dark #table-of-contents-content li.active>a,.dark #table-of-contents-content li[data-active=\"true\"]>a,.dark #table-of-contents-content a[aria-current=\"true\"],.dark #table-of-contents-content a[aria-current=\"location\"],.dark #table-of-contents-content a[aria-current=\"page\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important;font-weight:600!important}.dark #table-of-contents-content li.active::before,.dark #table-of-contents-content li[data-active=\"true\"]::before{background-color:var(--rdb-nav-active-fg-dark)!important}.dark #table-of-contents a[class*=\"text-primary\"],.dark #table-of-contents-content a[class*=\"text-primary\"]{color:var(--rdb-nav-active-fg-dark)!important}.dark #content-area .eyebrow{color:var(--rdb-nav-active-fg-dark)!important}.dark [data-component-part=\"card-title\"],.dark [data-component-part=\"card-content\"]{color:var(--rdb-gray-300)!important}.dark [data-component-part=\"card-icon\"]>svg,.dark #card-link-arrow-icon{color:var(--rdb-gray-300)!important;background-color:var(--rdb-gray-300)!important}#navbar nav ul li>a.link{font-weight:700!important}#topbar-cta-button>a{font-weight:700!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{border-radius:var(--rdb-radius)!important;border:2px solid var(--rdb-gray-900)!important;font-weight:700!important;text-decoration:none!important;background:transparent!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important}#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,#navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-900)!important;color:var(--rdb-gray-900)!important;background:color-mix(in srgb, var(--rdb-gray-900) 15%, transparent)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]{color:var(--rdb-gray-300)!important;border-color:var(--rdb-gray-300)!important}.dark #topbar-cta-button>a{background:var(--rdb-nav-active-bg-dark)!important}.dark #topbar-cta-button>a span{color:var(--rdb-nav-active-fg-dark)!important}.dark #navbar .topbar-right-container li.navbar-link>a[href*=\"/support\"]:hover,.dark #navbar nav a[href*=\"/support\"]:focus-visible{border-width:2px!important;border-color:var(--rdb-gray-200)!important;color:var(--rdb-gray-200)!important;background:color-mix(in srgb, var(--rdb-gray-300) 25%, transparent)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input,.dark #content-area [id^=\"api-playground-\"] .text-playground-input{color:var(--rdb-gray-300)!important}.dark [data-testid=\"api-playground-modal\"] .text-playground-input::placeholder,.dark [data-testid=\"api-playground-modal\"] input.text-playground-input::-webkit-input-placeholder,.dark [data-testid=\"api-playground-modal\"] textarea.text-playground-input::-webkit-input-placeholder,.dark #content-area [id^=\"api-playground-\"] .text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] input.text-playground-input::placeholder,.dark #content-area [id^=\"api-playground-\"] textarea.text-playground-input::placeholder{color:var(--rdb-gray-300)!important;opacity:1!important}.dark [data-testid=\"api-playground-modal\"] select.text-playground-input,.dark #content-area [id^=\"api-playground-\"] select.text-playground-input{color:var(--rdb-gray-300)!important}.dark #content-area [id^=\"api-playground-\"] .text-primary,.dark #content-area [id^=\"api-playground-\"] .dark\\\\:text-primary-light,.dark #content-area [id^=\"response-\"] .text-primary,.dark #content-area [id^=\"response-\"] .dark\\\\:text-primary-light,.dark #content-area .param-head .text-primary,.dark #content-area .param-head .dark\\\\:text-primary-light{color:var(--rdb-nav-active-fg-dark)!important}.plan-comparison-tables table{table-layout:fixed}.plan-comparison-tables table :is(th,td){min-width:0;overflow-wrap:anywhere}.plan-comparison-tables table th:first-child{width:34%}"}],"page":{"pagePath":"api-reference/v2/ecu-observation/analyze-an-ecu-binary","slug":"/api-reference/v2/ecu-observation/analyze-an-ecu-binary","pageMetadata":{"title":"Analyze an ECU binary","description":"Included with active API and MAX subscriptions. Use a standard API key with `vdb_read`, or a restricted key with `ecu_observe`. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the `/v2/ecu/` prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/analyses","href":"/api-reference/v2/ecu-observation/analyze-an-ecu-binary","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Included with active API and MAX subscriptions. Use a standard API key with \", _jsx(_components.code, {\n children: \"vdb_read\"\n }), \", or a restricted key with \", _jsx(_components.code, {\n children: \"ecu_observe\"\n }), \". No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the \", _jsx(_components.code, {\n children: \"/v2/ecu/\"\n }), \" prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Analyze an ECU binary","description":"Included with active API and MAX subscriptions. Use a standard API key with `vdb_read`, or a restricted key with `ecu_observe`. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the `/v2/ecu/` prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/analyses","href":"/api-reference/v2/ecu-observation/analyze-an-ecu-binary","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["ECU observation"],"summary":"Analyze an ECU binary","operationId":"ecu_analyze","description":"Included with active API and MAX subscriptions. Use a standard API key with `vdb_read`, or a restricted key with `ecu_observe`. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the `/v2/ecu/` prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.","security":["ee60e6a8-e51f-4018-8e1e-5bba98a9a7f5"],"responses":{"202":"89cad07a-28ef-4173-aafc-5e749ee3d4c8","400":"b6057272-4279-4d40-9de8-60f5a864060f","401":"74294b11-4678-494e-bf78-b3c664d1db9b","403":"a0081724-b814-4ed8-8e92-8fd079aa4ee5","404":"961261b1-fa94-4c2f-b557-2e249ed8229e","405":"a957390e-3a48-4e5a-9c97-57336d434e90","409":"814dbd96-ea0d-44e4-98f0-04d86447bbb4","410":"e9b555b5-035c-4817-8a60-f2511409064f","413":"35e6b6ec-0bcc-4cdd-b0c8-32f92ab68809","415":"4054a7dc-00e8-423c-ad80-07911d962877","429":"1a4d47f9-fbc6-402f-850c-3e7f11837190","503":"0036153a-8698-40e2-93cd-adffb21cb634"},"parameters":["0364a5e9-3a09-4a98-8037-5b8256190e0d"],"requestBody":"cdecdeeb-1f8b-4642-a830-11a2bf184caa","method":"post","type":"path","servers":["1b9735ae-e90d-461d-9f84-c56b8a46a2ef"],"path":"/ecu/analyses","baseUrlOptions":["https://api.remapdb.com/v2"],"title":"Analyze an ECU binary","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"0364a5e9-3a09-4a98-8037-5b8256190e0d":{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":128,"pattern":"^[!-~]+$","isRequired":true,"description":"Reuse this key only for retries of the same operation and parameters. Keys are scoped to the account. A retry returns the original job, including after service updates; use a new key to request a fresh analysis.","uniqueKey":"","typeLabel":"string"},"description":"Reuse this key only for retries of the same operation and parameters. Keys are scoped to the account. A retry returns the original job, including after service updates; use a new key to request a fresh analysis."}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["file_id","operation"],"properties":{"file_id":{"type":"string","format":"uuid","description":"Opaque account-owned identifier.","isRequired":true,"uniqueKey":"oneOf.0.file_id","typeLabel":"string\u003cuuid>"},"operation":{"type":"string","enum":["identify"],"isRequired":true,"uniqueKey":"oneOf.0.operation","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["file_id","operation"],"properties":{"file_id":{"type":"string","format":"uuid","description":"Opaque account-owned identifier.","isRequired":true,"uniqueKey":"oneOf.1.file_id","typeLabel":"string\u003cuuid>"},"operation":{"type":"string","enum":["inspect"],"isRequired":true,"uniqueKey":"oneOf.1.operation","typeLabel":"enum\u003cstring>"},"limit":{"type":"integer","minimum":1,"maximum":200,"default":20,"description":"Default map-detail page size (1–200, default 20). New map/inspection jobs retain all detected candidates. Read additional pages from GET /ecu/jobs/{job_id}/details using offset and limit without rerunning analysis.","uniqueKey":"oneOf.1.limit","typeLabel":"integer"}},"additionalProperties":false,"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"file_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","operation":"identify"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"89cad07a-28ef-4173-aafc-5e749ee3d4c8":{"description":"Accepted background job.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"job_id":{"type":"string","format":"uuid","description":"Opaque account-owned identifier.","isRequired":true,"uniqueKey":"job_id","typeLabel":"string\u003cuuid>"},"operation":{"type":"string","enum":["identify","inspect","maps","map-grid","diff"],"isRequired":true,"uniqueKey":"operation","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["queued","running","completed","failed","cancelled","expired"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"expires_at":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"expires_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"expires_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"expires_at","typeLabel":"string\u003cdate-time> | null"},"created_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"created_at","typeLabel":"string\u003cdate-time>"},"status_url":{"type":"string","isRequired":true,"uniqueKey":"status_url","typeLabel":"string"},"result":{"oneOf":[{"type":"object","description":"Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.","required":["operation","message","notices","identification"],"example":{"operation":"inspect","message":"ECU identification completed.","identification":{"status":"identified","confidence":{"level":"medium","explanation":"Useful identification evidence was found, but confirmation is recommended."},"manufacturer":"Bosch","family":"MED9","variant":"MED91","byte_order":"big","cell_width_bytes":2},"layout":{"file_size_bytes":2097152,"region_count":9,"bytes_by_kind":{"code":1310720,"calibration":131072,"erased":196608,"mixed":458752,"unknown":0},"identification_block_count":1,"offsets":"Zero-based byte offsets; start inclusive, end exclusive.","message":"Regions are heuristic classifications of file contents, not verified memory definitions."},"condition":{"status":"review_recommended","coverage":"partial","message":"Some observations need review; they do not prove tuning or damage.","checks":[{"code":"embedded_erased_regions","title":"Internal blank regions","status":"review_recommended","message":"Repeated-byte fill can be normal; it does not prove that maps were erased.","evidence":{"erased_region_count":2,"embedded_region_count":1,"minimum_region_bytes":16384,"interior_margin_bytes":4096,"erased_bytes":196608,"embedded_bytes":131072}},{"code":"map_count_envelope","title":"Map count","status":"no_issues_detected","message":"The expected range is a heuristic for high-score candidates in the health scan, separate from the layout-filtered map list.","evidence":{"candidate_count":118,"expected_min":78,"expected_max":196,"relation":"within"}},{"code":"axis_plausibility","title":"Axis plausibility","status":"review_recommended","message":"Counts cover high-score tables. Byte order and false candidates can explain warnings. Reliable per-axis locations are unavailable.","evidence":{"table_count":118,"flagged_axis_count":21,"locations_available":false}},{"code":"supported_checksums","title":"Checksums","status":"unavailable","message":"Only detected, supported checksum checks are assessed; this does not establish whole-file validity.","evidence":{"reason":"no_supported_scheme_detected"}}]},"checksums":{"status":"unknown","reason":"no_supported_scheme_detected","message":"No supported checksum scheme was detected; validity remains unknown."},"maps":{"available":701,"returned":1,"omitted":700,"message":"These are map candidates. Names, units and scaling are not established.","axes_count":3903,"excluded_by_layout":22,"detected_before_layout":723,"layout_filtered":true},"notices":[{"code":"embedded_erased_regions","message":"Internal blank regions were found. They can be normal and do not prove erased maps."},{"code":"axis_plausibility","message":"Some candidate axes look unusual. Review their raw values and byte order."},{"code":"partial_coverage","message":"Some checks are unavailable for this file."},{"code":"observation_only","message":"These observations do not establish originality, tuning or flash safety."}]},"properties":{"operation":{"type":"string","enum":["identify"],"isRequired":true,"uniqueKey":"result.oneOf.0.operation","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.message","typeLabel":"string"},"identification":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["identified","review_required","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.0.identification.status","typeLabel":"enum\u003cstring>"},"confidence":{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["high","medium","low","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.0.identification.confidence.level","typeLabel":"enum\u003cstring>"},"explanation":{"type":"string","description":"Short evidence explanation. This is not a probability or flashing-safety assessment.","isRequired":true,"uniqueKey":"result.oneOf.0.identification.confidence.explanation","typeLabel":"string"}},"required":["level","explanation"],"isRequired":true,"uniqueKey":"result.oneOf.0.identification.confidence","typeLabel":"object"},"manufacturer":{"type":"string","description":"ECU manufacturer, when established.","uniqueKey":"result.oneOf.0.identification.manufacturer","typeLabel":"string"},"family":{"type":"string","description":"ECU family, when established.","uniqueKey":"result.oneOf.0.identification.family","typeLabel":"string"},"variant":{"type":"string","description":"Specific ECU variant or model; not the vehicle model.","uniqueKey":"result.oneOf.0.identification.variant","typeLabel":"string"},"software":{"type":"string","description":"Software identifier or version extracted from supported evidence.","uniqueKey":"result.oneOf.0.identification.software","typeLabel":"string"},"hardware":{"type":"string","description":"Hardware identifier or number extracted from supported evidence.","uniqueKey":"result.oneOf.0.identification.hardware","typeLabel":"string"},"calibration_id":{"type":"string","description":"Supported calibration identifier, when established.","uniqueKey":"result.oneOf.0.identification.calibration_id","typeLabel":"string"},"part_number":{"type":"string","description":"Supported OEM part number, when established.","uniqueKey":"result.oneOf.0.identification.part_number","typeLabel":"string"},"byte_order":{"type":"string","enum":["big","little"],"description":"Detected ECU byte order, when established for an accepted identity.","uniqueKey":"result.oneOf.0.identification.byte_order","typeLabel":"enum\u003cstring>"},"cell_width_bytes":{"type":"integer","enum":[1,2,4],"description":"Detected ECU cell width; individual candidate descriptors can use another width.","uniqueKey":"result.oneOf.0.identification.cell_width_bytes","typeLabel":"enum\u003cinteger>"}},"required":["status","confidence"],"isRequired":true,"uniqueKey":"result.oneOf.0.identification","typeLabel":"object"},"notices":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.notices.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.notices.items.[INDEX].message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"result.oneOf.0.notices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.oneOf.0.notices","typeLabel":"object[]"},"condition":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["review_recommended","no_issues_detected","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.0.condition.status","typeLabel":"enum\u003cstring>"},"coverage":{"type":"string","enum":["complete","partial","unavailable"],"description":"complete means all listed supported checks were evaluated; it does not mean every possible ECU check is supported.","isRequired":true,"uniqueKey":"result.oneOf.0.condition.coverage","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.condition.message","typeLabel":"string"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","enum":["embedded_erased_regions","map_count_envelope","axis_plausibility","supported_checksums"],"isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].title","typeLabel":"string"},"status":{"type":"string","enum":["no_issues_detected","review_recommended","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].message","typeLabel":"string"},"evidence":{"type":"object","additionalProperties":false,"properties":{"erased_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.erased_region_count","typeLabel":"integer"},"embedded_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.embedded_region_count","typeLabel":"integer"},"erased_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.erased_bytes","typeLabel":"integer"},"embedded_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.embedded_bytes","typeLabel":"integer"},"minimum_region_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.minimum_region_bytes","typeLabel":"integer"},"interior_margin_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.interior_margin_bytes","typeLabel":"integer"},"candidate_count":{"type":"integer","minimum":0,"description":"High-score health-scan candidates, distinct from maps.available. Expected min/max are a heuristic, not verified map counts.","uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.candidate_count","typeLabel":"integer"},"expected_min":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.expected_min","typeLabel":"integer"},"expected_max":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.expected_max","typeLabel":"integer"},"table_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.table_count","typeLabel":"integer"},"checked_axis_count":{"type":"integer","minimum":0,"description":"Present only when the engine reports the checked total. A warning may report flagged_axis_count without this total.","uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.checked_axis_count","typeLabel":"integer"},"flagged_axis_count":{"type":"integer","minimum":0,"description":"Suspicious axes across table_count high-score tables. Does not imply every detected axis was checked.","uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.flagged_axis_count","typeLabel":"integer"},"relation":{"type":"string","enum":["below","within","above"],"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.relation","typeLabel":"enum\u003cstring>"},"locations_available":{"type":"boolean","enum":[false],"description":"Reliable locations of suspicious axes are unavailable; no affected-axis addresses are inferred.","uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.locations_available","typeLabel":"enum\u003cboolean>"},"reason":{"type":"string","enum":["unknown_family","no_family_envelope","no_high_score_tables","supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.reason","typeLabel":"enum\u003cstring>"},"regions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"start":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].start","typeLabel":"integer"},"end":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].end","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].size_bytes","typeLabel":"integer"},"high_score_candidate_count":{"type":"integer","minimum":0,"description":"High-score candidates used by layout classification; separate from the paginated discovery list.","uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].high_score_candidate_count","typeLabel":"integer"},"fill_byte":{"oneOf":[{"type":"integer","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte","typeLabel":"integer | null"},"fill_ratio":{"type":"number","minimum":0,"maximum":1,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_ratio","typeLabel":"number"}},"required":["kind","start","end","size_bytes"],"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions.items.[INDEX]","typeLabel":"object"},"maxItems":200,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence.regions","typeLabel":"object[]"}},"description":"Only measured fields applicable to the check are present. Internal erased-region locations appear in details when saved layout evidence is available.","isRequired":true,"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX].evidence","typeLabel":"object"}},"required":["code","title","status","message","evidence"],"uniqueKey":"result.oneOf.0.condition.checks.items.[INDEX]","typeLabel":"object"},"maxItems":4,"uniqueKey":"result.oneOf.0.condition.checks","typeLabel":"object[]"}},"required":["status","coverage","message"],"uniqueKey":"result.oneOf.0.condition","typeLabel":"object"},"checksums":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["passed","failed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.0.checksums.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.checksums.message","typeLabel":"string"},"reason":{"type":"string","enum":["supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.0.checksums.reason","typeLabel":"enum\u003cstring>"}},"required":["status","message"],"uniqueKey":"result.oneOf.0.checksums","typeLabel":"object"},"maps":{"type":"object","additionalProperties":false,"properties":{"available":{"type":"integer","minimum":0,"description":"Total detected candidates in this scan; not a count of verified calibration maps.","isRequired":true,"uniqueKey":"result.oneOf.0.maps.available","typeLabel":"integer"},"returned":{"type":"integer","minimum":0,"maximum":200,"description":"Candidates on this details page, or in the default page for a compact report.","isRequired":true,"uniqueKey":"result.oneOf.0.maps.returned","typeLabel":"integer"},"omitted":{"type":"integer","minimum":0,"description":"Available minus returned: candidates outside this page, including earlier pages. Follow pagination.next_offset rather than omitted to find the next page.","isRequired":true,"uniqueKey":"result.oneOf.0.maps.omitted","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.maps.message","typeLabel":"string"},"axes_count":{"type":"integer","minimum":0,"description":"Detected axes before layout filtering; not the number assessed by axis plausibility.","uniqueKey":"result.oneOf.0.maps.axes_count","typeLabel":"integer"},"detected_before_layout":{"type":"integer","minimum":0,"description":"All structural candidates before layout filtering; equals available + excluded_by_layout.","uniqueKey":"result.oneOf.0.maps.detected_before_layout","typeLabel":"integer"},"excluded_by_layout":{"type":"integer","minimum":0,"description":"Candidates excluded by layout filtering; separate from pagination omission.","uniqueKey":"result.oneOf.0.maps.excluded_by_layout","typeLabel":"integer"},"layout_filtered":{"type":"boolean","uniqueKey":"result.oneOf.0.maps.layout_filtered","typeLabel":"boolean"},"artifact":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["remapdb.ecu.maps.v1"],"isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.schema_version","typeLabel":"enum\u003cstring>"},"download_url":{"type":"string","description":"Stable authenticated API endpoint. Returns a 302 redirect to a fresh signed storage URL. Never send your API token to the redirect destination.","isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.download_url","typeLabel":"string"},"media_type":{"type":"string","enum":["application/json"],"isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.media_type","typeLabel":"enum\u003cstring>"},"content_encoding":{"type":"string","enum":["gzip"],"isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.content_encoding","typeLabel":"enum\u003cstring>"},"map_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.map_count","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"maximum":16777216,"description":"Exact decoded UTF-8 JSON bytes, after HTTP gzip decompression.","isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.size_bytes","typeLabel":"integer"},"compressed_size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.compressed_size_bytes","typeLabel":"integer"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the decoded JSON bytes, not the gzip container.","isRequired":true,"uniqueKey":"result.oneOf.0.maps.artifact.sha256","typeLabel":"string"}},"required":["schema_version","download_url","media_type","content_encoding","map_count","size_bytes","compressed_size_bytes","sha256"],"description":"Immutable public map artifact generated once by the worker, retained until the parent job expires. Missing on older jobs. Contains descriptors, not all grid cell values.","uniqueKey":"result.oneOf.0.maps.artifact","typeLabel":"object"}},"required":["available","returned","omitted","message"],"uniqueKey":"result.oneOf.0.maps","typeLabel":"object"},"comparison":{"type":"object","additionalProperties":false,"properties":{"identical":{"type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.0.comparison.identical","typeLabel":"boolean"},"changed_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.changed_bytes","typeLabel":"integer"},"changed_overlap_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.changed_overlap_bytes","typeLabel":"integer"},"reference_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.reference_tail_bytes","typeLabel":"integer"},"comparison_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.comparison_tail_bytes","typeLabel":"integer"},"changed_map_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.changed_map_candidates","typeLabel":"integer"},"unmatched_reference_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.unmatched_reference_candidates","typeLabel":"integer"},"unmatched_comparison_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.comparison.unmatched_comparison_candidates","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.comparison.message","typeLabel":"string"},"realigned_map_candidates":{"type":"integer","minimum":0,"description":"Candidate matches whose cell windows were shifted. These comparisons can miss edge changes; zero changed_map_candidates does not imply no bytes changed inside candidate regions. Older saved compact reports may omit this field.","uniqueKey":"result.oneOf.0.comparison.realigned_map_candidates","typeLabel":"integer"}},"required":["identical","changed_bytes","changed_overlap_bytes","reference_tail_bytes","comparison_tail_bytes","changed_map_candidates","unmatched_reference_candidates","unmatched_comparison_candidates","message"],"uniqueKey":"result.oneOf.0.comparison","typeLabel":"object"},"grid":{"type":"object","additionalProperties":false,"properties":{"map_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Map identifier returned by this file's completed scan or inspection.","isRequired":true,"uniqueKey":"result.oneOf.0.grid.map_id","typeLabel":"string"},"rows":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.0.grid.rows","typeLabel":"integer"},"columns":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.0.grid.columns","typeLabel":"integer"},"cells":{"type":"integer","minimum":0,"maximum":65536,"isRequired":true,"uniqueKey":"result.oneOf.0.grid.cells","typeLabel":"integer"},"min":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.0.grid.min.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.0.grid.min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.0.grid.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.0.grid.max.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.0.grid.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.0.grid.max","typeLabel":"number | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.grid.message","typeLabel":"string"}},"required":["map_id","rows","columns","cells","min","max","message"],"uniqueKey":"result.oneOf.0.grid","typeLabel":"object"},"layout":{"type":"object","additionalProperties":false,"properties":{"file_size_bytes":{"type":"integer","minimum":0,"maximum":8388608,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.file_size_bytes","typeLabel":"integer"},"region_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.region_count","typeLabel":"integer"},"bytes_by_kind":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.bytes_by_kind.code","typeLabel":"integer"},"calibration":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.bytes_by_kind.calibration","typeLabel":"integer"},"erased":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.bytes_by_kind.erased","typeLabel":"integer"},"mixed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.bytes_by_kind.mixed","typeLabel":"integer"},"unknown":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.bytes_by_kind.unknown","typeLabel":"integer"}},"required":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.0.layout.bytes_by_kind","typeLabel":"object"},"identification_block_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.0.layout.identification_block_count","typeLabel":"integer"},"offsets":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.layout.offsets","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.0.layout.message","typeLabel":"string"}},"required":["file_size_bytes","region_count","bytes_by_kind","identification_block_count","offsets","message"],"uniqueKey":"result.oneOf.0.layout","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"result.oneOf.0","typeLabel":"object"},{"type":"object","description":"Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.","required":["operation","message","notices","identification","condition","checksums","maps"],"example":{"operation":"inspect","message":"ECU identification completed.","identification":{"status":"identified","confidence":{"level":"medium","explanation":"Useful identification evidence was found, but confirmation is recommended."},"manufacturer":"Bosch","family":"MED9","variant":"MED91","byte_order":"big","cell_width_bytes":2},"layout":{"file_size_bytes":2097152,"region_count":9,"bytes_by_kind":{"code":1310720,"calibration":131072,"erased":196608,"mixed":458752,"unknown":0},"identification_block_count":1,"offsets":"Zero-based byte offsets; start inclusive, end exclusive.","message":"Regions are heuristic classifications of file contents, not verified memory definitions."},"condition":{"status":"review_recommended","coverage":"partial","message":"Some observations need review; they do not prove tuning or damage.","checks":[{"code":"embedded_erased_regions","title":"Internal blank regions","status":"review_recommended","message":"Repeated-byte fill can be normal; it does not prove that maps were erased.","evidence":{"erased_region_count":2,"embedded_region_count":1,"minimum_region_bytes":16384,"interior_margin_bytes":4096,"erased_bytes":196608,"embedded_bytes":131072}},{"code":"map_count_envelope","title":"Map count","status":"no_issues_detected","message":"The expected range is a heuristic for high-score candidates in the health scan, separate from the layout-filtered map list.","evidence":{"candidate_count":118,"expected_min":78,"expected_max":196,"relation":"within"}},{"code":"axis_plausibility","title":"Axis plausibility","status":"review_recommended","message":"Counts cover high-score tables. Byte order and false candidates can explain warnings. Reliable per-axis locations are unavailable.","evidence":{"table_count":118,"flagged_axis_count":21,"locations_available":false}},{"code":"supported_checksums","title":"Checksums","status":"unavailable","message":"Only detected, supported checksum checks are assessed; this does not establish whole-file validity.","evidence":{"reason":"no_supported_scheme_detected"}}]},"checksums":{"status":"unknown","reason":"no_supported_scheme_detected","message":"No supported checksum scheme was detected; validity remains unknown."},"maps":{"available":701,"returned":1,"omitted":700,"message":"These are map candidates. Names, units and scaling are not established.","axes_count":3903,"excluded_by_layout":22,"detected_before_layout":723,"layout_filtered":true},"notices":[{"code":"embedded_erased_regions","message":"Internal blank regions were found. They can be normal and do not prove erased maps."},{"code":"axis_plausibility","message":"Some candidate axes look unusual. Review their raw values and byte order."},{"code":"partial_coverage","message":"Some checks are unavailable for this file."},{"code":"observation_only","message":"These observations do not establish originality, tuning or flash safety."}]},"properties":{"operation":{"type":"string","enum":["inspect"],"isRequired":true,"uniqueKey":"result.oneOf.1.operation","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.message","typeLabel":"string"},"identification":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["identified","review_required","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.1.identification.status","typeLabel":"enum\u003cstring>"},"confidence":{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["high","medium","low","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.1.identification.confidence.level","typeLabel":"enum\u003cstring>"},"explanation":{"type":"string","description":"Short evidence explanation. This is not a probability or flashing-safety assessment.","isRequired":true,"uniqueKey":"result.oneOf.1.identification.confidence.explanation","typeLabel":"string"}},"required":["level","explanation"],"isRequired":true,"uniqueKey":"result.oneOf.1.identification.confidence","typeLabel":"object"},"manufacturer":{"type":"string","description":"ECU manufacturer, when established.","uniqueKey":"result.oneOf.1.identification.manufacturer","typeLabel":"string"},"family":{"type":"string","description":"ECU family, when established.","uniqueKey":"result.oneOf.1.identification.family","typeLabel":"string"},"variant":{"type":"string","description":"Specific ECU variant or model; not the vehicle model.","uniqueKey":"result.oneOf.1.identification.variant","typeLabel":"string"},"software":{"type":"string","description":"Software identifier or version extracted from supported evidence.","uniqueKey":"result.oneOf.1.identification.software","typeLabel":"string"},"hardware":{"type":"string","description":"Hardware identifier or number extracted from supported evidence.","uniqueKey":"result.oneOf.1.identification.hardware","typeLabel":"string"},"calibration_id":{"type":"string","description":"Supported calibration identifier, when established.","uniqueKey":"result.oneOf.1.identification.calibration_id","typeLabel":"string"},"part_number":{"type":"string","description":"Supported OEM part number, when established.","uniqueKey":"result.oneOf.1.identification.part_number","typeLabel":"string"},"byte_order":{"type":"string","enum":["big","little"],"description":"Detected ECU byte order, when established for an accepted identity.","uniqueKey":"result.oneOf.1.identification.byte_order","typeLabel":"enum\u003cstring>"},"cell_width_bytes":{"type":"integer","enum":[1,2,4],"description":"Detected ECU cell width; individual candidate descriptors can use another width.","uniqueKey":"result.oneOf.1.identification.cell_width_bytes","typeLabel":"enum\u003cinteger>"}},"required":["status","confidence"],"isRequired":true,"uniqueKey":"result.oneOf.1.identification","typeLabel":"object"},"condition":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["review_recommended","no_issues_detected","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.1.condition.status","typeLabel":"enum\u003cstring>"},"coverage":{"type":"string","enum":["complete","partial","unavailable"],"description":"complete means all listed supported checks were evaluated; it does not mean every possible ECU check is supported.","isRequired":true,"uniqueKey":"result.oneOf.1.condition.coverage","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.condition.message","typeLabel":"string"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","enum":["embedded_erased_regions","map_count_envelope","axis_plausibility","supported_checksums"],"isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].title","typeLabel":"string"},"status":{"type":"string","enum":["no_issues_detected","review_recommended","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].message","typeLabel":"string"},"evidence":{"type":"object","additionalProperties":false,"properties":{"erased_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.erased_region_count","typeLabel":"integer"},"embedded_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.embedded_region_count","typeLabel":"integer"},"erased_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.erased_bytes","typeLabel":"integer"},"embedded_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.embedded_bytes","typeLabel":"integer"},"minimum_region_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.minimum_region_bytes","typeLabel":"integer"},"interior_margin_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.interior_margin_bytes","typeLabel":"integer"},"candidate_count":{"type":"integer","minimum":0,"description":"High-score health-scan candidates, distinct from maps.available. Expected min/max are a heuristic, not verified map counts.","uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.candidate_count","typeLabel":"integer"},"expected_min":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.expected_min","typeLabel":"integer"},"expected_max":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.expected_max","typeLabel":"integer"},"table_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.table_count","typeLabel":"integer"},"checked_axis_count":{"type":"integer","minimum":0,"description":"Present only when the engine reports the checked total. A warning may report flagged_axis_count without this total.","uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.checked_axis_count","typeLabel":"integer"},"flagged_axis_count":{"type":"integer","minimum":0,"description":"Suspicious axes across table_count high-score tables. Does not imply every detected axis was checked.","uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.flagged_axis_count","typeLabel":"integer"},"relation":{"type":"string","enum":["below","within","above"],"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.relation","typeLabel":"enum\u003cstring>"},"locations_available":{"type":"boolean","enum":[false],"description":"Reliable locations of suspicious axes are unavailable; no affected-axis addresses are inferred.","uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.locations_available","typeLabel":"enum\u003cboolean>"},"reason":{"type":"string","enum":["unknown_family","no_family_envelope","no_high_score_tables","supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.reason","typeLabel":"enum\u003cstring>"},"regions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"start":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].start","typeLabel":"integer"},"end":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].end","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].size_bytes","typeLabel":"integer"},"high_score_candidate_count":{"type":"integer","minimum":0,"description":"High-score candidates used by layout classification; separate from the paginated discovery list.","uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].high_score_candidate_count","typeLabel":"integer"},"fill_byte":{"oneOf":[{"type":"integer","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte","typeLabel":"integer | null"},"fill_ratio":{"type":"number","minimum":0,"maximum":1,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_ratio","typeLabel":"number"}},"required":["kind","start","end","size_bytes"],"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions.items.[INDEX]","typeLabel":"object"},"maxItems":200,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence.regions","typeLabel":"object[]"}},"description":"Only measured fields applicable to the check are present. Internal erased-region locations appear in details when saved layout evidence is available.","isRequired":true,"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX].evidence","typeLabel":"object"}},"required":["code","title","status","message","evidence"],"uniqueKey":"result.oneOf.1.condition.checks.items.[INDEX]","typeLabel":"object"},"maxItems":4,"uniqueKey":"result.oneOf.1.condition.checks","typeLabel":"object[]"}},"required":["status","coverage","message"],"isRequired":true,"uniqueKey":"result.oneOf.1.condition","typeLabel":"object"},"checksums":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["passed","failed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.1.checksums.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.checksums.message","typeLabel":"string"},"reason":{"type":"string","enum":["supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.1.checksums.reason","typeLabel":"enum\u003cstring>"}},"required":["status","message"],"isRequired":true,"uniqueKey":"result.oneOf.1.checksums","typeLabel":"object"},"maps":{"type":"object","additionalProperties":false,"properties":{"available":{"type":"integer","minimum":0,"description":"Total detected candidates in this scan; not a count of verified calibration maps.","isRequired":true,"uniqueKey":"result.oneOf.1.maps.available","typeLabel":"integer"},"returned":{"type":"integer","minimum":0,"maximum":200,"description":"Candidates on this details page, or in the default page for a compact report.","isRequired":true,"uniqueKey":"result.oneOf.1.maps.returned","typeLabel":"integer"},"omitted":{"type":"integer","minimum":0,"description":"Available minus returned: candidates outside this page, including earlier pages. Follow pagination.next_offset rather than omitted to find the next page.","isRequired":true,"uniqueKey":"result.oneOf.1.maps.omitted","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.maps.message","typeLabel":"string"},"axes_count":{"type":"integer","minimum":0,"description":"Detected axes before layout filtering; not the number assessed by axis plausibility.","uniqueKey":"result.oneOf.1.maps.axes_count","typeLabel":"integer"},"detected_before_layout":{"type":"integer","minimum":0,"description":"All structural candidates before layout filtering; equals available + excluded_by_layout.","uniqueKey":"result.oneOf.1.maps.detected_before_layout","typeLabel":"integer"},"excluded_by_layout":{"type":"integer","minimum":0,"description":"Candidates excluded by layout filtering; separate from pagination omission.","uniqueKey":"result.oneOf.1.maps.excluded_by_layout","typeLabel":"integer"},"layout_filtered":{"type":"boolean","uniqueKey":"result.oneOf.1.maps.layout_filtered","typeLabel":"boolean"},"artifact":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["remapdb.ecu.maps.v1"],"isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.schema_version","typeLabel":"enum\u003cstring>"},"download_url":{"type":"string","description":"Stable authenticated API endpoint. Returns a 302 redirect to a fresh signed storage URL. Never send your API token to the redirect destination.","isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.download_url","typeLabel":"string"},"media_type":{"type":"string","enum":["application/json"],"isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.media_type","typeLabel":"enum\u003cstring>"},"content_encoding":{"type":"string","enum":["gzip"],"isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.content_encoding","typeLabel":"enum\u003cstring>"},"map_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.map_count","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"maximum":16777216,"description":"Exact decoded UTF-8 JSON bytes, after HTTP gzip decompression.","isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.size_bytes","typeLabel":"integer"},"compressed_size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.compressed_size_bytes","typeLabel":"integer"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the decoded JSON bytes, not the gzip container.","isRequired":true,"uniqueKey":"result.oneOf.1.maps.artifact.sha256","typeLabel":"string"}},"required":["schema_version","download_url","media_type","content_encoding","map_count","size_bytes","compressed_size_bytes","sha256"],"description":"Immutable public map artifact generated once by the worker, retained until the parent job expires. Missing on older jobs. Contains descriptors, not all grid cell values.","uniqueKey":"result.oneOf.1.maps.artifact","typeLabel":"object"}},"required":["available","returned","omitted","message"],"isRequired":true,"uniqueKey":"result.oneOf.1.maps","typeLabel":"object"},"notices":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.notices.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.notices.items.[INDEX].message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"result.oneOf.1.notices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.oneOf.1.notices","typeLabel":"object[]"},"comparison":{"type":"object","additionalProperties":false,"properties":{"identical":{"type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.1.comparison.identical","typeLabel":"boolean"},"changed_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.changed_bytes","typeLabel":"integer"},"changed_overlap_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.changed_overlap_bytes","typeLabel":"integer"},"reference_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.reference_tail_bytes","typeLabel":"integer"},"comparison_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.comparison_tail_bytes","typeLabel":"integer"},"changed_map_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.changed_map_candidates","typeLabel":"integer"},"unmatched_reference_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.unmatched_reference_candidates","typeLabel":"integer"},"unmatched_comparison_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.comparison.unmatched_comparison_candidates","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.comparison.message","typeLabel":"string"},"realigned_map_candidates":{"type":"integer","minimum":0,"description":"Candidate matches whose cell windows were shifted. These comparisons can miss edge changes; zero changed_map_candidates does not imply no bytes changed inside candidate regions. Older saved compact reports may omit this field.","uniqueKey":"result.oneOf.1.comparison.realigned_map_candidates","typeLabel":"integer"}},"required":["identical","changed_bytes","changed_overlap_bytes","reference_tail_bytes","comparison_tail_bytes","changed_map_candidates","unmatched_reference_candidates","unmatched_comparison_candidates","message"],"uniqueKey":"result.oneOf.1.comparison","typeLabel":"object"},"grid":{"type":"object","additionalProperties":false,"properties":{"map_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Map identifier returned by this file's completed scan or inspection.","isRequired":true,"uniqueKey":"result.oneOf.1.grid.map_id","typeLabel":"string"},"rows":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.1.grid.rows","typeLabel":"integer"},"columns":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.1.grid.columns","typeLabel":"integer"},"cells":{"type":"integer","minimum":0,"maximum":65536,"isRequired":true,"uniqueKey":"result.oneOf.1.grid.cells","typeLabel":"integer"},"min":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.1.grid.min.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.1.grid.min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.1.grid.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.1.grid.max.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.1.grid.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.1.grid.max","typeLabel":"number | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.grid.message","typeLabel":"string"}},"required":["map_id","rows","columns","cells","min","max","message"],"uniqueKey":"result.oneOf.1.grid","typeLabel":"object"},"layout":{"type":"object","additionalProperties":false,"properties":{"file_size_bytes":{"type":"integer","minimum":0,"maximum":8388608,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.file_size_bytes","typeLabel":"integer"},"region_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.region_count","typeLabel":"integer"},"bytes_by_kind":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.bytes_by_kind.code","typeLabel":"integer"},"calibration":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.bytes_by_kind.calibration","typeLabel":"integer"},"erased":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.bytes_by_kind.erased","typeLabel":"integer"},"mixed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.bytes_by_kind.mixed","typeLabel":"integer"},"unknown":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.bytes_by_kind.unknown","typeLabel":"integer"}},"required":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.1.layout.bytes_by_kind","typeLabel":"object"},"identification_block_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.1.layout.identification_block_count","typeLabel":"integer"},"offsets":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.layout.offsets","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.1.layout.message","typeLabel":"string"}},"required":["file_size_bytes","region_count","bytes_by_kind","identification_block_count","offsets","message"],"uniqueKey":"result.oneOf.1.layout","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"result.oneOf.1","typeLabel":"object"},{"type":"object","description":"Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.","required":["operation","message","notices","maps"],"example":{"operation":"inspect","message":"ECU identification completed.","identification":{"status":"identified","confidence":{"level":"medium","explanation":"Useful identification evidence was found, but confirmation is recommended."},"manufacturer":"Bosch","family":"MED9","variant":"MED91","byte_order":"big","cell_width_bytes":2},"layout":{"file_size_bytes":2097152,"region_count":9,"bytes_by_kind":{"code":1310720,"calibration":131072,"erased":196608,"mixed":458752,"unknown":0},"identification_block_count":1,"offsets":"Zero-based byte offsets; start inclusive, end exclusive.","message":"Regions are heuristic classifications of file contents, not verified memory definitions."},"condition":{"status":"review_recommended","coverage":"partial","message":"Some observations need review; they do not prove tuning or damage.","checks":[{"code":"embedded_erased_regions","title":"Internal blank regions","status":"review_recommended","message":"Repeated-byte fill can be normal; it does not prove that maps were erased.","evidence":{"erased_region_count":2,"embedded_region_count":1,"minimum_region_bytes":16384,"interior_margin_bytes":4096,"erased_bytes":196608,"embedded_bytes":131072}},{"code":"map_count_envelope","title":"Map count","status":"no_issues_detected","message":"The expected range is a heuristic for high-score candidates in the health scan, separate from the layout-filtered map list.","evidence":{"candidate_count":118,"expected_min":78,"expected_max":196,"relation":"within"}},{"code":"axis_plausibility","title":"Axis plausibility","status":"review_recommended","message":"Counts cover high-score tables. Byte order and false candidates can explain warnings. Reliable per-axis locations are unavailable.","evidence":{"table_count":118,"flagged_axis_count":21,"locations_available":false}},{"code":"supported_checksums","title":"Checksums","status":"unavailable","message":"Only detected, supported checksum checks are assessed; this does not establish whole-file validity.","evidence":{"reason":"no_supported_scheme_detected"}}]},"checksums":{"status":"unknown","reason":"no_supported_scheme_detected","message":"No supported checksum scheme was detected; validity remains unknown."},"maps":{"available":701,"returned":1,"omitted":700,"message":"These are map candidates. Names, units and scaling are not established.","axes_count":3903,"excluded_by_layout":22,"detected_before_layout":723,"layout_filtered":true},"notices":[{"code":"embedded_erased_regions","message":"Internal blank regions were found. They can be normal and do not prove erased maps."},{"code":"axis_plausibility","message":"Some candidate axes look unusual. Review their raw values and byte order."},{"code":"partial_coverage","message":"Some checks are unavailable for this file."},{"code":"observation_only","message":"These observations do not establish originality, tuning or flash safety."}]},"properties":{"operation":{"type":"string","enum":["maps"],"isRequired":true,"uniqueKey":"result.oneOf.2.operation","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.message","typeLabel":"string"},"maps":{"type":"object","additionalProperties":false,"properties":{"available":{"type":"integer","minimum":0,"description":"Total detected candidates in this scan; not a count of verified calibration maps.","isRequired":true,"uniqueKey":"result.oneOf.2.maps.available","typeLabel":"integer"},"returned":{"type":"integer","minimum":0,"maximum":200,"description":"Candidates on this details page, or in the default page for a compact report.","isRequired":true,"uniqueKey":"result.oneOf.2.maps.returned","typeLabel":"integer"},"omitted":{"type":"integer","minimum":0,"description":"Available minus returned: candidates outside this page, including earlier pages. Follow pagination.next_offset rather than omitted to find the next page.","isRequired":true,"uniqueKey":"result.oneOf.2.maps.omitted","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.maps.message","typeLabel":"string"},"axes_count":{"type":"integer","minimum":0,"description":"Detected axes before layout filtering; not the number assessed by axis plausibility.","uniqueKey":"result.oneOf.2.maps.axes_count","typeLabel":"integer"},"detected_before_layout":{"type":"integer","minimum":0,"description":"All structural candidates before layout filtering; equals available + excluded_by_layout.","uniqueKey":"result.oneOf.2.maps.detected_before_layout","typeLabel":"integer"},"excluded_by_layout":{"type":"integer","minimum":0,"description":"Candidates excluded by layout filtering; separate from pagination omission.","uniqueKey":"result.oneOf.2.maps.excluded_by_layout","typeLabel":"integer"},"layout_filtered":{"type":"boolean","uniqueKey":"result.oneOf.2.maps.layout_filtered","typeLabel":"boolean"},"artifact":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["remapdb.ecu.maps.v1"],"isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.schema_version","typeLabel":"enum\u003cstring>"},"download_url":{"type":"string","description":"Stable authenticated API endpoint. Returns a 302 redirect to a fresh signed storage URL. Never send your API token to the redirect destination.","isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.download_url","typeLabel":"string"},"media_type":{"type":"string","enum":["application/json"],"isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.media_type","typeLabel":"enum\u003cstring>"},"content_encoding":{"type":"string","enum":["gzip"],"isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.content_encoding","typeLabel":"enum\u003cstring>"},"map_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.map_count","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"maximum":16777216,"description":"Exact decoded UTF-8 JSON bytes, after HTTP gzip decompression.","isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.size_bytes","typeLabel":"integer"},"compressed_size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.compressed_size_bytes","typeLabel":"integer"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the decoded JSON bytes, not the gzip container.","isRequired":true,"uniqueKey":"result.oneOf.2.maps.artifact.sha256","typeLabel":"string"}},"required":["schema_version","download_url","media_type","content_encoding","map_count","size_bytes","compressed_size_bytes","sha256"],"description":"Immutable public map artifact generated once by the worker, retained until the parent job expires. Missing on older jobs. Contains descriptors, not all grid cell values.","uniqueKey":"result.oneOf.2.maps.artifact","typeLabel":"object"}},"required":["available","returned","omitted","message"],"isRequired":true,"uniqueKey":"result.oneOf.2.maps","typeLabel":"object"},"notices":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.notices.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.notices.items.[INDEX].message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"result.oneOf.2.notices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.oneOf.2.notices","typeLabel":"object[]"},"identification":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["identified","review_required","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.2.identification.status","typeLabel":"enum\u003cstring>"},"confidence":{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["high","medium","low","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.2.identification.confidence.level","typeLabel":"enum\u003cstring>"},"explanation":{"type":"string","description":"Short evidence explanation. This is not a probability or flashing-safety assessment.","isRequired":true,"uniqueKey":"result.oneOf.2.identification.confidence.explanation","typeLabel":"string"}},"required":["level","explanation"],"isRequired":true,"uniqueKey":"result.oneOf.2.identification.confidence","typeLabel":"object"},"manufacturer":{"type":"string","description":"ECU manufacturer, when established.","uniqueKey":"result.oneOf.2.identification.manufacturer","typeLabel":"string"},"family":{"type":"string","description":"ECU family, when established.","uniqueKey":"result.oneOf.2.identification.family","typeLabel":"string"},"variant":{"type":"string","description":"Specific ECU variant or model; not the vehicle model.","uniqueKey":"result.oneOf.2.identification.variant","typeLabel":"string"},"software":{"type":"string","description":"Software identifier or version extracted from supported evidence.","uniqueKey":"result.oneOf.2.identification.software","typeLabel":"string"},"hardware":{"type":"string","description":"Hardware identifier or number extracted from supported evidence.","uniqueKey":"result.oneOf.2.identification.hardware","typeLabel":"string"},"calibration_id":{"type":"string","description":"Supported calibration identifier, when established.","uniqueKey":"result.oneOf.2.identification.calibration_id","typeLabel":"string"},"part_number":{"type":"string","description":"Supported OEM part number, when established.","uniqueKey":"result.oneOf.2.identification.part_number","typeLabel":"string"},"byte_order":{"type":"string","enum":["big","little"],"description":"Detected ECU byte order, when established for an accepted identity.","uniqueKey":"result.oneOf.2.identification.byte_order","typeLabel":"enum\u003cstring>"},"cell_width_bytes":{"type":"integer","enum":[1,2,4],"description":"Detected ECU cell width; individual candidate descriptors can use another width.","uniqueKey":"result.oneOf.2.identification.cell_width_bytes","typeLabel":"enum\u003cinteger>"}},"required":["status","confidence"],"uniqueKey":"result.oneOf.2.identification","typeLabel":"object"},"condition":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["review_recommended","no_issues_detected","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.2.condition.status","typeLabel":"enum\u003cstring>"},"coverage":{"type":"string","enum":["complete","partial","unavailable"],"description":"complete means all listed supported checks were evaluated; it does not mean every possible ECU check is supported.","isRequired":true,"uniqueKey":"result.oneOf.2.condition.coverage","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.condition.message","typeLabel":"string"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","enum":["embedded_erased_regions","map_count_envelope","axis_plausibility","supported_checksums"],"isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].title","typeLabel":"string"},"status":{"type":"string","enum":["no_issues_detected","review_recommended","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].message","typeLabel":"string"},"evidence":{"type":"object","additionalProperties":false,"properties":{"erased_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.erased_region_count","typeLabel":"integer"},"embedded_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.embedded_region_count","typeLabel":"integer"},"erased_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.erased_bytes","typeLabel":"integer"},"embedded_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.embedded_bytes","typeLabel":"integer"},"minimum_region_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.minimum_region_bytes","typeLabel":"integer"},"interior_margin_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.interior_margin_bytes","typeLabel":"integer"},"candidate_count":{"type":"integer","minimum":0,"description":"High-score health-scan candidates, distinct from maps.available. Expected min/max are a heuristic, not verified map counts.","uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.candidate_count","typeLabel":"integer"},"expected_min":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.expected_min","typeLabel":"integer"},"expected_max":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.expected_max","typeLabel":"integer"},"table_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.table_count","typeLabel":"integer"},"checked_axis_count":{"type":"integer","minimum":0,"description":"Present only when the engine reports the checked total. A warning may report flagged_axis_count without this total.","uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.checked_axis_count","typeLabel":"integer"},"flagged_axis_count":{"type":"integer","minimum":0,"description":"Suspicious axes across table_count high-score tables. Does not imply every detected axis was checked.","uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.flagged_axis_count","typeLabel":"integer"},"relation":{"type":"string","enum":["below","within","above"],"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.relation","typeLabel":"enum\u003cstring>"},"locations_available":{"type":"boolean","enum":[false],"description":"Reliable locations of suspicious axes are unavailable; no affected-axis addresses are inferred.","uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.locations_available","typeLabel":"enum\u003cboolean>"},"reason":{"type":"string","enum":["unknown_family","no_family_envelope","no_high_score_tables","supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.reason","typeLabel":"enum\u003cstring>"},"regions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"start":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].start","typeLabel":"integer"},"end":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].end","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].size_bytes","typeLabel":"integer"},"high_score_candidate_count":{"type":"integer","minimum":0,"description":"High-score candidates used by layout classification; separate from the paginated discovery list.","uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].high_score_candidate_count","typeLabel":"integer"},"fill_byte":{"oneOf":[{"type":"integer","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte","typeLabel":"integer | null"},"fill_ratio":{"type":"number","minimum":0,"maximum":1,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_ratio","typeLabel":"number"}},"required":["kind","start","end","size_bytes"],"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions.items.[INDEX]","typeLabel":"object"},"maxItems":200,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence.regions","typeLabel":"object[]"}},"description":"Only measured fields applicable to the check are present. Internal erased-region locations appear in details when saved layout evidence is available.","isRequired":true,"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX].evidence","typeLabel":"object"}},"required":["code","title","status","message","evidence"],"uniqueKey":"result.oneOf.2.condition.checks.items.[INDEX]","typeLabel":"object"},"maxItems":4,"uniqueKey":"result.oneOf.2.condition.checks","typeLabel":"object[]"}},"required":["status","coverage","message"],"uniqueKey":"result.oneOf.2.condition","typeLabel":"object"},"checksums":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["passed","failed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.2.checksums.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.checksums.message","typeLabel":"string"},"reason":{"type":"string","enum":["supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.2.checksums.reason","typeLabel":"enum\u003cstring>"}},"required":["status","message"],"uniqueKey":"result.oneOf.2.checksums","typeLabel":"object"},"comparison":{"type":"object","additionalProperties":false,"properties":{"identical":{"type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.2.comparison.identical","typeLabel":"boolean"},"changed_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.changed_bytes","typeLabel":"integer"},"changed_overlap_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.changed_overlap_bytes","typeLabel":"integer"},"reference_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.reference_tail_bytes","typeLabel":"integer"},"comparison_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.comparison_tail_bytes","typeLabel":"integer"},"changed_map_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.changed_map_candidates","typeLabel":"integer"},"unmatched_reference_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.unmatched_reference_candidates","typeLabel":"integer"},"unmatched_comparison_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.comparison.unmatched_comparison_candidates","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.comparison.message","typeLabel":"string"},"realigned_map_candidates":{"type":"integer","minimum":0,"description":"Candidate matches whose cell windows were shifted. These comparisons can miss edge changes; zero changed_map_candidates does not imply no bytes changed inside candidate regions. Older saved compact reports may omit this field.","uniqueKey":"result.oneOf.2.comparison.realigned_map_candidates","typeLabel":"integer"}},"required":["identical","changed_bytes","changed_overlap_bytes","reference_tail_bytes","comparison_tail_bytes","changed_map_candidates","unmatched_reference_candidates","unmatched_comparison_candidates","message"],"uniqueKey":"result.oneOf.2.comparison","typeLabel":"object"},"grid":{"type":"object","additionalProperties":false,"properties":{"map_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Map identifier returned by this file's completed scan or inspection.","isRequired":true,"uniqueKey":"result.oneOf.2.grid.map_id","typeLabel":"string"},"rows":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.2.grid.rows","typeLabel":"integer"},"columns":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.2.grid.columns","typeLabel":"integer"},"cells":{"type":"integer","minimum":0,"maximum":65536,"isRequired":true,"uniqueKey":"result.oneOf.2.grid.cells","typeLabel":"integer"},"min":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.2.grid.min.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.2.grid.min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.2.grid.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.2.grid.max.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.2.grid.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.2.grid.max","typeLabel":"number | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.grid.message","typeLabel":"string"}},"required":["map_id","rows","columns","cells","min","max","message"],"uniqueKey":"result.oneOf.2.grid","typeLabel":"object"},"layout":{"type":"object","additionalProperties":false,"properties":{"file_size_bytes":{"type":"integer","minimum":0,"maximum":8388608,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.file_size_bytes","typeLabel":"integer"},"region_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.region_count","typeLabel":"integer"},"bytes_by_kind":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.bytes_by_kind.code","typeLabel":"integer"},"calibration":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.bytes_by_kind.calibration","typeLabel":"integer"},"erased":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.bytes_by_kind.erased","typeLabel":"integer"},"mixed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.bytes_by_kind.mixed","typeLabel":"integer"},"unknown":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.bytes_by_kind.unknown","typeLabel":"integer"}},"required":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.2.layout.bytes_by_kind","typeLabel":"object"},"identification_block_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.2.layout.identification_block_count","typeLabel":"integer"},"offsets":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.layout.offsets","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.2.layout.message","typeLabel":"string"}},"required":["file_size_bytes","region_count","bytes_by_kind","identification_block_count","offsets","message"],"uniqueKey":"result.oneOf.2.layout","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"result.oneOf.2","typeLabel":"object"},{"type":"object","description":"Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.","required":["operation","message","notices","comparison"],"example":{"operation":"inspect","message":"ECU identification completed.","identification":{"status":"identified","confidence":{"level":"medium","explanation":"Useful identification evidence was found, but confirmation is recommended."},"manufacturer":"Bosch","family":"MED9","variant":"MED91","byte_order":"big","cell_width_bytes":2},"layout":{"file_size_bytes":2097152,"region_count":9,"bytes_by_kind":{"code":1310720,"calibration":131072,"erased":196608,"mixed":458752,"unknown":0},"identification_block_count":1,"offsets":"Zero-based byte offsets; start inclusive, end exclusive.","message":"Regions are heuristic classifications of file contents, not verified memory definitions."},"condition":{"status":"review_recommended","coverage":"partial","message":"Some observations need review; they do not prove tuning or damage.","checks":[{"code":"embedded_erased_regions","title":"Internal blank regions","status":"review_recommended","message":"Repeated-byte fill can be normal; it does not prove that maps were erased.","evidence":{"erased_region_count":2,"embedded_region_count":1,"minimum_region_bytes":16384,"interior_margin_bytes":4096,"erased_bytes":196608,"embedded_bytes":131072}},{"code":"map_count_envelope","title":"Map count","status":"no_issues_detected","message":"The expected range is a heuristic for high-score candidates in the health scan, separate from the layout-filtered map list.","evidence":{"candidate_count":118,"expected_min":78,"expected_max":196,"relation":"within"}},{"code":"axis_plausibility","title":"Axis plausibility","status":"review_recommended","message":"Counts cover high-score tables. Byte order and false candidates can explain warnings. Reliable per-axis locations are unavailable.","evidence":{"table_count":118,"flagged_axis_count":21,"locations_available":false}},{"code":"supported_checksums","title":"Checksums","status":"unavailable","message":"Only detected, supported checksum checks are assessed; this does not establish whole-file validity.","evidence":{"reason":"no_supported_scheme_detected"}}]},"checksums":{"status":"unknown","reason":"no_supported_scheme_detected","message":"No supported checksum scheme was detected; validity remains unknown."},"maps":{"available":701,"returned":1,"omitted":700,"message":"These are map candidates. Names, units and scaling are not established.","axes_count":3903,"excluded_by_layout":22,"detected_before_layout":723,"layout_filtered":true},"notices":[{"code":"embedded_erased_regions","message":"Internal blank regions were found. They can be normal and do not prove erased maps."},{"code":"axis_plausibility","message":"Some candidate axes look unusual. Review their raw values and byte order."},{"code":"partial_coverage","message":"Some checks are unavailable for this file."},{"code":"observation_only","message":"These observations do not establish originality, tuning or flash safety."}]},"properties":{"operation":{"type":"string","enum":["diff"],"isRequired":true,"uniqueKey":"result.oneOf.3.operation","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.message","typeLabel":"string"},"comparison":{"type":"object","additionalProperties":false,"properties":{"identical":{"type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.3.comparison.identical","typeLabel":"boolean"},"changed_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.changed_bytes","typeLabel":"integer"},"changed_overlap_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.changed_overlap_bytes","typeLabel":"integer"},"reference_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.reference_tail_bytes","typeLabel":"integer"},"comparison_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.comparison_tail_bytes","typeLabel":"integer"},"changed_map_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.changed_map_candidates","typeLabel":"integer"},"unmatched_reference_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.unmatched_reference_candidates","typeLabel":"integer"},"unmatched_comparison_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.comparison.unmatched_comparison_candidates","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.comparison.message","typeLabel":"string"},"realigned_map_candidates":{"type":"integer","minimum":0,"description":"Candidate matches whose cell windows were shifted. These comparisons can miss edge changes; zero changed_map_candidates does not imply no bytes changed inside candidate regions. Older saved compact reports may omit this field.","uniqueKey":"result.oneOf.3.comparison.realigned_map_candidates","typeLabel":"integer"}},"required":["identical","changed_bytes","changed_overlap_bytes","reference_tail_bytes","comparison_tail_bytes","changed_map_candidates","unmatched_reference_candidates","unmatched_comparison_candidates","message"],"isRequired":true,"uniqueKey":"result.oneOf.3.comparison","typeLabel":"object"},"notices":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.notices.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.notices.items.[INDEX].message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"result.oneOf.3.notices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.oneOf.3.notices","typeLabel":"object[]"},"identification":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["identified","review_required","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.3.identification.status","typeLabel":"enum\u003cstring>"},"confidence":{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["high","medium","low","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.3.identification.confidence.level","typeLabel":"enum\u003cstring>"},"explanation":{"type":"string","description":"Short evidence explanation. This is not a probability or flashing-safety assessment.","isRequired":true,"uniqueKey":"result.oneOf.3.identification.confidence.explanation","typeLabel":"string"}},"required":["level","explanation"],"isRequired":true,"uniqueKey":"result.oneOf.3.identification.confidence","typeLabel":"object"},"manufacturer":{"type":"string","description":"ECU manufacturer, when established.","uniqueKey":"result.oneOf.3.identification.manufacturer","typeLabel":"string"},"family":{"type":"string","description":"ECU family, when established.","uniqueKey":"result.oneOf.3.identification.family","typeLabel":"string"},"variant":{"type":"string","description":"Specific ECU variant or model; not the vehicle model.","uniqueKey":"result.oneOf.3.identification.variant","typeLabel":"string"},"software":{"type":"string","description":"Software identifier or version extracted from supported evidence.","uniqueKey":"result.oneOf.3.identification.software","typeLabel":"string"},"hardware":{"type":"string","description":"Hardware identifier or number extracted from supported evidence.","uniqueKey":"result.oneOf.3.identification.hardware","typeLabel":"string"},"calibration_id":{"type":"string","description":"Supported calibration identifier, when established.","uniqueKey":"result.oneOf.3.identification.calibration_id","typeLabel":"string"},"part_number":{"type":"string","description":"Supported OEM part number, when established.","uniqueKey":"result.oneOf.3.identification.part_number","typeLabel":"string"},"byte_order":{"type":"string","enum":["big","little"],"description":"Detected ECU byte order, when established for an accepted identity.","uniqueKey":"result.oneOf.3.identification.byte_order","typeLabel":"enum\u003cstring>"},"cell_width_bytes":{"type":"integer","enum":[1,2,4],"description":"Detected ECU cell width; individual candidate descriptors can use another width.","uniqueKey":"result.oneOf.3.identification.cell_width_bytes","typeLabel":"enum\u003cinteger>"}},"required":["status","confidence"],"uniqueKey":"result.oneOf.3.identification","typeLabel":"object"},"condition":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["review_recommended","no_issues_detected","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.3.condition.status","typeLabel":"enum\u003cstring>"},"coverage":{"type":"string","enum":["complete","partial","unavailable"],"description":"complete means all listed supported checks were evaluated; it does not mean every possible ECU check is supported.","isRequired":true,"uniqueKey":"result.oneOf.3.condition.coverage","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.condition.message","typeLabel":"string"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","enum":["embedded_erased_regions","map_count_envelope","axis_plausibility","supported_checksums"],"isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].title","typeLabel":"string"},"status":{"type":"string","enum":["no_issues_detected","review_recommended","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].message","typeLabel":"string"},"evidence":{"type":"object","additionalProperties":false,"properties":{"erased_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.erased_region_count","typeLabel":"integer"},"embedded_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.embedded_region_count","typeLabel":"integer"},"erased_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.erased_bytes","typeLabel":"integer"},"embedded_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.embedded_bytes","typeLabel":"integer"},"minimum_region_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.minimum_region_bytes","typeLabel":"integer"},"interior_margin_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.interior_margin_bytes","typeLabel":"integer"},"candidate_count":{"type":"integer","minimum":0,"description":"High-score health-scan candidates, distinct from maps.available. Expected min/max are a heuristic, not verified map counts.","uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.candidate_count","typeLabel":"integer"},"expected_min":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.expected_min","typeLabel":"integer"},"expected_max":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.expected_max","typeLabel":"integer"},"table_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.table_count","typeLabel":"integer"},"checked_axis_count":{"type":"integer","minimum":0,"description":"Present only when the engine reports the checked total. A warning may report flagged_axis_count without this total.","uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.checked_axis_count","typeLabel":"integer"},"flagged_axis_count":{"type":"integer","minimum":0,"description":"Suspicious axes across table_count high-score tables. Does not imply every detected axis was checked.","uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.flagged_axis_count","typeLabel":"integer"},"relation":{"type":"string","enum":["below","within","above"],"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.relation","typeLabel":"enum\u003cstring>"},"locations_available":{"type":"boolean","enum":[false],"description":"Reliable locations of suspicious axes are unavailable; no affected-axis addresses are inferred.","uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.locations_available","typeLabel":"enum\u003cboolean>"},"reason":{"type":"string","enum":["unknown_family","no_family_envelope","no_high_score_tables","supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.reason","typeLabel":"enum\u003cstring>"},"regions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"start":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].start","typeLabel":"integer"},"end":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].end","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].size_bytes","typeLabel":"integer"},"high_score_candidate_count":{"type":"integer","minimum":0,"description":"High-score candidates used by layout classification; separate from the paginated discovery list.","uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].high_score_candidate_count","typeLabel":"integer"},"fill_byte":{"oneOf":[{"type":"integer","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte","typeLabel":"integer | null"},"fill_ratio":{"type":"number","minimum":0,"maximum":1,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_ratio","typeLabel":"number"}},"required":["kind","start","end","size_bytes"],"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions.items.[INDEX]","typeLabel":"object"},"maxItems":200,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence.regions","typeLabel":"object[]"}},"description":"Only measured fields applicable to the check are present. Internal erased-region locations appear in details when saved layout evidence is available.","isRequired":true,"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX].evidence","typeLabel":"object"}},"required":["code","title","status","message","evidence"],"uniqueKey":"result.oneOf.3.condition.checks.items.[INDEX]","typeLabel":"object"},"maxItems":4,"uniqueKey":"result.oneOf.3.condition.checks","typeLabel":"object[]"}},"required":["status","coverage","message"],"uniqueKey":"result.oneOf.3.condition","typeLabel":"object"},"checksums":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["passed","failed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.3.checksums.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.checksums.message","typeLabel":"string"},"reason":{"type":"string","enum":["supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.3.checksums.reason","typeLabel":"enum\u003cstring>"}},"required":["status","message"],"uniqueKey":"result.oneOf.3.checksums","typeLabel":"object"},"maps":{"type":"object","additionalProperties":false,"properties":{"available":{"type":"integer","minimum":0,"description":"Total detected candidates in this scan; not a count of verified calibration maps.","isRequired":true,"uniqueKey":"result.oneOf.3.maps.available","typeLabel":"integer"},"returned":{"type":"integer","minimum":0,"maximum":200,"description":"Candidates on this details page, or in the default page for a compact report.","isRequired":true,"uniqueKey":"result.oneOf.3.maps.returned","typeLabel":"integer"},"omitted":{"type":"integer","minimum":0,"description":"Available minus returned: candidates outside this page, including earlier pages. Follow pagination.next_offset rather than omitted to find the next page.","isRequired":true,"uniqueKey":"result.oneOf.3.maps.omitted","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.maps.message","typeLabel":"string"},"axes_count":{"type":"integer","minimum":0,"description":"Detected axes before layout filtering; not the number assessed by axis plausibility.","uniqueKey":"result.oneOf.3.maps.axes_count","typeLabel":"integer"},"detected_before_layout":{"type":"integer","minimum":0,"description":"All structural candidates before layout filtering; equals available + excluded_by_layout.","uniqueKey":"result.oneOf.3.maps.detected_before_layout","typeLabel":"integer"},"excluded_by_layout":{"type":"integer","minimum":0,"description":"Candidates excluded by layout filtering; separate from pagination omission.","uniqueKey":"result.oneOf.3.maps.excluded_by_layout","typeLabel":"integer"},"layout_filtered":{"type":"boolean","uniqueKey":"result.oneOf.3.maps.layout_filtered","typeLabel":"boolean"},"artifact":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["remapdb.ecu.maps.v1"],"isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.schema_version","typeLabel":"enum\u003cstring>"},"download_url":{"type":"string","description":"Stable authenticated API endpoint. Returns a 302 redirect to a fresh signed storage URL. Never send your API token to the redirect destination.","isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.download_url","typeLabel":"string"},"media_type":{"type":"string","enum":["application/json"],"isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.media_type","typeLabel":"enum\u003cstring>"},"content_encoding":{"type":"string","enum":["gzip"],"isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.content_encoding","typeLabel":"enum\u003cstring>"},"map_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.map_count","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"maximum":16777216,"description":"Exact decoded UTF-8 JSON bytes, after HTTP gzip decompression.","isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.size_bytes","typeLabel":"integer"},"compressed_size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.compressed_size_bytes","typeLabel":"integer"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the decoded JSON bytes, not the gzip container.","isRequired":true,"uniqueKey":"result.oneOf.3.maps.artifact.sha256","typeLabel":"string"}},"required":["schema_version","download_url","media_type","content_encoding","map_count","size_bytes","compressed_size_bytes","sha256"],"description":"Immutable public map artifact generated once by the worker, retained until the parent job expires. Missing on older jobs. Contains descriptors, not all grid cell values.","uniqueKey":"result.oneOf.3.maps.artifact","typeLabel":"object"}},"required":["available","returned","omitted","message"],"uniqueKey":"result.oneOf.3.maps","typeLabel":"object"},"grid":{"type":"object","additionalProperties":false,"properties":{"map_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Map identifier returned by this file's completed scan or inspection.","isRequired":true,"uniqueKey":"result.oneOf.3.grid.map_id","typeLabel":"string"},"rows":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.3.grid.rows","typeLabel":"integer"},"columns":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.3.grid.columns","typeLabel":"integer"},"cells":{"type":"integer","minimum":0,"maximum":65536,"isRequired":true,"uniqueKey":"result.oneOf.3.grid.cells","typeLabel":"integer"},"min":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.3.grid.min.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.3.grid.min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.3.grid.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.3.grid.max.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.3.grid.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.3.grid.max","typeLabel":"number | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.grid.message","typeLabel":"string"}},"required":["map_id","rows","columns","cells","min","max","message"],"uniqueKey":"result.oneOf.3.grid","typeLabel":"object"},"layout":{"type":"object","additionalProperties":false,"properties":{"file_size_bytes":{"type":"integer","minimum":0,"maximum":8388608,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.file_size_bytes","typeLabel":"integer"},"region_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.region_count","typeLabel":"integer"},"bytes_by_kind":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.bytes_by_kind.code","typeLabel":"integer"},"calibration":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.bytes_by_kind.calibration","typeLabel":"integer"},"erased":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.bytes_by_kind.erased","typeLabel":"integer"},"mixed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.bytes_by_kind.mixed","typeLabel":"integer"},"unknown":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.bytes_by_kind.unknown","typeLabel":"integer"}},"required":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.3.layout.bytes_by_kind","typeLabel":"object"},"identification_block_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.3.layout.identification_block_count","typeLabel":"integer"},"offsets":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.layout.offsets","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.3.layout.message","typeLabel":"string"}},"required":["file_size_bytes","region_count","bytes_by_kind","identification_block_count","offsets","message"],"uniqueKey":"result.oneOf.3.layout","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"result.oneOf.3","typeLabel":"object"},{"type":"object","description":"Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.","required":["operation","message","notices","grid"],"example":{"operation":"inspect","message":"ECU identification completed.","identification":{"status":"identified","confidence":{"level":"medium","explanation":"Useful identification evidence was found, but confirmation is recommended."},"manufacturer":"Bosch","family":"MED9","variant":"MED91","byte_order":"big","cell_width_bytes":2},"layout":{"file_size_bytes":2097152,"region_count":9,"bytes_by_kind":{"code":1310720,"calibration":131072,"erased":196608,"mixed":458752,"unknown":0},"identification_block_count":1,"offsets":"Zero-based byte offsets; start inclusive, end exclusive.","message":"Regions are heuristic classifications of file contents, not verified memory definitions."},"condition":{"status":"review_recommended","coverage":"partial","message":"Some observations need review; they do not prove tuning or damage.","checks":[{"code":"embedded_erased_regions","title":"Internal blank regions","status":"review_recommended","message":"Repeated-byte fill can be normal; it does not prove that maps were erased.","evidence":{"erased_region_count":2,"embedded_region_count":1,"minimum_region_bytes":16384,"interior_margin_bytes":4096,"erased_bytes":196608,"embedded_bytes":131072}},{"code":"map_count_envelope","title":"Map count","status":"no_issues_detected","message":"The expected range is a heuristic for high-score candidates in the health scan, separate from the layout-filtered map list.","evidence":{"candidate_count":118,"expected_min":78,"expected_max":196,"relation":"within"}},{"code":"axis_plausibility","title":"Axis plausibility","status":"review_recommended","message":"Counts cover high-score tables. Byte order and false candidates can explain warnings. Reliable per-axis locations are unavailable.","evidence":{"table_count":118,"flagged_axis_count":21,"locations_available":false}},{"code":"supported_checksums","title":"Checksums","status":"unavailable","message":"Only detected, supported checksum checks are assessed; this does not establish whole-file validity.","evidence":{"reason":"no_supported_scheme_detected"}}]},"checksums":{"status":"unknown","reason":"no_supported_scheme_detected","message":"No supported checksum scheme was detected; validity remains unknown."},"maps":{"available":701,"returned":1,"omitted":700,"message":"These are map candidates. Names, units and scaling are not established.","axes_count":3903,"excluded_by_layout":22,"detected_before_layout":723,"layout_filtered":true},"notices":[{"code":"embedded_erased_regions","message":"Internal blank regions were found. They can be normal and do not prove erased maps."},{"code":"axis_plausibility","message":"Some candidate axes look unusual. Review their raw values and byte order."},{"code":"partial_coverage","message":"Some checks are unavailable for this file."},{"code":"observation_only","message":"These observations do not establish originality, tuning or flash safety."}]},"properties":{"operation":{"type":"string","enum":["map-grid"],"isRequired":true,"uniqueKey":"result.oneOf.4.operation","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.message","typeLabel":"string"},"grid":{"type":"object","additionalProperties":false,"properties":{"map_id":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"Map identifier returned by this file's completed scan or inspection.","isRequired":true,"uniqueKey":"result.oneOf.4.grid.map_id","typeLabel":"string"},"rows":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.4.grid.rows","typeLabel":"integer"},"columns":{"type":"integer","minimum":1,"isRequired":true,"uniqueKey":"result.oneOf.4.grid.columns","typeLabel":"integer"},"cells":{"type":"integer","minimum":0,"maximum":65536,"isRequired":true,"uniqueKey":"result.oneOf.4.grid.cells","typeLabel":"integer"},"min":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.4.grid.min.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.4.grid.min.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.4.grid.min","typeLabel":"number | null"},"max":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"result.oneOf.4.grid.max.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"result.oneOf.4.grid.max.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"result.oneOf.4.grid.max","typeLabel":"number | null"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.grid.message","typeLabel":"string"}},"required":["map_id","rows","columns","cells","min","max","message"],"isRequired":true,"uniqueKey":"result.oneOf.4.grid","typeLabel":"object"},"notices":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.notices.items.[INDEX].code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.notices.items.[INDEX].message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"result.oneOf.4.notices.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result.oneOf.4.notices","typeLabel":"object[]"},"identification":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["identified","review_required","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.4.identification.status","typeLabel":"enum\u003cstring>"},"confidence":{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["high","medium","low","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.4.identification.confidence.level","typeLabel":"enum\u003cstring>"},"explanation":{"type":"string","description":"Short evidence explanation. This is not a probability or flashing-safety assessment.","isRequired":true,"uniqueKey":"result.oneOf.4.identification.confidence.explanation","typeLabel":"string"}},"required":["level","explanation"],"isRequired":true,"uniqueKey":"result.oneOf.4.identification.confidence","typeLabel":"object"},"manufacturer":{"type":"string","description":"ECU manufacturer, when established.","uniqueKey":"result.oneOf.4.identification.manufacturer","typeLabel":"string"},"family":{"type":"string","description":"ECU family, when established.","uniqueKey":"result.oneOf.4.identification.family","typeLabel":"string"},"variant":{"type":"string","description":"Specific ECU variant or model; not the vehicle model.","uniqueKey":"result.oneOf.4.identification.variant","typeLabel":"string"},"software":{"type":"string","description":"Software identifier or version extracted from supported evidence.","uniqueKey":"result.oneOf.4.identification.software","typeLabel":"string"},"hardware":{"type":"string","description":"Hardware identifier or number extracted from supported evidence.","uniqueKey":"result.oneOf.4.identification.hardware","typeLabel":"string"},"calibration_id":{"type":"string","description":"Supported calibration identifier, when established.","uniqueKey":"result.oneOf.4.identification.calibration_id","typeLabel":"string"},"part_number":{"type":"string","description":"Supported OEM part number, when established.","uniqueKey":"result.oneOf.4.identification.part_number","typeLabel":"string"},"byte_order":{"type":"string","enum":["big","little"],"description":"Detected ECU byte order, when established for an accepted identity.","uniqueKey":"result.oneOf.4.identification.byte_order","typeLabel":"enum\u003cstring>"},"cell_width_bytes":{"type":"integer","enum":[1,2,4],"description":"Detected ECU cell width; individual candidate descriptors can use another width.","uniqueKey":"result.oneOf.4.identification.cell_width_bytes","typeLabel":"enum\u003cinteger>"}},"required":["status","confidence"],"uniqueKey":"result.oneOf.4.identification","typeLabel":"object"},"condition":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["review_recommended","no_issues_detected","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.4.condition.status","typeLabel":"enum\u003cstring>"},"coverage":{"type":"string","enum":["complete","partial","unavailable"],"description":"complete means all listed supported checks were evaluated; it does not mean every possible ECU check is supported.","isRequired":true,"uniqueKey":"result.oneOf.4.condition.coverage","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.condition.message","typeLabel":"string"},"checks":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","enum":["embedded_erased_regions","map_count_envelope","axis_plausibility","supported_checksums"],"isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].code","typeLabel":"enum\u003cstring>"},"title":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].title","typeLabel":"string"},"status":{"type":"string","enum":["no_issues_detected","review_recommended","unavailable"],"isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].message","typeLabel":"string"},"evidence":{"type":"object","additionalProperties":false,"properties":{"erased_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.erased_region_count","typeLabel":"integer"},"embedded_region_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.embedded_region_count","typeLabel":"integer"},"erased_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.erased_bytes","typeLabel":"integer"},"embedded_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.embedded_bytes","typeLabel":"integer"},"minimum_region_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.minimum_region_bytes","typeLabel":"integer"},"interior_margin_bytes":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.interior_margin_bytes","typeLabel":"integer"},"candidate_count":{"type":"integer","minimum":0,"description":"High-score health-scan candidates, distinct from maps.available. Expected min/max are a heuristic, not verified map counts.","uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.candidate_count","typeLabel":"integer"},"expected_min":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.expected_min","typeLabel":"integer"},"expected_max":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.expected_max","typeLabel":"integer"},"table_count":{"type":"integer","minimum":0,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.table_count","typeLabel":"integer"},"checked_axis_count":{"type":"integer","minimum":0,"description":"Present only when the engine reports the checked total. A warning may report flagged_axis_count without this total.","uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.checked_axis_count","typeLabel":"integer"},"flagged_axis_count":{"type":"integer","minimum":0,"description":"Suspicious axes across table_count high-score tables. Does not imply every detected axis was checked.","uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.flagged_axis_count","typeLabel":"integer"},"relation":{"type":"string","enum":["below","within","above"],"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.relation","typeLabel":"enum\u003cstring>"},"locations_available":{"type":"boolean","enum":[false],"description":"Reliable locations of suspicious axes are unavailable; no affected-axis addresses are inferred.","uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.locations_available","typeLabel":"enum\u003cboolean>"},"reason":{"type":"string","enum":["unknown_family","no_family_envelope","no_high_score_tables","supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.reason","typeLabel":"enum\u003cstring>"},"regions":{"type":"array","items":{"type":"object","additionalProperties":false,"properties":{"kind":{"type":"string","enum":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].kind","typeLabel":"enum\u003cstring>"},"start":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].start","typeLabel":"integer"},"end":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].end","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].size_bytes","typeLabel":"integer"},"high_score_candidate_count":{"type":"integer","minimum":0,"description":"High-score candidates used by layout classification; separate from the paginated discovery list.","uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].high_score_candidate_count","typeLabel":"integer"},"fill_byte":{"oneOf":[{"type":"integer","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.0","typeLabel":"integer"},{"type":"null","minimum":0,"maximum":255,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_byte","typeLabel":"integer | null"},"fill_ratio":{"type":"number","minimum":0,"maximum":1,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX].fill_ratio","typeLabel":"number"}},"required":["kind","start","end","size_bytes"],"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions.items.[INDEX]","typeLabel":"object"},"maxItems":200,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence.regions","typeLabel":"object[]"}},"description":"Only measured fields applicable to the check are present. Internal erased-region locations appear in details when saved layout evidence is available.","isRequired":true,"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX].evidence","typeLabel":"object"}},"required":["code","title","status","message","evidence"],"uniqueKey":"result.oneOf.4.condition.checks.items.[INDEX]","typeLabel":"object"},"maxItems":4,"uniqueKey":"result.oneOf.4.condition.checks","typeLabel":"object[]"}},"required":["status","coverage","message"],"uniqueKey":"result.oneOf.4.condition","typeLabel":"object"},"checksums":{"type":"object","additionalProperties":false,"properties":{"status":{"type":"string","enum":["passed","failed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.4.checksums.status","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.checksums.message","typeLabel":"string"},"reason":{"type":"string","enum":["supported_checks_passed","supported_checks_failed","no_supported_scheme_detected","coverage_unavailable"],"uniqueKey":"result.oneOf.4.checksums.reason","typeLabel":"enum\u003cstring>"}},"required":["status","message"],"uniqueKey":"result.oneOf.4.checksums","typeLabel":"object"},"maps":{"type":"object","additionalProperties":false,"properties":{"available":{"type":"integer","minimum":0,"description":"Total detected candidates in this scan; not a count of verified calibration maps.","isRequired":true,"uniqueKey":"result.oneOf.4.maps.available","typeLabel":"integer"},"returned":{"type":"integer","minimum":0,"maximum":200,"description":"Candidates on this details page, or in the default page for a compact report.","isRequired":true,"uniqueKey":"result.oneOf.4.maps.returned","typeLabel":"integer"},"omitted":{"type":"integer","minimum":0,"description":"Available minus returned: candidates outside this page, including earlier pages. Follow pagination.next_offset rather than omitted to find the next page.","isRequired":true,"uniqueKey":"result.oneOf.4.maps.omitted","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.maps.message","typeLabel":"string"},"axes_count":{"type":"integer","minimum":0,"description":"Detected axes before layout filtering; not the number assessed by axis plausibility.","uniqueKey":"result.oneOf.4.maps.axes_count","typeLabel":"integer"},"detected_before_layout":{"type":"integer","minimum":0,"description":"All structural candidates before layout filtering; equals available + excluded_by_layout.","uniqueKey":"result.oneOf.4.maps.detected_before_layout","typeLabel":"integer"},"excluded_by_layout":{"type":"integer","minimum":0,"description":"Candidates excluded by layout filtering; separate from pagination omission.","uniqueKey":"result.oneOf.4.maps.excluded_by_layout","typeLabel":"integer"},"layout_filtered":{"type":"boolean","uniqueKey":"result.oneOf.4.maps.layout_filtered","typeLabel":"boolean"},"artifact":{"type":"object","additionalProperties":false,"properties":{"schema_version":{"type":"string","enum":["remapdb.ecu.maps.v1"],"isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.schema_version","typeLabel":"enum\u003cstring>"},"download_url":{"type":"string","description":"Stable authenticated API endpoint. Returns a 302 redirect to a fresh signed storage URL. Never send your API token to the redirect destination.","isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.download_url","typeLabel":"string"},"media_type":{"type":"string","enum":["application/json"],"isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.media_type","typeLabel":"enum\u003cstring>"},"content_encoding":{"type":"string","enum":["gzip"],"isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.content_encoding","typeLabel":"enum\u003cstring>"},"map_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.map_count","typeLabel":"integer"},"size_bytes":{"type":"integer","minimum":0,"maximum":16777216,"description":"Exact decoded UTF-8 JSON bytes, after HTTP gzip decompression.","isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.size_bytes","typeLabel":"integer"},"compressed_size_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.compressed_size_bytes","typeLabel":"integer"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$","description":"SHA-256 of the decoded JSON bytes, not the gzip container.","isRequired":true,"uniqueKey":"result.oneOf.4.maps.artifact.sha256","typeLabel":"string"}},"required":["schema_version","download_url","media_type","content_encoding","map_count","size_bytes","compressed_size_bytes","sha256"],"description":"Immutable public map artifact generated once by the worker, retained until the parent job expires. Missing on older jobs. Contains descriptors, not all grid cell values.","uniqueKey":"result.oneOf.4.maps.artifact","typeLabel":"object"}},"required":["available","returned","omitted","message"],"uniqueKey":"result.oneOf.4.maps","typeLabel":"object"},"comparison":{"type":"object","additionalProperties":false,"properties":{"identical":{"type":"boolean","isRequired":true,"uniqueKey":"result.oneOf.4.comparison.identical","typeLabel":"boolean"},"changed_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.changed_bytes","typeLabel":"integer"},"changed_overlap_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.changed_overlap_bytes","typeLabel":"integer"},"reference_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.reference_tail_bytes","typeLabel":"integer"},"comparison_tail_bytes":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.comparison_tail_bytes","typeLabel":"integer"},"changed_map_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.changed_map_candidates","typeLabel":"integer"},"unmatched_reference_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.unmatched_reference_candidates","typeLabel":"integer"},"unmatched_comparison_candidates":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.comparison.unmatched_comparison_candidates","typeLabel":"integer"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.comparison.message","typeLabel":"string"},"realigned_map_candidates":{"type":"integer","minimum":0,"description":"Candidate matches whose cell windows were shifted. These comparisons can miss edge changes; zero changed_map_candidates does not imply no bytes changed inside candidate regions. Older saved compact reports may omit this field.","uniqueKey":"result.oneOf.4.comparison.realigned_map_candidates","typeLabel":"integer"}},"required":["identical","changed_bytes","changed_overlap_bytes","reference_tail_bytes","comparison_tail_bytes","changed_map_candidates","unmatched_reference_candidates","unmatched_comparison_candidates","message"],"uniqueKey":"result.oneOf.4.comparison","typeLabel":"object"},"layout":{"type":"object","additionalProperties":false,"properties":{"file_size_bytes":{"type":"integer","minimum":0,"maximum":8388608,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.file_size_bytes","typeLabel":"integer"},"region_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.region_count","typeLabel":"integer"},"bytes_by_kind":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.bytes_by_kind.code","typeLabel":"integer"},"calibration":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.bytes_by_kind.calibration","typeLabel":"integer"},"erased":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.bytes_by_kind.erased","typeLabel":"integer"},"mixed":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.bytes_by_kind.mixed","typeLabel":"integer"},"unknown":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.bytes_by_kind.unknown","typeLabel":"integer"}},"required":["code","calibration","erased","mixed","unknown"],"isRequired":true,"uniqueKey":"result.oneOf.4.layout.bytes_by_kind","typeLabel":"object"},"identification_block_count":{"type":"integer","minimum":0,"isRequired":true,"uniqueKey":"result.oneOf.4.layout.identification_block_count","typeLabel":"integer"},"offsets":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.layout.offsets","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"result.oneOf.4.layout.message","typeLabel":"string"}},"required":["file_size_bytes","region_count","bytes_by_kind","identification_block_count","offsets","message"],"uniqueKey":"result.oneOf.4.layout","typeLabel":"object"}},"additionalProperties":false,"uniqueKey":"result.oneOf.4","typeLabel":"object"}],"uniqueKey":"result","typeLabel":"object"},"error":{"type":"object","additionalProperties":false,"properties":{"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"required":["code","message"],"uniqueKey":"error","typeLabel":"object"}},"required":["job_id","operation","status","message","created_at","expires_at","status_url"],"uniqueKey":"","typeLabel":"object"},"example":{"job_id":"22222222-2222-4222-8222-222222222222","operation":"inspect","status":"queued","message":"Your file is waiting to be analyzed.","created_at":"2026-11-11T12:01:00Z","expires_at":null,"status_url":"/v2/ecu/jobs/22222222-2222-4222-8222-222222222222"},"examples":{"Example":{"title":"Example","value":{"job_id":"22222222-2222-4222-8222-222222222222","operation":"inspect","status":"queued","message":"Your file is waiting to be analyzed.","created_at":"2026-11-11T12:01:00Z","expires_at":null,"status_url":"/v2/ecu/jobs/22222222-2222-4222-8222-222222222222"}}},"exampleType":"examples"}},"headers":{"Location":{"description":"Relative URL for the accepted job status.","schema":{"type":"string"}},"Retry-After":{"description":"Suggested delay in seconds before polling.","schema":{"type":"integer","minimum":1}}},"exampleType":"examples"},"b6057272-4279-4d40-9de8-60f5a864060f":{"description":"Invalid request body, parameters or Idempotency-Key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"74294b11-4678-494e-bf78-b3c664d1db9b":{"description":"Missing or invalid API credentials.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a0081724-b814-4ed8-8e92-8fd079aa4ee5":{"description":"ECU observation is not enabled for this account or access is denied.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"961261b1-fa94-4c2f-b557-2e249ed8229e":{"description":"File or job not found for this account.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"a957390e-3a48-4e5a-9c97-57336d434e90":{"description":"HTTP method not supported by this endpoint.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"814dbd96-ea0d-44e4-98f0-04d86447bbb4":{"description":"Job not complete, stale scan binding or conflicting Idempotency-Key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e9b555b5-035c-4817-8a60-f2511409064f":{"description":"File or result has expired.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"35e6b6ec-0bcc-4cdd-b0c8-32f92ab68809":{"description":"Upload exceeds 8 MiB or JSON request exceeds 64 KiB.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"4054a7dc-00e8-423c-ad80-07911d962877":{"description":"Unsupported content type or file format.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1a4d47f9-fbc6-402f-850c-3e7f11837190":{"description":"Request-rate or ECU processing quota exceeded. Follow Retry-After when present.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"Suggested delay in seconds when supplied.","schema":{"type":"integer","minimum":1}}},"exampleType":"generated"},"0036153a-8698-40e2-93cd-adffb21cb634":{"description":"Observation service temporarily unavailable.","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"error":{"type":"object","additionalProperties":false,"required":["code","message"],"properties":{"code":{"type":"string","description":"Stable ECU error reason, including authentication and request-rate failures.","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"\u003cstring>","message":"\u003cstring>"}}}},"exampleType":"generated"}},"headers":{"Retry-After":{"description":"Suggested delay in seconds when supplied.","schema":{"type":"integer","minimum":1}}},"exampleType":"generated"}},"security":{"ee60e6a8-e51f-4018-8e1e-5bba98a9a7f5":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API methods require Bearer authentication.\nUse your existing API key as the bearer token.\n\nAuthorization header format: `Authorization: Bearer YOUR_API_KEY`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"1b9735ae-e90d-461d-9f84-c56b8a46a2ef":{"url":"https://api.remapdb.com/v2"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"All API methods require Bearer authentication.\nUse your existing API key as the bearer token.\n\nAuthorization header format: `Authorization: Bearer YOUR_API_KEY`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"All API methods require Bearer authentication.\nUse your existing API key as the bearer token.\n\nAuthorization header format: `Authorization: Bearer YOUR_API_KEY`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi-v2.json"},"subdomain":"remapdb","siteName":"Remapdb Docs","title":"Analyze an ECU binary - Remapdb Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T10:41:38.179Z","originalFileLocation":"api-reference/v2/ecu-observation/analyze-an-ecu-binary.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Included with active API and MAX subscriptions. Use a standard API key with vdb_read, or a restricted key with ecu_observe. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the /v2/ecu/ prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Remapdb Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Analyze an ECU binary - Remapdb Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Included with active API and MAX subscriptions. Use a standard API key with vdb_read, or a restricted key with ecu_observe. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the /v2/ecu/ prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Remapdb Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://remapdb.mintlify.site/_mintlify/api/og/v2?division=ECU+observation\u0026amp;title=Analyze+an+ECU+binary\u0026amp;description=Included+with+active+API+and+MAX+subscriptions.+Use+a+standard+API+key+with+%60vdb_read%60%2C+or+a+restricted+key+with+%60ecu_observe%60.+No+separate+account+activation+i\u0026amp;theme=e5adf7a7050609580bf0be12\u0026amp;signature=8f4572af9e9dddc832ce7da823506d6479367c5209bfa9502768a5ea9ce9848b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Analyze an ECU binary - Remapdb Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Included with active API and MAX subscriptions. Use a standard API key with vdb_read, or a restricted key with ecu_observe. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the /v2/ecu/ prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://remapdb.mintlify.site/_mintlify/api/og/v2?division=ECU+observation\u0026amp;title=Analyze+an+ECU+binary\u0026amp;description=Included+with+active+API+and+MAX+subscriptions.+Use+a+standard+API+key+with+%60vdb_read%60%2C+or+a+restricted+key+with+%60ecu_observe%60.+No+separate+account+activation+i\u0026amp;theme=e5adf7a7050609580bf0be12\u0026amp;signature=8f4572af9e9dddc832ce7da823506d6479367c5209bfa9502768a5ea9ce9848b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/remapdb/GeJG8U-IGKCLaJKw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Remapdb Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#31374A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v2/ecu-observation/analyze-an-ecu-binary.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.remapdb.com/#organization\",\"name\":\"Remapdb Docs\",\"url\":\"https://docs.remapdb.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/remapdb/kv3qo15nTX1Sjbyu/assets/branding/remapdb-logo-small-full-light.svg?fit=max\u0026auto=format\u0026n=kv3qo15nTX1Sjbyu\u0026q=85\u0026s=43a8b24bbe8a0dbd37bf83eb53389324\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.remapdb.com#website\",\"name\":\"Remapdb Docs\",\"url\":\"https://docs.remapdb.com\",\"publisher\":{\"@id\":\"https://docs.remapdb.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary#webpage\",\"url\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary\",\"name\":\"Analyze an ECU binary\",\"description\":\"Included with active API and MAX subscriptions. Use a standard API key with vdb_read, or a restricted key with ecu_observe. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the /v2/ecu/ prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.\",\"dateModified\":\"2026-11-16T10:41:38.179Z\",\"isPartOf\":{\"@id\":\"https://docs.remapdb.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API v2\",\"item\":\"https://docs.remapdb.com/api-reference/v2/subscription/active-subscription\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"ECU observation\",\"item\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/ecu-capabilities\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Analyze an ECU binary\",\"item\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary#apireference\",\"headline\":\"Analyze an ECU binary\",\"name\":\"Analyze an ECU binary\",\"description\":\"Included with active API and MAX subscriptions. Use a standard API key with vdb_read, or a restricted key with ecu_observe. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the /v2/ecu/ prefix. Use identify for identity alone or inspect for identity plus file observations. Completed unknown or review_required identifications are successful jobs. Initial result retention is seven days after completion; use the returned expiry. New map scans and inspections retain all detected candidate descriptors; limit sets the default detail page size, not the total candidate count. Inspection reports include axis plausibility, map-count expectations, erased-region totals, checksum coverage reasons, and layout summaries. Fetch /details for region offsets and map descriptors.\",\"url\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary\",\"mainEntityOfPage\":{\"@id\":\"https://docs.remapdb.com/api-reference/v2/ecu-observation/analyze-an-ecu-binary#webpage\"},\"dateModified\":\"2026-11-16T10:41:38.179Z\",\"publisher\":{\"@id\":\"https://docs.remapdb.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.remapdb.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Remapdb Docs\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Remapdb Docs\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v2/ecu-observation/analyze-an-ecu-binary.md","siteName":"Remapdb Docs","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Get Started","pages":[{"title":"Introduction","href":"/api-reference/introduction"}]},{"group":"Migration","pages":[{"title":"Migrate from API v1 to v2","href":"/api/migrate-to-v2"}]},{"group":"API v2","pages":[{"group":"API Subscription","pages":[{"title":"Active Subscription","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /subscription","href":"/api-reference/v2/subscription/active-subscription"}]},{"group":"Vehicle Types","pages":[{"title":"Vehicle Types","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /types","href":"/api-reference/v2/types/vehicle-types"}]},{"group":"Manufacturers","pages":[{"title":"Manufacturers by Type","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /manufacturers/type/{type_id}","href":"/api-reference/v2/manufacturers/manufacturers-by-type"},{"title":"Manufacturer Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /manufacturers/{manufacturer_id}","href":"/api-reference/v2/manufacturers/manufacturer-details"}]},{"group":"Models","pages":[{"title":"Models by Manufacturer","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /models/manufacturer/{manufacturer_id}","href":"/api-reference/v2/models/models-by-manufacturer"},{"title":"Model Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /models/{model_id}","href":"/api-reference/v2/models/model-details"}]},{"group":"Generations","pages":[{"title":"Generations by Model","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /generations/model/{model_id}","href":"/api-reference/v2/generations/generations-by-model"},{"title":"Generation Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /generations/{generation_id}","href":"/api-reference/v2/generations/generation-details"}]},{"group":"Engines","pages":[{"title":"Engines by Generation","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /engines/generation/{generation_id}","href":"/api-reference/v2/engines/engines-by-generation"},{"title":"Engine Details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /engines/{engine_id}","href":"/api-reference/v2/engines/engine-details"}]},{"group":"Search","pages":[{"title":"Vehicle Search","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /search","href":"/api-reference/v2/search/vehicle-search"}]},{"group":"VRM lookup","pages":[{"title":"Look up a UK registration","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /vrm/uk/lookup","href":"/api-reference/v2/vrm-lookup/look-up-a-uk-registration"},{"title":"Get account UK VRM allowance and credits","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /vrm/uk/usage","href":"/api-reference/v2/vrm-lookup/get-account-uk-vrm-allowance-and-credits"}]},{"group":"ECU observation","pages":[{"title":"ECU capabilities","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/capabilities","href":"/api-reference/v2/ecu-observation/ecu-capabilities"},{"title":"Upload an ECU binary","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/files","href":"/api-reference/v2/ecu-observation/upload-an-ecu-binary"},{"title":"Delete an ECU upload","description":"Included with active API and MAX subscriptions. Use a standard API key with `vdb_read`, or a restricted key with `ecu_observe`. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the `/v2/ecu/` prefix. Revokes new use immediately. Physical deletion waits for active processing leases. Previously saved results follow their own expiry.","deprecated":null,"version":null,"openapi":"/openapi-v2.json delete /ecu/files/{file_id}","href":"/api-reference/v2/ecu-observation/delete-an-ecu-upload"},{"title":"Analyze an ECU binary","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/analyses","href":"/api-reference/v2/ecu-observation/analyze-an-ecu-binary"},{"title":"Compare two ECU binaries","description":"Included with active API and MAX subscriptions. Use a standard API key with `vdb_read`, or a restricted key with `ecu_observe`. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the `/v2/ecu/` prefix. Reference and comparison are neutral roles; neither file is asserted to be original, tuned or compatible. Both files must belong to the account. Initial result retention is seven days after completion; use the returned expiry.","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/comparisons","href":"/api-reference/v2/ecu-observation/compare-two-ecu-binaries"},{"title":"Find candidate ECU maps","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/map-scans","href":"/api-reference/v2/ecu-observation/find-candidate-ecu-maps"},{"title":"Read a map’s cell values","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/map-grids","href":"/api-reference/v2/ecu-observation/read-a-map’s-cell-values"},{"title":"Get ECU job status","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}","href":"/api-reference/v2/ecu-observation/get-ecu-job-status"},{"title":"Get a compact ECU report","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}/result","href":"/api-reference/v2/ecu-observation/get-a-compact-ecu-report"},{"title":"Get ECU observation details","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}/details","href":"/api-reference/v2/ecu-observation/get-ecu-observation-details"},{"title":"Identify an ECU from a binary file","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /ecu/identifications","href":"/api-reference/v2/ecu-observation/identify-an-ecu-from-a-binary-file"},{"title":"Download all ECU map candidates","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /ecu/jobs/{job_id}/artifacts/maps","href":"/api-reference/v2/ecu-observation/download-all-ecu-map-candidates"}]},{"group":"DTC lookup","pages":[{"title":"Look up a DTC code","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /dtc/codes/{code}","href":"/api-reference/v2/dtc-lookup/look-up-a-dtc-code"},{"title":"Search DTC codes","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /dtc/codes","href":"/api-reference/v2/dtc-lookup/search-dtc-codes"},{"title":"Look up multiple DTC codes","deprecated":null,"version":null,"openapi":"/openapi-v2.json post /dtc/lookup","href":"/api-reference/v2/dtc-lookup/look-up-multiple-dtc-codes"},{"title":"List DTC manufacturers","deprecated":null,"version":null,"openapi":"/openapi-v2.json get /dtc/manufacturers","href":"/api-reference/v2/dtc-lookup/list-dtc-manufacturers"}]}]},{"group":"API v1 (deprecated)","pages":[{"group":"API Subscription","pages":[{"title":"Active Subscription","deprecated":true,"version":null,"openapi":"/openapi.json get /subscription","href":"/api-reference/subscription/active-subscription"}]},{"group":"Vehicle Types","pages":[{"title":"Vehicle Types","deprecated":true,"version":null,"openapi":"/openapi.json get /types","href":"/api-reference/types/vehicle-types"}]},{"group":"Manufacturers","pages":[{"title":"Manufacturers by Type","deprecated":true,"version":null,"openapi":"/openapi.json get /manufacturers/type/{type_id}","href":"/api-reference/manufacturers/manufacturers-by-type"},{"title":"Manufacturer Details","deprecated":true,"version":null,"openapi":"/openapi.json get /manufacturers/{manufacturer_id}","href":"/api-reference/manufacturers/manufacturer-details"}]},{"group":"Models","pages":[{"title":"Models by Manufacturer","deprecated":true,"version":null,"openapi":"/openapi.json get /models/manufacturer/{manufacturer_id}","href":"/api-reference/models/models-by-manufacturer"},{"title":"Model Details","deprecated":true,"version":null,"openapi":"/openapi.json get /models/{model_id}","href":"/api-reference/models/model-details"}]},{"group":"Generations","pages":[{"title":"Generations by Model","deprecated":true,"version":null,"openapi":"/openapi.json get /generations/model/{model_id}","href":"/api-reference/generations/generations-by-model"},{"title":"Generation Details","deprecated":true,"version":null,"openapi":"/openapi.json get /generations/{generation_id}","href":"/api-reference/generations/generation-details"}]},{"group":"Engines","pages":[{"title":"Engines by Generation","deprecated":true,"version":null,"openapi":"/openapi.json get /engines/generation/{generation_id}","href":"/api-reference/engines/engines-by-generation"},{"title":"Engine Details","deprecated":true,"version":null,"openapi":"/openapi.json get /engines/{engine_id}","href":"/api-reference/engines/engine-details"}]},{"group":"Search","pages":[{"title":"Vehicle Search","deprecated":true,"version":null,"openapi":"/openapi.json get /search","href":"/api-reference/search/vehicle-search"}]}]}]}]},"basePath":"","title":"Analyze an ECU binary - Remapdb Docs","buildId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","deploymentId":"dpl_GRSyrvXT6FFTpZZTGz5iZPp3D2zE","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-BFmjTMeT.js","utils-BWr-sjpP.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-LafIDf0N.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-MJNzuxek.js","snippetPresets-DPZEtUvW.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-CWFqNdGh.js","ApiExamples-DQ2UhGIs.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DUUJTUkE.js","shallow-BTf5bw35.js","getApiPlaygroundDisplay-h2POYYOO.js","CodeSnippet-C4qEftRe.js","CodeSnippets-CsSrOqMC.js","getPastedJson-DU6W6y78.js","icon-2ZYNQ78y.js","MethodPill-BMXJzYMm.js","DuplicateIcon-DNjdEpYZ.js","createIcon-WdPVhKxl.js","DynamicMarkdown-Z_y464fM.js","SectionHeading-Bcrd8azU.js","axios-vUo_bRtp.js","Markdown-BnvucbFu.js","dist-D7YyC486.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-D1I8TPjt.js"]}