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.
curl --request GET \
--url https://api.remapdb.com/v2/ecu/jobs/{job_id}/details \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.remapdb.com/v2/ecu/jobs/{job_id}/details"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.remapdb.com/v2/ecu/jobs/{job_id}/details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.remapdb.com/v2/ecu/jobs/{job_id}/details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.remapdb.com/v2/ecu/jobs/{job_id}/details"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.remapdb.com/v2/ecu/jobs/{job_id}/details")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.remapdb.com/v2/ecu/jobs/{job_id}/details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"operation": "identify",
"message": "<string>",
"identification": {
"status": "identified",
"confidence": {
"level": "high",
"explanation": "<string>"
},
"manufacturer": "<string>",
"family": "<string>",
"variant": "<string>",
"software": "<string>",
"hardware": "<string>",
"calibration_id": "<string>",
"part_number": "<string>",
"byte_order": "big",
"cell_width_bytes": 1
},
"notices": [
{
"code": "<string>",
"message": "<string>"
}
],
"condition": {
"status": "review_recommended",
"coverage": "complete",
"message": "<string>",
"checks": [
{
"code": "embedded_erased_regions",
"title": "<string>",
"status": "no_issues_detected",
"message": "<string>",
"evidence": {
"erased_region_count": 1,
"embedded_region_count": 1,
"erased_bytes": 1,
"embedded_bytes": 1,
"minimum_region_bytes": 1,
"interior_margin_bytes": 1,
"candidate_count": 1,
"expected_min": 1,
"expected_max": 1,
"table_count": 1,
"checked_axis_count": 1,
"flagged_axis_count": 1,
"relation": "below",
"locations_available": false,
"reason": "unknown_family",
"regions": [
{
"kind": "code",
"start": 1,
"end": 1,
"size_bytes": 1,
"high_score_candidate_count": 1,
"fill_byte": 127,
"fill_ratio": 0.5
}
]
}
}
]
},
"checksums": {
"status": "passed",
"message": "<string>",
"reason": "supported_checks_passed"
},
"maps": {
"available": 1,
"returned": 100,
"omitted": 1,
"message": "<string>",
"items": [
{
"map_id": "<string>",
"offset": 1,
"rows": 2,
"columns": 2,
"cell_width_bytes": 1,
"byte_order": "little",
"name": null,
"units": null,
"scaling": null
}
],
"pagination": {
"offset": 1,
"limit": 100,
"next_offset": 1,
"has_more": true,
"retained": 1,
"rescan_required": true
},
"axes_count": 1,
"detected_before_layout": 1,
"excluded_by_layout": 1,
"layout_filtered": true,
"artifact": {
"schema_version": "remapdb.ecu.maps.v1",
"download_url": "<string>",
"media_type": "application/json",
"content_encoding": "gzip",
"map_count": 1,
"size_bytes": 8388608,
"compressed_size_bytes": 1,
"sha256": "<string>"
}
},
"comparison": {
"identical": true,
"changed_bytes": 1,
"changed_overlap_bytes": 1,
"reference_tail_bytes": 1,
"comparison_tail_bytes": 1,
"changed_map_candidates": 1,
"unmatched_reference_candidates": 1,
"unmatched_comparison_candidates": 1,
"message": "<string>",
"items": [
{
"reference_offset": 1,
"comparison_offset": 1,
"rows": 2,
"columns": 2,
"changed_cells": 1,
"total_cells": 1,
"realigned": true
}
],
"returned": 100,
"omitted": 1,
"offsets": "<string>",
"realigned_map_candidates": 1
},
"grid": {
"map_id": "<string>",
"rows": 2,
"columns": 2,
"cells": 32768,
"min": 123,
"max": 123,
"message": "<string>",
"values": [
[
32767
]
],
"axes": {
"x": [
32767
],
"y": [
32767
]
}
},
"layout": {
"file_size_bytes": 4194304,
"region_count": 1,
"bytes_by_kind": {
"code": 1,
"calibration": 1,
"erased": 1,
"mixed": 1,
"unknown": 1
},
"identification_block_count": 1,
"offsets": "<string>",
"message": "<string>",
"regions": [
{
"kind": "code",
"start": 1,
"end": 1,
"size_bytes": 1,
"high_score_candidate_count": 1,
"fill_byte": 127,
"fill_ratio": 0.5
}
],
"identification_blocks": [
{
"start": 1,
"end": 1,
"size_bytes": 1
}
],
"returned_identification_blocks": 100,
"omitted_identification_blocks": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}Authorizations
Query Parameters
Response
Successful response.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
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.
curl --request GET \
--url https://api.remapdb.com/v2/ecu/jobs/{job_id}/details \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.remapdb.com/v2/ecu/jobs/{job_id}/details"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.remapdb.com/v2/ecu/jobs/{job_id}/details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.remapdb.com/v2/ecu/jobs/{job_id}/details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.remapdb.com/v2/ecu/jobs/{job_id}/details"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.remapdb.com/v2/ecu/jobs/{job_id}/details")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.remapdb.com/v2/ecu/jobs/{job_id}/details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"operation": "identify",
"message": "<string>",
"identification": {
"status": "identified",
"confidence": {
"level": "high",
"explanation": "<string>"
},
"manufacturer": "<string>",
"family": "<string>",
"variant": "<string>",
"software": "<string>",
"hardware": "<string>",
"calibration_id": "<string>",
"part_number": "<string>",
"byte_order": "big",
"cell_width_bytes": 1
},
"notices": [
{
"code": "<string>",
"message": "<string>"
}
],
"condition": {
"status": "review_recommended",
"coverage": "complete",
"message": "<string>",
"checks": [
{
"code": "embedded_erased_regions",
"title": "<string>",
"status": "no_issues_detected",
"message": "<string>",
"evidence": {
"erased_region_count": 1,
"embedded_region_count": 1,
"erased_bytes": 1,
"embedded_bytes": 1,
"minimum_region_bytes": 1,
"interior_margin_bytes": 1,
"candidate_count": 1,
"expected_min": 1,
"expected_max": 1,
"table_count": 1,
"checked_axis_count": 1,
"flagged_axis_count": 1,
"relation": "below",
"locations_available": false,
"reason": "unknown_family",
"regions": [
{
"kind": "code",
"start": 1,
"end": 1,
"size_bytes": 1,
"high_score_candidate_count": 1,
"fill_byte": 127,
"fill_ratio": 0.5
}
]
}
}
]
},
"checksums": {
"status": "passed",
"message": "<string>",
"reason": "supported_checks_passed"
},
"maps": {
"available": 1,
"returned": 100,
"omitted": 1,
"message": "<string>",
"items": [
{
"map_id": "<string>",
"offset": 1,
"rows": 2,
"columns": 2,
"cell_width_bytes": 1,
"byte_order": "little",
"name": null,
"units": null,
"scaling": null
}
],
"pagination": {
"offset": 1,
"limit": 100,
"next_offset": 1,
"has_more": true,
"retained": 1,
"rescan_required": true
},
"axes_count": 1,
"detected_before_layout": 1,
"excluded_by_layout": 1,
"layout_filtered": true,
"artifact": {
"schema_version": "remapdb.ecu.maps.v1",
"download_url": "<string>",
"media_type": "application/json",
"content_encoding": "gzip",
"map_count": 1,
"size_bytes": 8388608,
"compressed_size_bytes": 1,
"sha256": "<string>"
}
},
"comparison": {
"identical": true,
"changed_bytes": 1,
"changed_overlap_bytes": 1,
"reference_tail_bytes": 1,
"comparison_tail_bytes": 1,
"changed_map_candidates": 1,
"unmatched_reference_candidates": 1,
"unmatched_comparison_candidates": 1,
"message": "<string>",
"items": [
{
"reference_offset": 1,
"comparison_offset": 1,
"rows": 2,
"columns": 2,
"changed_cells": 1,
"total_cells": 1,
"realigned": true
}
],
"returned": 100,
"omitted": 1,
"offsets": "<string>",
"realigned_map_candidates": 1
},
"grid": {
"map_id": "<string>",
"rows": 2,
"columns": 2,
"cells": 32768,
"min": 123,
"max": 123,
"message": "<string>",
"values": [
[
32767
]
],
"axes": {
"x": [
32767
],
"y": [
32767
]
}
},
"layout": {
"file_size_bytes": 4194304,
"region_count": 1,
"bytes_by_kind": {
"code": 1,
"calibration": 1,
"erased": 1,
"mixed": 1,
"unknown": 1
},
"identification_block_count": 1,
"offsets": "<string>",
"message": "<string>",
"regions": [
{
"kind": "code",
"start": 1,
"end": 1,
"size_bytes": 1,
"high_score_candidate_count": 1,
"fill_byte": 127,
"fill_ratio": 0.5
}
],
"identification_blocks": [
{
"start": 1,
"end": 1,
"size_bytes": 1
}
],
"returned_identification_blocks": 100,
"omitted_identification_blocks": 1
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>"
}
}