Sign in

v2

latestOpenAPI 3.0.42026-08-084694591.6 MB
Tool

Get a tool by id, including its calibration schedule and latest calibration outcome.

get/api/tools/{id}

Path parameters

idstring required

Response

The tool for the given id

idstring nullable

The id of the tool

numberinteger nullable

The tool's sequential number, unique within the tenant (displayed as T-{number})

namestring nullable

The name of the tool

serialNumberstring nullable

The serial number of the tool

toolType'bevelProtractor' | 'bendAngleGage' | 'boreGage' | 'caliper' | 'cmm' | 'coatingThicknessGage' | 'depthMicrometer' | 'gageBlocks' | 'hardnessTester' | 'heightGage' | 'micrometer' | 'opticalComparator' | 'pinGage' | 'plugGage' | 'radiusGage' | 'sineBar' | 'surfacePlate' | 'surfaceRoughnessTester' | 'thicknessGage' | 'threadPlugGage' | 'threadRingGage' | 'vmm' | 'attributeGage' | 'calibrationArtifact' | 'indicator' | 'calibrationStandard' | 'chamferGage' | 'lightMeter' | 'presetter' | 'digitalConductivityMeter' | 'ringGage' | 'profilometer' | 'splineGage' | 'tapeMeasure' | 'thermometer' | 'stopwatch' | 'torqueWrench' | 'instantMeasurementSystem' | 'protractor' | 'pressureGage' | 'tubeGage' | 'tubeMicrometer' | 'thermocouple' | 'ohmMeter' | 'multimeter' | 'weight' | 'fixture' | 'machine' | 'hygrothermometer' | 'concentricityGage' | 'cmmDatumSphere' | 'threadMicrometer' | 'insideMicrometer' | 'pinMicrometer' | 'setPlug' | 'nptRingGage' | 'nptPlugGage' | 'grooveMicrometer' | 'weldingEquipment' | 'surfaceTesterMaster'

The type of tool in the calibration system. Member values mirror FulcrumProduct.Domain.ToolCalibrations.Data.ToolType one-to-one (guarded by ToolCalibrationEnumParityTests) so tools map by underlying value.

toolStatus'active' | 'inactive'

Whether the tool is in service. Mirrors FulcrumProduct.Domain.Tools.Data.ToolStatus by underlying value.

toolInactiveReason'lost' | 'damaged' | 'requiresRepair' | 'retired' | 'outForCalibration'

Why an inactive tool is out of service. Mirrors FulcrumProduct.Domain.Tools.Data.ToolInactiveReason by underlying value.

calibrationFrequency'recurringDays' | 'recurringMonths' | 'endOfMonth' | 'endOfQuarter' | 'endOfYear' | 'none'

How often the tool requires calibration. Mirrors FulcrumProduct.Domain.Tools.Data.CalibrationFrequency by underlying value.

calibrationIntervalinteger nullable

The interval count paired with a recurring calibration frequency (days or months)

lastCalibrationDateUtcstring date-time nullable

When the tool was last calibrated (UTC)

nextCalibrationDateUtcstring date-time nullable

When the tool's next calibration is due (UTC, computed); null for reference gages and never-calibrated tools

lastCalibrationResult'fail' | 'pass' | 'notApplicable'

The outcome of a calibration. Mirrors FulcrumProduct.Domain.ToolCalibrations.Data.CalibrationResult by underlying value.

notesstring nullable

Free-text notes

defaultUnitOfMeasureNamestring nullable

The unit of measure the tool measures in

measurementRangeMinnumber double nullable

The lower bound of the tool's measurement range

measurementRangeMaxnumber double nullable

The upper bound of the tool's measurement range

accuracynumber double nullable

The tool's rated accuracy

accuracyPrecisioninteger nullable

The decimal precision of the rated accuracy

modifiedUtcstring date-time nullable

When the tool was last modified (UTC); supports incremental sync

outForRecalibrationDateUtcstring date-time nullable

When the tool left the shop for recalibration (UTC). Null means the tool is on site; a value means it has been out since that date, and requires the outForCalibration inactive reason