Get a unit's as-built record

GET

/serials/{id}/as-built

const url = 'https://app.buildtrace.eu/api/serials/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/as-built';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://app.buildtrace.eu/api/serials/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/as-built \
  --header 'Authorization: Bearer <token>'

Required scope: inventory:read.

Authorizations

bearerAuth

Parameters

Path Parameters

required

string format: uuid

Responses

200

application/json

object

record

required

object

required

string format: uuid

serialId

required

string format: uuid

partRevisionId

required

string format: uuid

builtByOrderId

required

string format: uuid

items

required

Array<object>

object

childSerialId

string format: uuid

childRevisionId

required

string format: uuid

lot

string

quantity

required

string

refDesignator

string

childPartCode

Part code of the consumed item (read-only).

string

childPartName

Part name of the consumed item (read-only).

string

childRevisionLabel

Revision label of the consumed item (read-only).

string

childSerialNumber

Serial number of a serialized consumed item (read-only).

string

ecos

required

Array<object>

object

ecoId

required

string format: uuid

disposition

required

string

skippedReason

string

ecoNumber

ECO number (read-only).

string

ecoTitle

ECO title (read-only).

string

workInstructionSnapshot

The work instruction in force when this unit was built, frozen at produce time. Absent for units built before snapshots were recorded, or where the revision had no instruction. Absent means “not recorded”, never “no instruction”. Opaque: stored as written so it cannot be reshaped by later API changes.

object

key

additional properties

any

completedStepSequences

Step sequences the builder ticked off, against the snapshot above. Self-reported at produce time; there is no second signature and no per-step timestamp.

Array<integer>

finalTestResult

How the unit’s final test came out when it was built. NOT_TESTED: the revision had no final test. Absent for units built before this was recorded.

string

Allowed values: PASS FAIL NOT_TESTED

testPlanSnapshot

The final test plan the unit was tested against, frozen at produce time: its identity (testPlanId, version, and ecoNumber when an ECO’s plan was in force) and every check with its limits. Absent when no test was run. Opaque, stored as written.

object

key

additional properties

any

Example

{
  "finalTestResult": "PASS"
}

401

Unauthorized

404

Not found