> ## Documentation Index
> Fetch the complete documentation index at: https://docs.remapdb.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get ECU observation details

> Included with active API and MAX subscriptions. Use a standard API key with `vdb_read`, or a restricted key with `ecu_read`. No separate account activation is required. Catalog-only trials are not eligible. All ECU URLs use the `/v2/ecu/` prefix. Expanded public map, grid or comparison observations for a completed job. Use the compact report for routine polling. This endpoint does not return internal diagnostics or direct storage links. For maps and inspect jobs, offset (default 0) and limit (1–200, default the submitted limit) page the immutable stored descriptors. Follow maps.pagination.next_offset until null; reads do not rerun analysis. Pagination parameters on other operations are rejected. Older truncated reports set rescan_required=true; submit a new scan with a new idempotency key to recover all candidates. An offset beyond the retained list returns empty items and no next offset. Paging remains available until result expiry, independently of input expiry. Inspection details include flash-layout regions, identification-block locations, and internal erased-region ranges alongside structured health-check counts. Reading details does not run analysis again.



## OpenAPI

````yaml /openapi-v2.json get /ecu/jobs/{job_id}/details
openapi: 3.0.0
info:
  title: Remapdb API v2
  description: >-
    Vehicle Tuning Database API - For Tuning services and Tuners.


    Access comprehensive vehicle details, including types, manufacturers,
    models, engines, ECU and TCU info, tuning tools, dyno charts, and available
    tuning or remap stages with their performance gains.



    REST v2 uses the same Bearer API keys as v1. Account customizations apply
    only when the subscription has Customizations access. Cache catalog
    responses by API version, account, language and catalog profile, never by
    entity ID alone. IDs and cursors remain numeric and can exceed 32-bit
    integers; support integers through 9007199254740991. Identify stages by id,
    not stage_number. Manufacturer logos may be null; custom logos and
    generation photos use durable CDN object URLs. See
    https://docs.remapdb.com/api/migrate-to-v2.


    Private catalog slugs use rdb-brand-{id}, rdb-make-{id}, rdb-gen-{id}, and
    rdb-engine-{id}. Legacy rdb-private-{entity}-{id} links continue to resolve.


    Create and name up to 10 active key/secret pairs in API > API keys. All
    pairs share the same subscription and entitlements. Use only the key as the
    bearer token; this header does not require the secret. Rotation or
    revocation invalidates the selected key on subsequent requests, including
    existing MCP sessions. Other keys remain valid.


    Account activity is available in the Remapdb app under API > API usage.
    Request logging records account/key identifiers, normalized endpoint, status
    and duration; new logs exclude credential values and request payloads. See
    https://docs.remapdb.com/api/usage-and-monitoring.
  termsOfService: https://remapdb.com/terms
  contact:
    name: Remapdb.com
    url: https://remapdb.com
  version: 2.0.0
  x-logo:
    url: https://cdn.remapdb.com/logos/remapdb-logo-default-full-light.svg
    altText: Remapdb REST API Documentation
servers:
  - url: https://api.remapdb.com/v2
security:
  - bearerAuth: []
