---
title: "Finds tool calibration records based on search parameters. Rows exclude the per-checkpoint
measurements; fetch a record by id for those."
method: POST
path: "/api/tool-calibrations/list"
tags: ["Tool Calibration"]
---

# Finds tool calibration records based on search parameters. Rows exclude the per-checkpoint
measurements; fetch a record by id for those.

`POST /api/tool-calibrations/list`

## Query parameters

- `Sort.Field` string
- `Sort.Dir` 'ascending' | 'descending' — Specify sorting direction.
- `Skip` integer
- `Take` integer

## Request body

- ToolCalibrationsListParameters — Filters for the tool calibration record list. All filters are optional and combine with AND semantics (list-valued filters match any of their values).
  - `toolId` string, nullable — Only calibration records for this tool
  - `calibratedByVendorId` string, nullable — Only calibration records performed by this vendor
  - `search` string, nullable — Search over tool name/serial number/type, master gauge names, certificate number, and notes
  - `toolTypes` ToolType[], nullable — Only calibration records for tools of these types
  - `results` ToolCalibrationEnumCalibrationResult[], nullable — Only calibration records with these results
  - `calibrationDateFromUtc` string, date-time, nullable — Only calibration records performed on or after this UTC instant
  - `calibrationDateToUtc` string, date-time, nullable — Only calibration records performed on or before this UTC instant

## Response `200`

The matching calibration records

- DtoPagedResultDtoToolCalibrationSummaryDto — Paged result
  - `data` ToolCalibrationSummaryDto[], required — The data
    - `id` string, nullable — The id of the calibration record
    - `tool` ToolCalibrationToolReferenceDto — The tool a calibration record belongs to.
      - `id` string, nullable — The id of the tool
      - `name` string, nullable — The name 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.
      - `serialNumber` string, nullable — The serial number of the tool
    - `calibrationSource` 'user' | 'vendor' | 'customer' — Who performed the calibration. Mirrors FulcrumProduct.Domain.ToolCalibrations.CalibrationSource by underlying value.
    - `calibratedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `result` 'fail' | 'pass' | 'notApplicable' — The outcome of a calibration. Mirrors FulcrumProduct.Domain.ToolCalibrations.Data.CalibrationResult by underlying value.
    - `asFoundResult` 'fail' | 'pass' | 'notApplicable' — The outcome of a calibration. Mirrors FulcrumProduct.Domain.ToolCalibrations.Data.CalibrationResult by underlying value.
    - `calibrationDateUtc` string, date-time, nullable — When the calibration was performed (UTC)
    - `masterGageNames` string, nullable — Display labels of the master gauges used: the masters the record's measurements were taken against for in-house records, or the free-text value supplied with an external record
    - `certificateNumber` string, nullable — The external certificate number supplied with the calibration
    - `notes` string, nullable — Free-text notes
    - `asFoundNotes` string, nullable — Free-text notes about the As-Found state
    - `tempDegC` number, double, nullable — Ambient temperature (deg C) captured during calibration
    - `relHumidity` number, double, nullable — Ambient relative humidity (%) captured during calibration
    - `templateVersion` integer, nullable — The template version the record was measured against, pinned at create time; null for template-less and external records
    - `signedBy` CommonReferenceDto — Represents a reference to a document in a DB collection
      - `id` string, nullable — Unique Id associated to the referenced object
      - `name` string, nullable — Descriptive name associated to the object
    - `signedUtc` string, date-time, nullable — When the record was signed (UTC); null until signed
  - `page` integer, required — The 1-indexed page
  - `pageSize` integer, required — The page size
  - `totalCount` integer, required — The total count of records
  - `totalPages` integer, required — The total pages
  - `hasPreviousPage` boolean, required — True if there is a previous page
  - `hasNextPage` boolean, required — True if there is a next page

---

[API](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi.md) · [All operations](https://skmtc.net/fulcrumpro/apis/fulcrum-publicapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fulcrumpro/fulcrum-publicapi/versions/1b5649cff14a/schema)