{"openapi":"3.1.0","info":{"title":"DatasheetVend API","version":"v1","description":"Agent-readable and developer-readable API contracts for DatasheetVend extraction outputs."},"servers":[{"url":"/api/v1","description":"DatasheetVend v1 API"}],"x-datasheetvend-module-registry":[{"module_id":"cad_normalized","file_kind":"cad_normalized.api_payload","schema_version":"cad_normalized_api_payload_v1","source_contract":"Job.cadNormalizedData","source_kind":"job_column","public_route":"/api/v1/jobs/[id]/cad-normalized","pack_route":null},{"module_id":"ucm","file_kind":"ucm.api_payload","schema_version":"ucm_api_payload_v1","source_contract":"Job.ucmData","source_kind":"job_column","public_route":"/api/v1/jobs/[id]/ucm","pack_route":null},{"module_id":"document_map","file_kind":"document_map.api_payload","schema_version":"document_map_api_payload_v1","source_contract":"document map cache + job payload","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/document-map","pack_route":null},{"module_id":"kicad","file_kind":"kicad.api_payload","schema_version":"kicad_api_payload_v1","source_contract":"canonical_outputs.kicad + audit_outputs.kicad","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/kicad","pack_route":null},{"module_id":"pinout","file_kind":"pinout.api_payload","schema_version":"pinout_api_payload_v1","source_contract":"machine_context.json","source_kind":"machine_context","public_route":"/api/v1/jobs/[id]/pinout","pack_route":"/api/v1/jobs/[id]/pinout/pack"},{"module_id":"footprint","file_kind":"footprint.api_payload","schema_version":"footprint_api_payload_v1","source_contract":"machine_context.json","source_kind":"machine_context","public_route":"/api/v1/jobs/[id]/footprint","pack_route":"/api/v1/jobs/[id]/footprint/pack"},{"module_id":"thermal","file_kind":"thermal.api_payload","schema_version":"thermal_api_payload_v1","source_contract":"machine_context.json","source_kind":"machine_context","public_route":"/api/v1/jobs/[id]/thermal","pack_route":"/api/v1/jobs/[id]/thermal/pack"},{"module_id":"absolute_max","file_kind":"absolute_max.api_payload","schema_version":"absolute_max_api_payload_v1","source_contract":"canonical_outputs.absolute_max + audit_outputs.absolute_max","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/absolute-max","pack_route":"/api/v1/jobs/[id]/absolute-max/pack"},{"module_id":"altium","file_kind":"altium.api_payload","schema_version":"altium_api_payload_v1","source_contract":"canonical_outputs.altium + audit_outputs.altium","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/altium","pack_route":"/api/v1/jobs/[id]/altium/pack"},{"module_id":"analog_intelligence","file_kind":"analog_intelligence.api_payload","schema_version":"analog_intelligence_api_payload_v1","source_contract":"canonical_outputs.analog_intelligence + audit_outputs.analog_intelligence","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/analog-intelligence","pack_route":"/api/v1/jobs/[id]/analog-intelligence/pack"},{"module_id":"logic_levels","file_kind":"logic_levels.api_payload","schema_version":"logic_levels_api_payload_v1","source_contract":"canonical_outputs.logic_levels + audit_outputs.logic_levels","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/logic-levels","pack_route":"/api/v1/jobs/[id]/logic-levels/pack"},{"module_id":"part_decoder","file_kind":"part_decoder.api_payload","schema_version":"part_decoder_api_payload_v1","source_contract":"canonical_outputs.part_decoder + audit_outputs.part_decoder","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/part-decoder","pack_route":"/api/v1/jobs/[id]/part-decoder/pack"},{"module_id":"passive_bom","file_kind":"passive_bom.api_payload","schema_version":"passive_bom_api_payload_v1","source_contract":"canonical_outputs.passive_bom + audit_outputs.passive_bom","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/passive-bom","pack_route":"/api/v1/jobs/[id]/passive-bom/pack"},{"module_id":"peripheral_matrix","file_kind":"peripheral_matrix.api_payload","schema_version":"peripheral_matrix_api_payload_v1","source_contract":"canonical_outputs.peripheral_matrix + audit_outputs.peripheral_matrix","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/peripheral-matrix","pack_route":"/api/v1/jobs/[id]/peripheral-matrix/pack"},{"module_id":"pin_cautions","file_kind":"pin_cautions.api_payload","schema_version":"pin_cautions_api_payload_v1","source_contract":"pinCautionsData","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/rules","pack_route":"/api/v1/jobs/[id]/rules/pack"},{"module_id":"power_battery","file_kind":"power_battery.api_payload","schema_version":"power_battery_api_payload_v1","source_contract":"canonical_outputs.power_battery + audit_outputs.power_battery","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/power-battery","pack_route":"/api/v1/jobs/[id]/power-battery/pack"},{"module_id":"register_map","file_kind":"register_map.api_payload","schema_version":"register_map_api_payload_v1","source_contract":"machine_context.json","source_kind":"machine_context","public_route":"/api/v1/jobs/[id]/register-map","pack_route":"/api/v1/jobs/[id]/register-map/pack"},{"module_id":"timing","file_kind":"timing.api_payload","schema_version":"timing_api_payload_v1","source_contract":"canonical_outputs.timing + audit_outputs.timing","source_kind":"canonical_plus_audit","public_route":"/api/v1/jobs/[id]/timing","pack_route":"/api/v1/jobs/[id]/timing/pack"}],"paths":{"/trust/subprocessors":{"get":{"operationId":"getSubprocessors","summary":"List every company that processes customer data","description":"Public, unauthenticated. The same list as /trust/subprocessors, built from the same source: for each company, the service we use, what it does for us, the customer data it receives, where it runs (\"Not yet confirmed\" when we have not verified it), and when it receives data if not on every use. scope \"core\" runs whenever the product is used; scope \"feature\" only when a user uses the named feature.","tags":["Trust"],"responses":{"200":{"description":"The subprocessor list.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}}}}},"/trust/updates":{"get":{"operationId":"getTrustUpdates","summary":"Dated changes to subprocessors and data handling, newest first","description":"Public, unauthenticated. The entries behind /trust/updates: each has an ISO date, a category (Subprocessors, Privacy or Compliance), a title, a body and an optional link. Also published as RSS at /trust/updates/rss.","tags":["Trust"],"responses":{"200":{"description":"The trust updates.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}}}}},"/trust/updates/rss":{"get":{"operationId":"getTrustUpdatesRss","summary":"The trust updates as an RSS 2.0 feed","description":"Public, unauthenticated. Subscribe to it to hear when the subprocessor list changes.","tags":["Trust"],"responses":{"200":{"description":"RSS 2.0 feed.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/schemas":{"get":{"operationId":"getSchemaIndex","summary":"List every module and whether it publishes a machine-readable JSON Schema","description":"Public, unauthenticated schema-discovery index. For each module it reports schema_available and the URL to fetch that module's JSON Schema, so an agent can learn the exact shape of a payload BEFORE requesting it and validate the payload AFTER receiving it.\n\nHonest about coverage (CLAUDE.md §24): only modules with a checked-in schema report schema_available:true; the rest say so plainly rather than implying a contract that does not exist. Also publishes the shared {data, metadata} response-envelope schema, which every module route conforms to. The envelope shape is stable as coverage grows — integrate once.","tags":["Schemas"],"responses":{"200":{"description":"Schema index returned.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"500":{"description":"An internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/schemas/{module}":{"get":{"operationId":"getModuleSchema","summary":"Get one module's published JSON Schema, or an honest not-published record","description":"Returns the module's payload JSON Schema in data.schema.document when one is published (data.schema_available:true, provenance labelled, data.schema.validates stating exactly what it covers), or the SAME envelope with schema_available:false and document:null when none is published yet. The shape is identical either way, so an agent integrates once.\n\nA known module with no schema is 200 (it exists; its schema is simply not published). Only an unknown module id is 404. Unauthenticated, like /schemas and /openapi.","tags":["Schemas"],"parameters":[{"name":"module","in":"path","required":true,"description":"Module id, e.g. pinout. GET /api/v1/schemas lists every module id.","schema":{"type":"string"}}],"responses":{"200":{"description":"Module schema record returned (whether or not a schema is published).","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"404":{"description":"No module with that id is registered.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/workbench/crosscheck":{"post":{"operationId":"crosscheckUserNetlist","summary":"Audit an engineer's KiCad netlist against what was extracted from the datasheets","description":"POST a KiCad netlist as exported (the s-expression .net, or the XML form; checked on KiCad 10 files, and format D of KiCad 5 to 8 uses the same grammar) plus the extraction job ids of the chips on the board. The chips are built as the dashboard's Workbench builds them. It compares symbol pin names with the datasheet, pin existence, supply and ground pins against rails read from net names, NC pins, pin functions across each net, pull-ups, and the electrical rules that have the data to run. `verdict` states how many pins were compared and `rule_coverage` which rules could not run: a rule that could not run is never a pass. Deterministic, no model calls. Parts with no matching job are listed in unmapped_components, never guessed; passives and connectors are in recognized_components.","tags":["Multi-Chip Workbench"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["netlist","job_ids"],"properties":{"netlist":{"type":"string","description":"The text of a KiCad netlist export, s-expression or XML (max 2MB).","example":"(export (version D) (components (comp (ref U1) (value \"ATmega328P\"))) (nets (net (code 1) (name \"I2C_SDA\") (node (ref U1) (pin \"27\")))))"},"job_ids":{"type":"array","items":{"type":"string"},"maxItems":12,"description":"Extraction job ids for the chips on the board (multi-run jobs of the same part are coalesced)."},"system_voltage_v":{"type":"number","default":3.3,"description":"Used only for parts whose supply net states no voltage in its name; findings that rest on it say so."}}}}}},"responses":{"200":{"description":"Cross-check completed; findings use the workbench DRC violation contract, each with rested_on.","content":{"application/json":{"schema":{"type":"object","properties":{"schema_version":{"type":"string","example":"workbench_crosscheck_v1"},"system_voltage_v":{"type":"number"},"chips":{"type":"array","items":{"type":"object","additionalProperties":true}},"mapped_components":{"type":"array","items":{"type":"object","additionalProperties":true}},"unmapped_components":{"type":"array","description":"Chips nothing attached matches; their pins are not checked.","items":{"type":"object","additionalProperties":true}},"recognized_components":{"type":"array","description":"Passives, connectors and the like, read for what they do on their nets.","items":{"type":"object","additionalProperties":true}},"verdict":{"type":"object","description":"What happened: state NOTHING_CHECKED or CHECKED, headline, pins_total, pins_checked, pins_not_checked, errors, warnings, not_checked_reasons.","additionalProperties":true},"symbol_check":{"type":"array","description":"Per schematic part: symbol pin names against the stored pinout, and whether the stored run may be another package.","items":{"type":"object","additionalProperties":true}},"rule_coverage":{"type":"object","description":"Rules that ran, on what, and which could not run with what each needs.","additionalProperties":true},"rail_basis":{"type":"object","description":"Whether rail voltages came from net names or the system voltage setting.","additionalProperties":true},"netlist_source":{"type":"object","nullable":true,"description":"Format, version and tool the netlist declares.","additionalProperties":true},"twin_sources":{"type":"array","description":"Chips with a UCM twin. The twin is reported in data_integrity_notes and never changes the chip: filled_fields is empty, available_fields lists what it holds beyond the chip.","items":{"type":"object","additionalProperties":true}},"findings":{"type":"array","description":"WorkbenchDrcViolation records: severity ERROR/WARNING/INFO/PASS, rule_code, affected pins, recommendation.","items":{"type":"object","additionalProperties":true}},"stats":{"type":"object","additionalProperties":true},"data_integrity_notes":{"type":"array","items":{"type":"string"}}}}}}},"401":{"description":"Missing/invalid Developer API Key (Bearer dsv_...) or session."},"403":{"description":"A referenced job belongs to a private user or workspace."},"404":{"description":"One or more job_ids were not found."},"422":{"description":"The text is not a KiCad netlist; the error says how to export one."}}}},"/workbench/footprints":{"post":{"operationId":"resolveWorkbenchFootprints","summary":"Official KiCad footprint ids for chips, from package numbers","description":"Numbers in, library ids out: no job data is read or stored. A footprint id comes back only when pin count, pitch and body agree on source evidence and exactly one footprint in the official KiCad library fits; otherwise the status is ambiguous or unresolved and footprint_id is null. `choices` is the engineer's pick for an ambiguous chip, honoured only for one of its candidates.","tags":["Multi-Chip Workbench"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["chips"],"properties":{"chips":{"type":"array","maxItems":40,"items":{"type":"object","required":["id"],"properties":{"id":{"type":"string"},"package_geometry":{"type":"object","nullable":true,"additionalProperties":true,"description":"Pitch, body and exposed-pad numbers, each marked source or inferred."},"package_pin_count":{"type":"number","nullable":true}}}},"choices":{"type":"object","additionalProperties":{"type":"string"},"description":"Chip id to footprint id (at most 40)."}}}}}},"responses":{"200":{"description":"One entry per chip, and any choice that was not honoured with its reason.","content":{"application/json":{"schema":{"type":"object","properties":{"footprints":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"ignored_choices":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}},"400":{"description":"A malformed body: missing chips, a chip with no id, or too many entries."},"401":{"description":"Missing/invalid Developer API Key (Bearer dsv_...) or session."}}}},"/uploads":{"post":{"operationId":"createDatasheetUpload","summary":"Get a one-time upload link for a PDF on your own disk","description":"For a PDF that has no public URL. Send the file name and size; the answer is the exact PUT request to make (the Blob API address and headers, good for this one file for 15 minutes), plus an upload_id. PUT the raw PDF bytes, then start the extraction with POST /api/v1/extract { uploadId, modules }. Nothing is charged here: credits are taken when the extraction starts. Developer API key only (an upload belongs to an account; a machine payment cannot use it). PDF only, up to 100 MB. An upload is visible to its own account only, and one that no extraction uses is deleted after 24 hours. At most 20 unused uploads per account, and 30 links per minute per key.","tags":["Agentic Extraction"],"security":[{"BearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["filename","size_bytes"],"properties":{"filename":{"type":"string","description":"The PDF's file name. It is cleaned before use; it only names the file.","example":"STM32F103C8.pdf"},"size_bytes":{"type":"integer","minimum":1,"maximum":104857600,"description":"The PDF's exact size in bytes. The upload link refuses a larger file.","example":2480112}}}}}},"responses":{"201":{"description":"Upload link created. The response holds a short-lived token and is never cached.","content":{"application/json":{"schema":{"type":"object","properties":{"upload_id":{"type":"string","format":"uuid"},"filename":{"type":"string"},"expires_at":{"type":"string","format":"date-time"},"max_bytes":{"type":"integer"},"upload":{"type":"object","description":"The request to make, unchanged: method, url, headers and a description of the body (the raw PDF bytes).","additionalProperties":true},"next":{"type":"object","description":"The follow-up POST /api/v1/extract call with this upload_id.","additionalProperties":true}}}}}},"400":{"description":"Not JSON, or a missing filename or size_bytes (MISSING_FILENAME, INVALID_SIZE, INVALID_JSON)."},"401":{"description":"API_KEY_REQUIRED or INVALID_API_KEY. Direct upload needs a Developer API key."},"413":{"description":"FILE_TOO_LARGE: size_bytes is over 100 MB (max_bytes in the error)."},"429":{"description":"RATE_LIMITED (Retry-After header) or TOO_MANY_PENDING_UPLOADS (20 uploads no extraction has used yet)."},"503":{"description":"UPLOADS_UNAVAILABLE: the upload link could not be created. Nothing was stored; try again."}}}},"/extract":{"post":{"operationId":"extractDatasheetAgentic","summary":"Programmatic extraction gateway for AI agents with Stripe Machine Payments (MPP)","description":"Starts a real extraction and returns HTTP 202 with a job id — NOT the files. An extraction typically takes 10-120s on Fast Extraction and 60-1200s on the deep engine (the 202's guidance.typical_duration_seconds gives the range for the engine used; it is guidance, not a guarantee), so this hands back a job id plus the exact module URLs to fetch each contract from once it finishes. Poll status_url until job_status is COMPLETED. Authenticates via Developer API Key (Bearer dsv_...) or Stripe MPP (HTTP 402 challenge); machine payments are SINGLE-USE. The request is validated before any charge, so a malformed request never costs a credit. Price: an API key pays per module (the dashboard's credit costs — e.g. kicad 3, thermal 2, pinout 1 — plus 1 for document_map, minimum 1; the 202's payment.credits_charged says what was taken); a machine payment is a flat $2.00, or $3.00 when the request includes kicad. API-key callers own the resulting job; MPP callers have no account and receive a signed session_id which is the only way to read their results back; it expires 15 minutes after the 202 (session_id_expires_at).","tags":["Agentic Extraction"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","oneOf":[{"required":["fileUrl"]},{"required":["uploadId"]}],"properties":{"fileUrl":{"type":"string","format":"uri","description":"The source PDF as a publicly reachable https URL. Send this OR uploadId, not both.","example":"https://example.com/datasheet.pdf"},"uploadId":{"type":"string","format":"uuid","description":"The source PDF you uploaded with POST /api/v1/uploads. Send this OR fileUrl, not both. Developer API key only, and only an upload made by the same account is found: any other id answers 404 UPLOAD_NOT_FOUND, exactly like an id that never existed. The same upload can start more than one extraction."},"callbackUrl":{"type":"string","format":"uri","description":"OPTIONAL. An https URL we POST to once when the job ends (job.completed, job.failed), so you do not have to poll. Developer API key only. The URL must be public (no credentials in it, no custom port, no private or internal host); anything else answers 400 INVALID_CALLBACK_URL and nothing is charged. The message is small JSON: { id, type, job_id, status, status_url, modules }, with no extracted data, so fetch the results from status_url. It is signed: header X-DatasheetVend-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\">, keyed with the secret from GET /api/v1/callbacks/signing-secret. Answer any 2xx to confirm; anything else (or no answer within 10 seconds) is retried up to 7 attempts in all, over about 20 hours. Delivery is at least once: de-duplicate on id, which is the same on every attempt. Redirects are not followed. Watch a job's delivery with GET /api/v1/jobs/{id}/callback. At most 500 callbacks may be waiting per account.","example":"https://example.com/hooks/datasheetvend"},"filename":{"type":"string","example":"STM32H743.pdf"},"modules":{"type":"array","items":{"type":"string"},"description":"Defaults to document_map + pinout + footprint. Unknown names are rejected 400.","example":["document_map","pinout","footprint"]},"referenceManualUrl":{"type":"string","format":"uri","description":"OPTIONAL. Publicly reachable https URL of the part's reference manual (the document a large 32-bit MCU's datasheet sends its register map to, e.g. ST RM0433, TI SWCU193). Read only by the register_map module, only when the datasheet prints no register map and no vendor register file (SVD) is catalogued for the exact part (that file is used first), and only after its identity is checked against the datasheet; a manual for other chips is not used and the response says so. Requires register_map in modules. No extra charge, no model call.","example":"https://example.com/rm0433-stm32h742.pdf"},"referenceManualFilename":{"type":"string","description":"OPTIONAL. Name for the manual; defaults to the URL's last path segment.","example":"RM0433.pdf"},"part_number":{"type":"string","description":"OPTIONAL. The exact ordering code (up to 64 characters). On a datasheet that covers several packages it names the one the kicad module builds, and a bundle built for a package the code contradicts is flagged for review.","example":"OPA4206APWR"}}}}}},"responses":{"202":{"description":"Payment accepted and extraction queued. The response carries the job id and where to fetch each module contract once it completes.","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"PROCESSING"},"job_id":{"type":"string"},"payment":{"type":"object","additionalProperties":true},"request":{"type":"object","additionalProperties":true},"retrieval":{"type":"object","description":"status_url to poll, module_urls per requested module, and (for MPP callers with no account) the signed session_id required to read results, with session_id_expires_at -- it expires 15 minutes after the 202.","additionalProperties":true},"callback":{"type":"object","description":"Present only when callbackUrl was sent. registered: true comes with callback_id, status_url (the delivery log) and signing_secret_url. registered: false means the job was started and charged but the callback could not be recorded: poll retrieval.status_url instead.","additionalProperties":true},"guidance":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid request (missing/bad fileUrl or referenceManualUrl, fileUrl and uploadId together, a bad uploadId, an upload that is empty or not a PDF, INVALID_CALLBACK_URL (not https, has credentials or a custom port, a private or internal host, or longer than 2048 characters), unknown modules, a reference manual without register_map). Nothing is charged."},"401":{"description":"A request with an uploadId or a callbackUrl needs a Developer API key: API_KEY_REQUIRED (none sent, or a machine payment) or INVALID_API_KEY. Nothing is charged."},"402":{"description":"Stripe Machine Payments Protocol (MPP) challenge ($3.00 USD per module), insufficient module credits (credits_required names the cost), or PAYMENT_ALREADY_USED when a machine payment credential is replayed.","headers":{"WWW-Authenticate":{"schema":{"type":"string"},"description":"Payment challenge header, e.g. Payment protocol=\"mpp_v1\", amount=\"3.00\", currency=\"USD\""}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"UPLOAD_NOT_FOUND: no upload with that uploadId for your account (it may have expired after 24 hours, or belong to another account). Nothing is charged."},"429":{"description":"TOO_MANY_CALLBACKS: the account already has 500 callbacks waiting to be delivered (limit in the answer). Nothing is charged."},"503":{"description":"Payment accepted but the job could not be queued. The job is marked FAILED. An API key's module credits are refunded on the spot (refunded: true); a machine payment is refunded to the payment method that made it (refunded: true), or, when Stripe cannot be reached, automatically once the job is recorded as failed (job_id and the payment reference are in the response). A request with a callbackUrl can also answer 503 CALLBACKS_UNAVAILABLE before any charge, when callbacks are not available on the deployment right now."}}}},"/jobs/{id}/callback":{"get":{"operationId":"getJobCallback","summary":"Where a job's callback delivery stands","description":"The delivery log for the callback you asked for with callbackUrl: state (WAITING, DELIVERED or FAILED), how many attempts were made of the maximum, the last HTTP status and a short error label (timeout, connection_failed, non_public_address, redirect, http_4xx, http_5xx, http_other, url_refused), when the next attempt is due and when it was delivered. The receiver's response body is never stored or shown. A job that is another account's, has no callback, or does not exist all answer the same 404.","tags":["Agentic Extraction"],"security":[{"BearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"The delivery state.","content":{"application/json":{"schema":{"type":"object","properties":{"job_id":{"type":"string"},"callback_id":{"type":"string","description":"The id inside every message for this job."},"url":{"type":"string"},"state":{"type":"string","enum":["WAITING","DELIVERED","FAILED"]},"attempts":{"type":"integer"},"max_attempts":{"type":"integer","example":7},"last_attempt_at":{"type":"string","format":"date-time","nullable":true},"last_status_code":{"type":"integer","nullable":true},"last_error":{"type":"string","nullable":true},"next_attempt_at":{"type":"string","format":"date-time","nullable":true,"description":"Only while WAITING. Empty while the job is still running: nothing is sent before it ends."},"delivered_at":{"type":"string","format":"date-time","nullable":true},"created_at":{"type":"string","format":"date-time"}}}}}},"401":{"description":"API_KEY_REQUIRED: send a Developer API key."},"404":{"description":"CALLBACK_NOT_FOUND."},"429":{"description":"RATE_LIMITED."},"503":{"description":"CALLBACKS_UNAVAILABLE."}}}},"/callbacks/signing-secret":{"get":{"operationId":"getCallbackSigningSecret","summary":"The secret that signs this API key's callbacks","description":"Returns the signing secret for the API key you call this with. Callbacks for jobs started with that key are signed with it: header X-DatasheetVend-Signature: t=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw request body>\">. Verify against the raw body before parsing it, compare in constant time, and reject a timestamp more than tolerance_seconds from your clock. Whoever holds the key can read the secret; treat it like the key.","tags":["Agentic Extraction"],"security":[{"BearerAuth":[]}],"responses":{"200":{"description":"The secret and the scheme.","content":{"application/json":{"schema":{"type":"object","properties":{"signing_secret":{"type":"string","example":"whsec_..."},"header":{"type":"string","example":"X-DatasheetVend-Signature"},"scheme":{"type":"string"},"tolerance_seconds":{"type":"integer","example":300},"note":{"type":"string"}}}}}},"401":{"description":"API_KEY_REQUIRED: send a Developer API key."},"503":{"description":"CALLBACKS_UNAVAILABLE."}}}},"/jobs/{id}":{"get":{"operationId":"getJobManifest","summary":"Get lightweight API manifest for a completed job","description":"Returns job identity, artifact state, available module contracts, warnings, and links to module-specific API routes. This endpoint is a lightweight manifest; use module routes for full payloads.","tags":["Jobs"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"responses":{"200":{"description":"Job API manifest returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"$ref":"#/components/schemas/JobApiManifest"},"metadata":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Missing or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Artifacts are unavailable because retention/purge rules apply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Job API manifest failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/pinout":{"get":{"operationId":"getJobPinout","summary":"Get Pinout API payload for a completed job","description":"Returns the stable pinout_api_payload_v1 contract built from pinout machine_context.json. This route is intended for humans, scripts, company systems, and AI agents. It is not the dashboard job object.","tags":["Pinout"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"responses":{"200":{"description":"Pinout API payload returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"$ref":"#/components/schemas/PinoutApiPayload"},"metadata":{"type":"object","required":["job_id","filename","job_status","generated_from","source_contract"],"properties":{"job_id":{"type":"string"},"filename":{"type":"string"},"job_status":{"type":"string"},"generated_from":{"type":"string"},"source_contract":{"type":"string","const":"machine_context.json"}}}}}}}},"400":{"description":"Missing or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job or Pinout machine context was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Artifacts are unavailable because retention/purge rules apply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"API payload failed validation or an internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/footprint":{"get":{"operationId":"getJobFootprint","summary":"Get Footprint API payload for a completed job","description":"Returns the stable footprint_api_payload_v1 contract built from footprint machine_context.json. This route is intended for humans, scripts, company systems, CAD workflows, and AI agents.","tags":["Footprint"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"responses":{"200":{"description":"Footprint API payload returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"$ref":"#/components/schemas/FootprintApiPayload"},"metadata":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Missing or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job or Footprint machine context was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Artifacts are unavailable because retention/purge rules apply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"API payload failed validation or an internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/cad-normalized":{"get":{"operationId":"getJobCadNormalized","summary":"Get CAD-normalized package geometry for a completed job","description":"Returns the deterministic CAD normalization contract: resolved package topology, body dimensions, normalized pin entries, and synthesis_warnings. Warnings surface inference and ambiguity rather than resolving them silently — treat a warned value as needing engineering review.","tags":["CAD Normalized"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"CAD-normalized payload returned.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"401":{"description":"Missing or invalid credentials."},"403":{"description":"Job belongs to a private user or workspace."},"404":{"description":"This job has no CAD-normalized output; metadata carries module_status."}}}},"/jobs/{id}/ucm":{"get":{"operationId":"getJobUcm","summary":"Get the Universal Contract Model fact ledger for a job","description":"Returns the UCM fact ledger: per-module facts where each entry carries scope, symbol, parameter, value, and provenance fields (page, snippet, producing module and version; the page can be null). This is the traceability lane — use it to see where a fact came from, with the page and snippet where the extraction recorded them.","tags":["Universal Contract Model"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"UCM fact ledger returned.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"401":{"description":"Missing or invalid credentials."},"403":{"description":"Job belongs to a private user or workspace."},"404":{"description":"This job has no UCM ledger."}}}},"/jobs/{id}/thermal":{"get":{"operationId":"getJobThermal","summary":"Get Thermal API payload for a completed job","description":"Returns the stable thermal_api_payload_v1 contract built from thermal machine_context.json. This route is intended for humans, scripts, company systems, and AI agents. Thermal values require human engineering review before design calculation or production use.","tags":["Thermal"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"responses":{"200":{"description":"Thermal API payload returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"$ref":"#/components/schemas/ThermalApiPayload"},"metadata":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Missing or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job or Thermal machine context was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Artifacts are unavailable because retention/purge rules apply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"API payload failed validation or an internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/rules/catalog":{"get":{"operationId":"getRuleCatalog","summary":"Get the design-rule VOCABULARY the engine recognises","description":"Returns pin_cautions_rule_catalog_v1: every kind of design rule this engine can classify, grouped into families, with the closed enum sets that rule values are drawn from (severities, lifecycle phases, scope kinds).\n\nThis is NOT a datasheet's rules — for those use /jobs/{id}/rules. This is the classification scheme itself, so an agent can pre-filter by family, or an EDA integration can map these families onto its own, before it has a job.\n\nUnauthenticated, like /openapi: it contains no customer data and is a static description of the engine.\n\nNote that default_severity is the value applied when a datasheet states none. It encodes consequence class, never a claim about a specific part.","tags":["Rules"],"responses":{"200":{"description":"Rule catalog returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"500":{"description":"An internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/rules":{"get":{"operationId":"getJobRules","summary":"Get the machine-readable design rulebook for a completed job","description":"Returns pin_cautions_rulebook_v1: every design rule extracted from the datasheet with its modality (MUST / MUST_NOT / RECOMMENDED / NOT_RECOMMENDED), its typed quantity, the package variant it is qualified to, and the verbatim source sentence it was derived from. Intended for AI agents, EDA tooling, and design-review scripts.\n\nTwo contract guarantees matter when consuming this. (1) Package scope is fail-closed: a rule whose variant could not be attributed reports scope.kind = \"unresolved\" with an EMPTY applies_to_packages, and that must never be read as \"applies everywhere\". (2) numeric_limit and numeric_range are mutually exclusive — a range flattened into a single comparator states the opposite of the datasheet.\n\nRule values are extracted from vendor documentation and require human engineering review before production use.","tags":["Rules"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"package","in":"query","required":false,"description":"Narrow to the rules governing one package variant, e.g. TQFP32. Rules with unresolved or unchecked scope are INCLUDED rather than dropped, because an unattributed rule is exactly what a caller filtering for their own package needs to see.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"responses":{"200":{"description":"Design rulebook returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job or pin_cautions payload was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Artifacts are unavailable because retention/purge rules apply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/rules/check":{"post":{"operationId":"checkJobRules","summary":"Check a design value against every extracted design rule","description":"Evaluates one candidate design value (for example 4.7 kohm) against the whole rulebook and returns a verdict per rule.\n\nVerdicts are deliberately five, not two: pass, fail, needs_review (the rule could not be attributed to a package, so a human must decide), not_applicable (the rule governs a different package), and not_checkable (the rule states no comparable quantity). None of the refusals is a pass.\n\nresults carries only pass/fail/needs_review. summary counts EVERY rule, so the denominator is always visible — hiding it is how \"0 failures\" comes to mean \"nothing was compared\". An unrecognised unit is rejected with 400 for the same reason.\n\nbinding distinguishes a MUST/MUST_NOT violation from advice; note that the rule's modality sets how much a failure matters, never which side of a bound is legal.","tags":["Rules"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["value","unit"],"properties":{"value":{"type":"number","description":"The magnitude to check, e.g. 4.7."},"unit":{"type":"string","description":"Unit of the value, e.g. \"kohm\", \"V\", \"nF\", \"pF\", \"mA\", \"ms\", \"MHz\", \"°C\", \"mm\"."},"package":{"type":"string","description":"Optional package variant of the board being checked, e.g. TQFP32. Supplying it enables the scope gate so rules for other variants report not_applicable."}}}}}},"responses":{"200":{"description":"Check completed.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"type":"object","additionalProperties":true},"metadata":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Invalid body, or a unit this checker does not recognise.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job or pin_cautions payload was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"An internal error occurred.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/register-map":{"get":{"operationId":"getJobRegisterMap","summary":"Get Register Map API payload for a completed job","description":"Returns the stable register_map_api_payload_v1 contract built from register_map machine_context.json. This route is intended for humans, scripts, company systems, firmware review workflows, and AI agents. Generated C headers and register maps require human engineering review before firmware or production use.","tags":["Register Map"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used.","schema":{"type":"string"}}],"responses":{"200":{"description":"Register Map API payload returned successfully.","content":{"application/json":{"schema":{"type":"object","required":["data","metadata"],"properties":{"data":{"$ref":"#/components/schemas/RegisterMapApiPayload"},"metadata":{"type":"object","additionalProperties":true}}}}}},"400":{"description":"Missing or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Job or Register Map machine context was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"410":{"description":"Artifacts are unavailable because retention/purge rules apply.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"REGISTER_MAP_API_MACHINE_CONTEXT_UNREADABLE: the job has a stored machine_context.json that could not be read back or failed its checksum. Not served; retry after the Retry-After interval.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/timing":{"get":{"operationId":"getJobTimingPayload","summary":"Get canonical timing diagrams and clock specifications","description":"Returns maximum clock frequencies, setup/hold times, propagation delays, and timing diagram contracts.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"Timing API payload returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Job or timing context was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/document-map":{"get":{"operationId":"getJobDocumentMapPayload","summary":"Get the deterministic Document Map for a job","description":"Returns the per-page geometry census, dominant forms, and candidate topic locations for the datasheet.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}}],"responses":{"200":{"description":"Document Map returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/jobs/{id}/absolute-max":{"get":{"operationId":"getJobAbsoluteMaxPayload","summary":"Get absolute maximum ratings","description":"Returns the voltage, current and temperature stress limits, with the recommended operating boundaries in a separate list.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Absolute max ratings returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/analog-intelligence":{"get":{"operationId":"getJobAnalogIntelligencePayload","summary":"Get analog domain specifications (ADC/DAC, Op-Amps, VREF, Dynamic Specs)","description":"Returns ADC/DAC resolution, sampling rates, channel counts, ADC input ranges, INL/DNL, dynamic specs (ENOB, SINAD, SNR, SFDR, THD), operational amplifiers (GBW, slew rate, rail-to-rail, CMRR/PSRR), internal voltage references (nominal voltage, tempco ppm/°C), and operating supply/temp envelopes, plus comparator propagation delay and hysteresis.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Analog intelligence returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/logic-levels":{"get":{"operationId":"getJobLogicLevelsPayload","summary":"Get digital logic levels and IO voltage thresholds","description":"Returns Vil, Vih, Vol, Voh thresholds and IO domain associations.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Logic levels returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/part-decoder":{"get":{"operationId":"getJobPartDecoderPayload","summary":"Get part number suffix and package breakdown","description":"Returns decoded ordering codes, suffix mappings, and package options. summary.universal gives the headline numbers of the universal block (grammar status, orderable SKU count, how the job's target part number resolved); the block itself, with the grammar, the SKU catalog and the target resolution, is in data.canonical_output.universal and its audit in data.audit_output.universal_quality. All additive and optional.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Part decoder returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/passive-bom":{"get":{"operationId":"getJobPassiveBomPayload","summary":"Get passive component recommendations and BOM requirements","description":"Returns decoupling capacitors, pull-up resistors, and crystal loads.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Passive BOM returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/peripheral-matrix":{"get":{"operationId":"getJobPeripheralMatrixPayload","summary":"Get the on-chip peripheral inventory","description":"Returns one row per peripheral instance (SPI, I2C, UART, CAN, USB, ETH, timers and more, in 13 classes), with its source page where recorded.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Peripheral matrix returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/power-battery":{"get":{"operationId":"getJobPowerBatteryPayload","summary":"Get power domains, battery backup, and power consumption","description":"Returns Vdd, Vbat, sleep currents, and power domain mapping.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Power & battery systems returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/pinout/pack":{"get":{"operationId":"getJobPinoutPack","summary":"Download the Pinout delivery packs (engineer + machine)","description":"Returns the downloadable Pinout delivery-pack FILES the base /jobs/[id]/pinout route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.pinout_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Pinout pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/footprint/pack":{"get":{"operationId":"getJobFootprintPack","summary":"Download the Footprint delivery packs (engineer + machine)","description":"Returns the downloadable Footprint delivery-pack FILES the base /jobs/[id]/footprint route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.footprint_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Footprint pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/thermal/pack":{"get":{"operationId":"getJobThermalPack","summary":"Download the Thermal delivery packs (engineer + machine)","description":"Returns the downloadable Thermal delivery-pack FILES the base /jobs/[id]/thermal route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.thermal_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Thermal pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/absolute-max/pack":{"get":{"operationId":"getJobAbsoluteMaxPack","summary":"Download the Absolute Maximum Ratings delivery packs (engineer + machine)","description":"Returns the downloadable Absolute Maximum Ratings delivery-pack FILES the base /jobs/[id]/absolute-max route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.absolute_max_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Absolute Maximum Ratings pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/altium/pack":{"get":{"operationId":"getJobAltiumPack","summary":"Download the Altium delivery packs (engineer + machine)","description":"Returns the downloadable Altium delivery-pack FILES the base /jobs/[id]/altium route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.altium_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Altium pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/analog-intelligence/pack":{"get":{"operationId":"getJobAnalogIntelligencePack","summary":"Download the Analog Intelligence delivery packs (engineer + machine)","description":"Returns the downloadable Analog Intelligence delivery-pack FILES the base /jobs/[id]/analog-intelligence route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.analog_intelligence_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Analog Intelligence pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/logic-levels/pack":{"get":{"operationId":"getJobLogicLevelsPack","summary":"Download the Logic Levels delivery packs (engineer + machine)","description":"Returns the downloadable Logic Levels delivery-pack FILES the base /jobs/[id]/logic-levels route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.logic_levels_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Logic Levels pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/part-decoder/pack":{"get":{"operationId":"getJobPartDecoderPack","summary":"Download the Part Decoder delivery packs (engineer + machine)","description":"Returns the downloadable Part Decoder delivery-pack FILES the base /jobs/[id]/part-decoder route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.part_decoder_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Part Decoder pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/passive-bom/pack":{"get":{"operationId":"getJobPassiveBomPack","summary":"Download the Passive BOM delivery packs (engineer + machine)","description":"Returns the downloadable Passive BOM delivery-pack FILES the base /jobs/[id]/passive-bom route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.passive_bom_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Passive BOM pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/peripheral-matrix/pack":{"get":{"operationId":"getJobPeripheralMatrixPack","summary":"Download the Peripheral Matrix delivery packs (engineer + machine)","description":"Returns the downloadable Peripheral Matrix delivery-pack FILES the base /jobs/[id]/peripheral-matrix route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.peripheral_matrix_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Peripheral Matrix pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/rules/pack":{"get":{"operationId":"getJobPinCautionsPack","summary":"Download the Design Rules delivery packs (engineer + machine)","description":"Returns the downloadable Design Rules delivery-pack FILES the base /jobs/[id]/rules route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.pin_cautions_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Design Rules pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/power-battery/pack":{"get":{"operationId":"getJobPowerBatteryPack","summary":"Download the Power & Battery delivery packs (engineer + machine)","description":"Returns the downloadable Power & Battery delivery-pack FILES the base /jobs/[id]/power-battery route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.power_battery_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Power & Battery pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/register-map/pack":{"get":{"operationId":"getJobRegisterMapPack","summary":"Download the Register Map delivery packs (engineer + machine)","description":"Returns the downloadable Register Map delivery-pack FILES the base /jobs/[id]/register-map route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.register_map_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Register Map pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/timing/pack":{"get":{"operationId":"getJobTimingPack","summary":"Download the Timing delivery packs (engineer + machine)","description":"Returns the downloadable Timing delivery-pack FILES the base /jobs/[id]/timing route does not: the engineer pack (README + human-readable CSV/JSON files) and, when the module ships one, the machine pack (manifest + canonical + audit + evidence_map — the evidence rows, with each value's source page where recorded). Read from the stored packs the aggregator persisted on audit_outputs.timing_{engineer,machine}_outputs.\n\nUniform across every module: with no query params it returns both packs as one JSON manifest ({ data: { engineer, machine }, metadata }); ?view=engineer|machine narrows to one; ?view=<view>&file=<name> downloads a single file with its own Content-Type as an attachment. A module that ships only an engineer pack returns machine: null. A job extracted before the packs existed has none; re-extract.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"view","in":"query","required":false,"schema":{"type":"string","enum":["engineer","machine"]},"description":"Narrow to one pack. Required when `file` is given."},{"name":"file","in":"query","required":false,"schema":{"type":"string"},"description":"Download a single named file from the chosen view, served with its own Content-Type as an attachment."},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"},"description":"Optional bound bypass/session token for controlled job-result access. Authenticated user sessions may also be used."}],"responses":{"200":{"description":"The pack manifest (JSON), or a single pack file with its own Content-Type when `file` is given.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}},"text/csv":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}},"400":{"description":"Unknown view, or a file requested without a view.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Authentication required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Authenticated user cannot read this job.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"No stored Timing pack for this job, or the named file is not in the pack.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/altium":{"get":{"operationId":"getJobAltiumPayload","summary":"Get the extracted Altium ASCII footprint payload","description":"Parses an existing Altium ASCII footprint export (not binary .PcbLib/.SchLib) and returns the extracted geometry as a reviewable payload; it does not build Altium files from a datasheet PDF.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Altium CAD package returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/kicad":{"get":{"operationId":"getJobKicadPayload","summary":"Get KiCad footprint (.kicad_mod) and symbol (.kicad_sym) libraries","description":"Returns generated KiCad symbol (.kicad_sym) and footprint (.kicad_mod) files, each loaded with kicad-cli where it is installed (a file-format check, not a DRC or ERC) and given a review status (bundle_status).","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"KiCad CAD package returned successfully.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Module output was not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/jobs/{id}/evidence-boxes":{"get":{"operationId":"getJobEvidenceBoxes","summary":"Locate every extracted value on its cited source page","description":"For every extracted value of the job (one module, or every module), finds the exact words on the source page the extraction cites and returns their box: x, y, width, height normalized 0-1 to the page (origin top-left) plus bounds_pt in PDF points. Each value gets exactly one status: located (its words boxed, inside or beside the cited snippet), located_value_only (its words occur once on the page and are boxed, but the cited snippet is not on the page), located_snippet_only (the cited snippet is boxed, the value text is not inside it), ambiguous (found more than once; no box is guessed), not_found, no_text_layer, page_unavailable, map_unavailable, map_expired, no_evidence_page or no_value_to_find (the output states no value text and no snippet). box_scope says how tight a box is: value (exactly the value's characters), value_estimated (the value sits inside a longer printed label; its box is estimated from its character offsets, the whole label is in container_boxes), label (could not be narrowed, e.g. vertical text: the whole label is boxed) or snippet (located_snippet_only: the cited snippet, not the value); matched_text is the text inside the boxes. data.coverage counts the statuses for the window returned and adds up to data.targets_returned; page with limit/offset (data.next_offset). Modules without per-value page evidence (kicad, altium and other generated outputs) are listed in data.modules as not_applicable with the reason. Deterministic: no model call, nothing stored. Also served over MCP as datasheetvend_locate_evidence.","tags":["Modules"],"parameters":[{"name":"id","in":"path","required":true,"description":"DatasheetVend job ID.","schema":{"type":"string"}},{"name":"module","in":"query","required":false,"description":"One module id (for example pinout, absolute_max, register_map). Omit for every module; an unknown id answers 400 UNKNOWN_EVIDENCE_MODULE.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Values to locate in this answer, 1-1000 (default 200).","schema":{"type":"integer","minimum":1,"maximum":1000}},{"name":"offset","in":"query","required":false,"description":"Skip this many values (default 0).","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"Evidence locations and coverage returned.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Unknown module or invalid paging.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"JobApiManifest":{"type":"object","required":["file_kind","schema_version","job","access","artifacts","modules","links","warnings"],"properties":{"file_kind":{"type":"string","const":"job.api_manifest"},"schema_version":{"type":"string","const":"job_api_manifest_v1"},"job":{"type":"object","additionalProperties":true},"access":{"type":"object","additionalProperties":true},"artifacts":{"type":"object","additionalProperties":true},"modules":{"type":"object","additionalProperties":{"type":"object","additionalProperties":true}},"links":{"type":"object","additionalProperties":true},"warnings":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"PinoutApiPayload":{"type":"object","required":["file_kind","schema_version","module_id","status","machine_use","identity","summary","data","support_files","source_contract"],"properties":{"file_kind":{"type":"string","const":"pinout.api_payload"},"schema_version":{"type":"string","const":"pinout_api_payload_v1"},"module_id":{"type":"string","const":"pinout"},"status":{"type":"object","additionalProperties":true},"machine_use":{"type":"object","additionalProperties":true},"identity":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"data":{"type":"object","additionalProperties":true,"properties":{}},"support_files":{"type":"array","items":{"type":"string"}},"source_contract":{"type":"string","const":"machine_context.json"}},"additionalProperties":true},"FootprintApiPayload":{"type":"object","required":["file_kind","schema_version","module_id","status","machine_use","identity","summary","data","support_files","source_contract"],"properties":{"file_kind":{"type":"string","const":"footprint.api_payload"},"schema_version":{"type":"string","const":"footprint_api_payload_v1"},"module_id":{"type":"string","const":"footprint"},"status":{"type":"object","additionalProperties":true},"machine_use":{"type":"object","additionalProperties":true},"identity":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true,"properties":{"has_explicit_pad_map":{"type":"boolean"},"has_pad_geometry_truth":{"type":"boolean","description":"True when the Footprint machine context exposes shared pad_geometry_truth for downstream CAD/EDA consumers."}}},"data":{"type":"object","additionalProperties":true,"properties":{"pad_geometry_truth":{"type":["object","null"],"description":"Shared PadGeometryTruth map produced from Footprint explicit pad geometry. Consumers may feed this into KiCad/CAD adapters after respecting review and production flags.","additionalProperties":true,"properties":{"schema_version":{"type":"string","const":"pad_geometry_truth_v1"},"pads":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}},"support_files":{"type":"array","items":{"type":"string"}},"source_contract":{"type":"string","const":"machine_context.json"}},"additionalProperties":true},"ThermalApiPayload":{"type":"object","required":["file_kind","schema_version","module_id","status","machine_use","summary","data","support_files","source_contract"],"properties":{"file_kind":{"type":"string","const":"thermal.api_payload"},"schema_version":{"type":"string","const":"thermal_api_payload_v1"},"module_id":{"type":"string","const":"thermal"},"status":{"type":"object","additionalProperties":true},"machine_use":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"data":{"type":"object","additionalProperties":true},"support_files":{"type":"array","items":{"type":"string"}},"source_contract":{"type":"string","const":"machine_context.json"}},"additionalProperties":true},"RegisterMapApiPayload":{"type":"object","required":["file_kind","schema_version","module_id","status","machine_use","summary","data","support_files","source_contract"],"properties":{"file_kind":{"type":"string","const":"register_map.api_payload"},"schema_version":{"type":"string","const":"register_map_api_payload_v1"},"module_id":{"type":"string","const":"register_map"},"status":{"type":"object","additionalProperties":true},"machine_use":{"type":"object","additionalProperties":true},"summary":{"type":"object","additionalProperties":true},"data":{"type":"object","additionalProperties":true,"properties":{"source_document":{"type":["object","null"],"description":"null when the registers were read from the job's datasheet. Otherwise where they come from, also marked on each register as source_document: (1) the vendor's machine-readable register file (CMSIS-SVD) for the part, used when the datasheet points to another document and exactly one pinned, permissively licensed file names the part ({role: 'vendor_register_file', vendor, file_id, device_name, repository, commit, path, sha256, license, license_notice, core_view, identity: 'confirmed', identity_basis, cross_check: {bases_agreeing, bases_disagreeing, examples}}; its registers have no source_page); or (2) the reference manual attached to the job ({role: 'reference_manual', filename, document_id, pages, identity: confirmed|unconfirmed, identity_basis}; every register's source_page is a page of that manual).","additionalProperties":true}}},"support_files":{"type":"array","items":{"type":"string"}},"source_contract":{"type":"string","const":"machine_context.json"}},"additionalProperties":true},"ErrorResponse":{"type":"object","additionalProperties":true,"properties":{"error":{"oneOf":[{"type":"string"},{"type":"object","additionalProperties":true,"properties":{"code":{"type":"string"},"message":{"type":"string"},"detail":{"type":"string"}}}]},"metadata":{"type":"object","additionalProperties":true}}}},"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"dsv_...","description":"DatasheetVend Developer API Key with appropriate scopes (e.g. dmap)."},"StripeMachinePayment":{"type":"http","scheme":"payment","description":"Stripe Machine Payments Protocol (MPP) HTTP 402 challenge using Shared Payment Tokens (SPTs) or Link Agent Wallets."}}}}