tags:
  - name: Response and Errors
    description: >-
      - API will always respond with json, content type: **application/json**.

      - Successfull response will return HTTP **2XX** ***(Success)*** response
      code.

      - Error response will return either HTTP **4XX** ***(Client Error)*** or
      HTTP **5XX** ***(Server Error)***.


      On error, API will return error object. It will contain the appropriate
      error **code** *(integer)* and a **message** *(string)*.

      The HTTP response code will be the same as the error code.


      Error Schema:

      ```json json_schema

      {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer"
          },
          "message": {
            "type": "string"
          }
        }
      }

      ```


      Error Example:

      ```json http

      {
        "code": 404,
        "message": "Method doesnt exist."
      }

      ```



      DTC and ECU endpoints instead use a structured `{error: {code: string,
      message: string}}` envelope; see their operation schemas.
    x-traitTag: true
  - name: Language
    description: >-
      All API methods accept custom language. It can be set via the
      **"Accept-Language"** header. Content of the header should be the code of
      the language you are requesting.


      #### Available languages:

      Code | Name

      ---------|----------
       `bg` | Bulgarian
       `da` | Danish
       `de` | German
       `en` | English **(default)**
       `es` | Spanish
       `et` | Estonian
       `fi` | Finnish
       `fr` | French
       `hr` | Croatian
       `hu` | Hungarian
       `it` | Italian
       `lt` | Lithuanian
       `lv` | Latvian
       `nb` | Norwegian Bokmål
       `nl` | Dutch
       `nn` | Norwegian Nynorsk
       `pt` | Portuguese
       `ru` | Russian
       `sv` | Swedish
       `tr` | Turkish
       `zs` | Chinese

      If no "accept-language" header is set, the API will use the default
      language - English.


      Following example shows how to set the language to Dutch (`nl`) using
      curl:

      ```json http

      curl 'https://api.remapdb.com/v1/search?query=audi' \

      --header 'Accept-Language: nl'

      ```



      DTC dictionary descriptions are returned as stored and are not translated.
    x-traitTag: true
  - name: Rate Limits
    description: >-
      All active API keys on an account share one request allowance across REST
      v1, REST v2 and MCP. The standard allowance is 120 requests per minute.
      Creating or rotating keys does not reset it. API v2 returns HTTP 429 when
      the limit is reached; retry after the current minute window. UK lookup
      credits and ECU job/storage quotas are also shared by the account.
    x-traitTag: true
  - name: Client SDKs
    description: >
      Remapdb offers OpenAPI v3 specification which can be used with any
      OpenAPI/Swagger client generator to generate your own client SDK.

      Download OpenAPI specification:
      [https://docs.remapdb.com/openapi.json](https://docs.remapdb.com/openapi.json).



      Following SDK's are automatically generated:

      Language | Link

      ----------|----------

      PHP |
      [https://github.com/remapdb-api/remapdb-php-sdk](https://github.com/remapdb-api/remapdb-php-sdk)

      JavaScript |
      [https://github.com/remapdb-api/remapdb-js-sdk](https://github.com/remapdb-api/remapdb-js-sdk)
    x-traitTag: true
  - name: Subscription
    description: >
      Most of the API methods require an active API subscription. The following
      method allows you to obtain information about your current API
      subscription.


      More info about Remapdb's API subscription can be found here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)
    x-displayName: API Subscription
  - name: Types
    description: >
      Obtain information about the vehicle types. 


      **Active API subscription required. Get it here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)**
    x-displayName: Vehicle Types
  - name: Manufacturers
    description: >
      Obtain information about vehicle manufacturers. 


      **Active API subscription required. Get it here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)**
  - name: Models
    description: >
      Obtain information about vehicle models. 


      **Active API subscription required. Get it here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)**
  - name: Generations
    description: >
      Obtain information about model generations. 


      **Active API subscription required. Get it here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)**      
  - name: Engines
    description: >
      Obtain information about vehicle engines. 


      **Active API subscription required. Get it here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)**     
  - name: Search
    description: >
      Searches through manufacturers, models, generations and engines. 


      **Active API subscription required. Get it here:
      [https://app.remapdb.com/api](https://app.remapdb.com/api)**
  - name: VRM lookup
    description: >-
      Ordinary UK VRM lookup requires an active API or MAX full API
      subscription, vdb_read scope and VRM entitlement. Designated saved test
      registrations are free through REST on every plan with a valid scoped API
      key, including trials. Widgets have separate access: Free accounts can use
      purchased credits with zero included allowance.
  - name: ECU observation
    description: >-
      Controlled-access, observation-only binary analysis under /ecu/. Jobs are
      asynchronous; reports are concise and account-scoped.
  - name: DTC lookup
    description: >-
      Synchronous diagnostic-code dictionary lookup included with every active
      API or MAX full API subscription. Requires vdb_read. No worker, lookup
      credits or ECU rollout access required. Descriptions are stored reference
      text, not diagnosis or verified vehicle applicability; not translated by
      Accept-Language.
paths:
  /ecu/jobs/{job_id}/details:
    get:
      tags:
        - ECU observation
      summary: Get ECU observation details
      description: >-
        Included with active API and MAX subscriptions. Use a standard API key
        with `vdb_read`, or a restricted key with `ecu_read`. No separate
        account activation is required. Catalog-only trials are not eligible.
        All ECU URLs use the `/v2/ecu/` prefix. Expanded public map, grid or
        comparison observations for a completed job. Use the compact report for
        routine polling. This endpoint does not return internal diagnostics or
        direct storage links. For maps and inspect jobs, offset (default 0) and
        limit (1–200, default the submitted limit) page the immutable stored
        descriptors. Follow maps.pagination.next_offset until null; reads do not
        rerun analysis. Pagination parameters on other operations are rejected.
        Older truncated reports set rescan_required=true; submit a new scan with
        a new idempotency key to recover all candidates. An offset beyond the
        retained list returns empty items and no next offset. Paging remains
        available until result expiry, independently of input expiry. Inspection
        details include flash-layout regions, identification-block locations,
        and internal erased-region ranges alongside structured health-check
        counts. Reading details does not run analysis again.
      operationId: ecu_job_details
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: Opaque account-owned identifier.
        - name: offset
          in: query
          required: false
          description: Zero-based candidate index in this completed map scan or inspection.
          schema:
            type: integer
            minimum: 0
            maximum: 2147483647
            default: 0
        - name: limit
          in: query
          required: false
          description: >-
            Candidates per page. Defaults to the submitted scan limit (normally
            20); may be changed between reads. Map/inspection jobs only.
          schema:
            type: integer
            minimum: 1
            maximum: 200
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ecu_details'
        '400':
          $ref: '#/components/responses/ecu_error_400'
        '401':
          $ref: '#/components/responses/ecu_error_401'
        '403':
          $ref: '#/components/responses/ecu_error_403'
        '404':
          $ref: '#/components/responses/ecu_error_404'
        '405':
          $ref: '#/components/responses/ecu_error_405'
        '409':
          $ref: '#/components/responses/ecu_error_409'
        '410':
          $ref: '#/components/responses/ecu_error_410'
        '429':
          $ref: '#/components/responses/ecu_error_429'
        '503':
          $ref: '#/components/responses/ecu_error_503'
      security:
        - bearerAuth: []
components:
  schemas:
    ecu_details:
      type: object
      additionalProperties: false
      properties:
        operation:
          type: string
          enum:
            - identify
            - inspect
            - maps
            - map-grid
            - diff
        message:
          type: string
        identification:
          $ref: '#/components/schemas/ecu_identification'
        condition:
          type: object
          additionalProperties: false
          properties:
            status:
              type: string
              enum:
                - review_recommended
                - no_issues_detected
                - unavailable
            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.
            message:
              type: string
            checks:
              type: array
              items:
                $ref: '#/components/schemas/ecu_inspection_check'
              maxItems: 4
          required:
            - status
            - coverage
            - message
        checksums:
          type: object
          additionalProperties: false
          properties:
            status:
              type: string
              enum:
                - passed
                - failed
                - unknown
            message:
              type: string
            reason:
              type: string
              enum:
                - supported_checks_passed
                - supported_checks_failed
                - no_supported_scheme_detected
                - coverage_unavailable
          required:
            - status
            - message
        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.
            returned:
              type: integer
              minimum: 0
              maximum: 200
              description: >-
                Candidates on this details page, or in the default page for a
                compact report.
            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.
            message:
              type: string
            items:
              type: array
              items:
                $ref: '#/components/schemas/ecu_map_descriptor'
              maxItems: 200
            pagination:
              $ref: '#/components/schemas/ecu_map_pagination'
            axes_count:
              type: integer
              minimum: 0
              description: >-
                Detected axes before layout filtering; not the number assessed
                by axis plausibility.
            detected_before_layout:
              type: integer
              minimum: 0
              description: >-
                All structural candidates before layout filtering; equals
                available + excluded_by_layout.
            excluded_by_layout:
              type: integer
              minimum: 0
              description: >-
                Candidates excluded by layout filtering; separate from
                pagination omission.
            layout_filtered:
              type: boolean
            artifact:
              $ref: '#/components/schemas/ecu_map_artifact_metadata'
          required:
            - available
            - returned
            - omitted
            - message
            - items
            - pagination
        comparison:
          type: object
          additionalProperties: false
          properties:
            identical:
              type: boolean
            changed_bytes:
              type: integer
              minimum: 0
            changed_overlap_bytes:
              type: integer
              minimum: 0
            reference_tail_bytes:
              type: integer
              minimum: 0
            comparison_tail_bytes:
              type: integer
              minimum: 0
            changed_map_candidates:
              type: integer
              minimum: 0
            unmatched_reference_candidates:
              type: integer
              minimum: 0
            unmatched_comparison_candidates:
              type: integer
              minimum: 0
            message:
              type: string
            items:
              type: array
              items:
                type: object
                additionalProperties: false
                properties:
                  reference_offset:
                    type: integer
                    minimum: 0
                  comparison_offset:
                    type: integer
                    minimum: 0
                  rows:
                    type: integer
                    minimum: 1
                  columns:
                    type: integer
                    minimum: 1
                  changed_cells:
                    type: integer
                    minimum: 0
                  total_cells:
                    type: integer
                    minimum: 0
                  realigned:
                    type: boolean
                    description: >-
                      The matcher shifted a cell window; offsets refer to the
                      compared window, not necessarily the scan descriptor
                      start.
                required:
                  - reference_offset
                  - comparison_offset
                  - rows
                  - columns
                  - changed_cells
                  - total_cells
                  - realigned
              maxItems: 200
            returned:
              type: integer
              minimum: 0
              maximum: 200
            omitted:
              type: integer
              minimum: 0
            offsets:
              type: 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.
          required:
            - identical
            - changed_bytes
            - changed_overlap_bytes
            - reference_tail_bytes
            - comparison_tail_bytes
            - changed_map_candidates
            - unmatched_reference_candidates
            - unmatched_comparison_candidates
            - message
            - items
            - returned
            - omitted
            - offsets
        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.
            rows:
              type: integer
              minimum: 1
            columns:
              type: integer
              minimum: 1
            cells:
              type: integer
              minimum: 0
              maximum: 65536
            min:
              type: number
              nullable: true
            max:
              type: number
              nullable: true
            message:
              type: string
            values:
              type: array
              items:
                type: array
                items:
                  type: integer
                  minimum: 0
                  maximum: 65535
              description: Raw unsigned cell values, with at most 65,536 cells in total.
            axes:
              type: object
              additionalProperties: false
              properties:
                x:
                  type: array
                  items:
                    type: integer
                    minimum: 0
                    maximum: 65535
                  nullable: true
                'y':
                  type: array
                  items:
                    type: integer
                    minimum: 0
                    maximum: 65535
                  nullable: true
              required:
                - x
                - 'y'
          required:
            - map_id
            - rows
            - columns
            - cells
            - min
            - max
            - message
            - values
            - axes
        notices:
          type: array
          items:
            type: object
            additionalProperties: false
            properties:
              code:
                type: string
              message:
                type: string
            required:
              - code
              - message
        layout:
          $ref: '#/components/schemas/ecu_layout_details'
      required:
        - operation
        - message
        - notices
      description: >-
        Expanded public observations. Map names, units and scaling remain
        unknown; raw grid values are not physical measurements. Internal
        evidence is never returned. 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.
      oneOf:
        - properties:
            operation:
              type: string
              enum:
                - identify
          required:
            - identification
        - properties:
            operation:
              type: string
              enum:
                - inspect
          required:
            - identification
            - condition
            - checksums
            - maps
        - properties:
            operation:
              type: string
              enum:
                - maps
          required:
            - maps
        - properties:
            operation:
              type: string
              enum:
                - diff
          required:
            - comparison
        - properties:
            operation:
              type: string
              enum:
                - map-grid
          required:
            - grid
    ecu_identification:
      type: object
      additionalProperties: false
      properties:
        status:
          type: string
          enum:
            - identified
            - review_required
            - unknown
        manufacturer:
          type: string
          description: ECU manufacturer, when established.
        family:
          type: string
          description: ECU family, when established.
        variant:
          type: string
          description: Specific ECU variant or model; not the vehicle model.
        software:
          type: string
          description: Software identifier or version extracted from supported evidence.
        hardware:
          type: string
          description: Hardware identifier or number extracted from supported evidence.
        calibration_id:
          type: string
          description: Supported calibration identifier, when established.
        part_number:
          type: string
          description: Supported OEM part number, when established.
        confidence:
          $ref: '#/components/schemas/ecu_confidence'
        byte_order:
          type: string
          enum:
            - big
            - little
          description: Detected ECU byte order, when established for an accepted identity.
        cell_width_bytes:
          type: integer
          enum:
            - 1
            - 2
            - 4
          description: >-
            Detected ECU cell width; individual candidate descriptors can use
            another width.
      required:
        - status
        - confidence
    ecu_inspection_check:
      type: object
      additionalProperties: false
      properties:
        code:
          type: string
          enum:
            - embedded_erased_regions
            - map_count_envelope
            - axis_plausibility
            - supported_checksums
        title:
          type: string
        status:
          type: string
          enum:
            - no_issues_detected
            - review_recommended
            - unavailable
        message:
          type: string
        evidence:
          $ref: '#/components/schemas/ecu_inspection_evidence'
      required:
        - code
        - title
        - status
        - message
        - evidence
    ecu_map_descriptor:
      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.
        offset:
          type: integer
          minimum: 0
        rows:
          type: integer
          minimum: 1
        columns:
          type: integer
          minimum: 1
        cell_width_bytes:
          type: integer
          minimum: 0
          enum:
            - 1
            - 2
        byte_order:
          type: string
          enum:
            - little
            - big
            - unknown
        name:
          type: string
          nullable: true
          enum:
            - null
        units:
          type: string
          nullable: true
          enum:
            - null
        scaling:
          type: number
          nullable: true
          enum:
            - null
      required:
        - map_id
        - offset
        - rows
        - columns
        - cell_width_bytes
        - byte_order
        - name
        - units
        - scaling
    ecu_map_pagination:
      type: object
      additionalProperties: false
      properties:
        offset:
          type: integer
          minimum: 0
        limit:
          type: integer
          minimum: 1
          maximum: 200
        next_offset:
          type: integer
          minimum: 0
          nullable: true
          description: Next offset for this job; null when the retained list is exhausted.
        has_more:
          type: boolean
        retained:
          type: integer
          minimum: 0
          description: Number of descriptors stored in this job.
        rescan_required:
          type: boolean
          description: >-
            An older truncated result omitted descriptors before storage. Submit
            a new scan with a new idempotency key to retrieve all candidates.
      required:
        - offset
        - limit
        - next_offset
        - has_more
        - retained
        - rescan_required
    ecu_map_artifact_metadata:
      type: object
      additionalProperties: false
      properties:
        schema_version:
          type: string
          enum:
            - remapdb.ecu.maps.v1
        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.
        media_type:
          type: string
          enum:
            - application/json
        content_encoding:
          type: string
          enum:
            - gzip
        map_count:
          type: integer
          minimum: 0
        size_bytes:
          type: integer
          minimum: 0
          maximum: 16777216
          description: Exact decoded UTF-8 JSON bytes, after HTTP gzip decompression.
        compressed_size_bytes:
          type: integer
          minimum: 0
        sha256:
          type: string
          pattern: ^[a-f0-9]{64}$
          description: SHA-256 of the decoded JSON bytes, not the gzip container.
      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.
    ecu_layout_details:
      type: object
      additionalProperties: false
      properties:
        file_size_bytes:
          type: integer
          minimum: 0
          maximum: 8388608
        region_count:
          type: integer
          minimum: 0
        bytes_by_kind:
          type: object
          additionalProperties: false
          properties:
            code:
              type: integer
              minimum: 0
            calibration:
              type: integer
              minimum: 0
            erased:
              type: integer
              minimum: 0
            mixed:
              type: integer
              minimum: 0
            unknown:
              type: integer
              minimum: 0
          required:
            - code
            - calibration
            - erased
            - mixed
            - unknown
        identification_block_count:
          type: integer
          minimum: 0
        offsets:
          type: string
        message:
          type: string
        regions:
          type: array
          items:
            $ref: '#/components/schemas/ecu_layout_region'
          maxItems: 200
        identification_blocks:
          type: array
          items:
            $ref: '#/components/schemas/ecu_inspection_range'
          maxItems: 200
        returned_identification_blocks:
          type: integer
          minimum: 0
          maximum: 200
        omitted_identification_blocks:
          type: integer
          minimum: 0
      required:
        - file_size_bytes
        - region_count
        - bytes_by_kind
        - identification_block_count
        - offsets
        - message
        - regions
        - identification_blocks
        - returned_identification_blocks
        - omitted_identification_blocks
      description: >-
        All classified layout regions, with identification-block ranges capped
        at 200 and explicit omitted counts. No identification-block text is
        returned.
    ecu_error:
      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.
            message:
              type: string
      required:
        - error
    ecu_confidence:
      type: object
      additionalProperties: false
      properties:
        level:
          type: string
          enum:
            - high
            - medium
            - low
            - unknown
        explanation:
          type: string
          description: >-
            Short evidence explanation. This is not a probability or
            flashing-safety assessment.
      required:
        - level
        - explanation
    ecu_inspection_evidence:
      type: object
      additionalProperties: false
      properties:
        erased_region_count:
          type: integer
          minimum: 0
        embedded_region_count:
          type: integer
          minimum: 0
        erased_bytes:
          type: integer
          minimum: 0
        embedded_bytes:
          type: integer
          minimum: 0
        minimum_region_bytes:
          type: integer
          minimum: 0
        interior_margin_bytes:
          type: integer
          minimum: 0
        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.
        expected_min:
          type: integer
          minimum: 0
        expected_max:
          type: integer
          minimum: 0
        table_count:
          type: integer
          minimum: 0
        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.
        flagged_axis_count:
          type: integer
          minimum: 0
          description: >-
            Suspicious axes across table_count high-score tables. Does not imply
            every detected axis was checked.
        relation:
          type: string
          enum:
            - below
            - within
            - above
        locations_available:
          type: boolean
          enum:
            - false
          description: >-
            Reliable locations of suspicious axes are unavailable; no
            affected-axis addresses are inferred.
        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
        regions:
          type: array
          items:
            $ref: '#/components/schemas/ecu_layout_region'
          maxItems: 200
      description: >-
        Only measured fields applicable to the check are present. Internal
        erased-region locations appear in details when saved layout evidence is
        available.
    ecu_layout_region:
      type: object
      additionalProperties: false
      properties:
        kind:
          type: string
          enum:
            - code
            - calibration
            - erased
            - mixed
            - unknown
        start:
          type: integer
          minimum: 0
        end:
          type: integer
          minimum: 0
        size_bytes:
          type: integer
          minimum: 0
        high_score_candidate_count:
          type: integer
          minimum: 0
          description: >-
            High-score candidates used by layout classification; separate from
            the paginated discovery list.
        fill_byte:
          type: integer
          minimum: 0
          maximum: 255
          nullable: true
        fill_ratio:
          type: number
          minimum: 0
          maximum: 1
      required:
        - kind
        - start
        - end
        - size_bytes
    ecu_inspection_range:
      type: object
      additionalProperties: false
      properties:
        start:
          type: integer
          minimum: 0
        end:
          type: integer
          minimum: 0
        size_bytes:
          type: integer
          minimum: 0
      required:
        - start
        - end
        - size_bytes
      description: >-
        Zero-based byte offsets, start inclusive and end exclusive. size_bytes
        equals end minus start.
  responses:
    ecu_error_400:
      description: Invalid request body, parameters or Idempotency-Key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_401:
      description: Missing or invalid API credentials.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_403:
      description: ECU observation is not enabled for this account or access is denied.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_404:
      description: File or job not found for this account.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_405:
      description: HTTP method not supported by this endpoint.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_409:
      description: Job not complete, stale scan binding or conflicting Idempotency-Key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_410:
      description: File or result has expired.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
    ecu_error_429:
      description: >-
        Request-rate or ECU processing quota exceeded. Follow Retry-After when
        present.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
      headers:
        Retry-After:
          description: Suggested delay in seconds when supplied.
          schema:
            type: integer
            minimum: 1
    ecu_error_503:
      description: Observation service temporarily unavailable.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ecu_error'
      headers:
        Retry-After:
          description: Suggested delay in seconds when supplied.
          schema:
            type: integer
            minimum: 1
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: |-
        All API methods require Bearer authentication.
        Use your existing API key as the bearer token.

        Authorization header format: `Authorization: Bearer YOUR_API_KEY`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.