> ## Documentation Index > Fetch the complete documentation index at: https://docs.ionworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Get detailed information for a cell measurement > Retrieves detailed information for a specific cell measurement by measurement ID. **Deprecated**: prefer the individual endpoints GET /steps, GET /cycles, GET /time_series, and GET /steps_and_cycles instead. Supports zoom-based resampling: specify x_min, x_max, and x_column to fetch higher resolution data for a specific x-axis range. ## OpenAPI ````yaml https://api.ionworks.com/openapi.json get /cell_measurements/{measurement_id}/detail openapi: 3.1.0 info: title: FastAPI version: 0.1.0 servers: - url: https://api.ionworks.com description: Production security: [] paths: /cell_measurements/{measurement_id}/detail: get: tags: - Cell Measurements summary: Get detailed information for a cell measurement description: |- Retrieves detailed information for a specific cell measurement by measurement ID. **Deprecated**: prefer the individual endpoints GET /steps, GET /cycles, GET /time_series, and GET /steps_and_cycles instead. Supports zoom-based resampling: specify x_min, x_max, and x_column to fetch higher resolution data for a specific x-axis range. operationId: >- get_cell_measurement_detail_cell_measurements__measurement_id__detail_get parameters: - name: measurement_id in: path required: true schema: type: string title: Measurement Id - name: target_rows in: query required: false schema: anyOf: - type: integer minimum: 1 - type: 'null' description: Target rows for downsampled time series title: Target Rows description: Target rows for downsampled time series - name: columns in: query required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of columns to load (e.g., 'time,voltage') title: Columns description: Comma-separated list of columns to load (e.g., 'time,voltage') - name: step_counts in: query required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of step counts to filter (e.g., '0,1,2') title: Step Counts description: Comma-separated list of step counts to filter (e.g., '0,1,2') - name: cycle_counts in: query required: false schema: anyOf: - type: string - type: 'null' description: Comma-separated list of cycle counts to filter (e.g., '1,2,3') title: Cycle Counts description: Comma-separated list of cycle counts to filter (e.g., '1,2,3') - name: time_min in: query required: false schema: anyOf: - type: number - type: 'null' description: 'Deprecated: use x_min with x_column instead.' title: Time Min description: 'Deprecated: use x_min with x_column instead.' - name: time_max in: query required: false schema: anyOf: - type: number - type: 'null' description: 'Deprecated: use x_max with x_column instead.' title: Time Max description: 'Deprecated: use x_max with x_column instead.' - name: x_min in: query required: false schema: anyOf: - type: number - type: 'null' description: Minimum x-axis value to filter title: X Min description: Minimum x-axis value to filter - name: x_max in: query required: false schema: anyOf: - type: number - type: 'null' description: Maximum x-axis value to filter title: X Max description: Maximum x-axis value to filter - name: x_column in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Column name for x-axis filtering (e.g., 'Time [s]' or 'Capacity throughput [A.h]') title: X Column description: >- Column name for x-axis filtering (e.g., 'Time [s]' or 'Capacity throughput [A.h]') - name: include_steps in: query required: false schema: type: boolean description: Include steps in response. default: true title: Include Steps description: Include steps in response. - name: include_time_series in: query required: false schema: type: boolean description: Include time_series in response. default: true title: Include Time Series description: Include time_series in response. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/CellMeasurementDetail' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' deprecated: true components: schemas: CellMeasurementDetail: properties: name: type: string maxLength: 255 minLength: 1 title: Name protocol: anyOf: - additionalProperties: true type: object - type: 'null' title: Protocol description: >- Protocol information. Typical keys: 'name' (str), 'ambient_temperature_degc' (float), 'definition' (dict | str — a UCP protocol definition or another protocol format). start_time: anyOf: - type: string format: date-time - type: 'null' title: Start Time description: >- ISO 8601 datetime with timezone (UTC preferred) marking when the test started. end_time: anyOf: - type: string format: date-time - type: 'null' title: End Time description: >- ISO 8601 datetime with timezone (UTC preferred) marking when the test finished. Leave null while the test is still running; set it once the measurement is complete. A null end_time means the cell is still considered 'on test' in the Lab view. test_setup: anyOf: - additionalProperties: true type: object - type: 'null' title: Test Setup description: >- Physical test setup. Typical keys: 'cycler' (model), 'operator', 'lab', 'channel_number' (int). step_labels_validated: type: boolean title: Step Labels Validated description: >- Set to true only once step-type labels (Rest, CC charge, CV, discharge, etc.) have been manually reviewed. Server-inferred labels should leave this false. default: false notes: anyOf: - type: string - type: 'null' title: Notes description: Free-text notes about the cell measurement measurement_type: $ref: '#/components/schemas/MeasurementType' description: >- What shape of data this measurement holds. Determines which fields are populated and which upload flow applies. See the class docstring. default: time_series properties: anyOf: - additionalProperties: true type: object - type: 'null' title: Properties description: >- Flat key/value measurements, populated only when measurement_type is 'properties'. Numeric values use the Quantity format. Example: {'thickness': {'value': 0.52, 'unit': 'mm'}, 'DCIR': {'value': 12, 'unit': 'mohm'}}. file_metadata: anyOf: - additionalProperties: true type: object - type: 'null' title: File Metadata description: Metadata about uploaded files (MIME types, dimensions, etc.) channel_id: anyOf: - type: string - type: 'null' title: Channel Id description: Optional ID of the channel this measurement ran on. id: type: string title: Id cell_instance_id: type: string title: Cell Instance Id organization_id: type: string title: Organization Id description: Organization this measurement belongs to. project_id: anyOf: - type: string - type: 'null' title: Project Id description: Project this measurement belongs to created_by: anyOf: - type: string - type: 'null' title: Created By description: User ID of the user who created this measurement created_by_email: anyOf: - type: string - type: 'null' title: Created By Email description: Email of the user who created this measurement created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At steps: anyOf: - additionalProperties: items: anyOf: - type: number - type: integer - type: string - type: 'null' type: array type: object - type: 'null' title: Steps time_series: anyOf: - additionalProperties: items: type: number type: array type: object - type: 'null' title: Time Series cycles: anyOf: - additionalProperties: items: anyOf: - type: number - type: integer - type: 'null' type: array type: object - type: 'null' title: Cycles specification: $ref: '#/components/schemas/CellSpecification' instance: $ref: '#/components/schemas/CellInstance' type: object required: - name - id - cell_instance_id - organization_id - created_at - updated_at - specification - instance title: CellMeasurementDetail description: Response model for the /detail endpoint for a single measurement. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError MeasurementType: type: string enum: - time_series - file - properties title: MeasurementType description: |- Shape of the data stored in a cell measurement. - ``time_series`` — cycling / diagnostic data uploaded as columnar time series (and optional step summaries). Default for new measurements. - ``file`` — an opaque file upload (raw cycler export, image, other binary). Metadata about the file is captured in ``file_metadata``; the file content lives in object storage. - ``properties`` — a flat key/value set of measured properties (thickness, mass, DCIR, initial capacity, …) with no time-series data. Numeric values use the Quantity format. CellSpecification: properties: name: type: string title: Name description: Name of the cell specification form_factor: anyOf: - type: string - type: 'null' title: Form Factor description: >- Physical form factor. Common values: '18650', '21700', 'R2032' (coin cell), 'pouch', 'prismatic', 'cylindrical'. manufacturer: anyOf: - type: string - type: 'null' title: Manufacturer description: Who assembled/manufactured the cell ratings: $ref: '#/components/schemas/Ratings' description: >- Electrical ratings from the spec sheet / design targets (rated capacity, voltage min/max, optional nominal voltage, energy, energy densities, max charge/discharge C-rates). See :class:`Ratings`. anode_id: anyOf: - type: string - type: 'null' title: Anode Id description: ID of the anode component cathode_id: anyOf: - type: string - type: 'null' title: Cathode Id description: ID of the cathode component electrolyte_id: anyOf: - type: string - type: 'null' title: Electrolyte Id description: ID of the electrolyte component separator_id: anyOf: - type: string - type: 'null' title: Separator Id description: ID of the separator component case_id: anyOf: - type: string - type: 'null' title: Case Id description: ID of the case component properties: anyOf: - additionalProperties: true type: object - type: 'null' title: Properties description: >- Other design-level properties that are not electrical ratings and not tied to a specific component — e.g. assembly method, overall cell dimensions, mass, target thickness. Numeric values must use the Quantity format ({'value': ..., 'unit': ...}). source: anyOf: - additionalProperties: true type: object - type: 'null' title: Source description: >- Provenance of the design. Typical keys: 'doi', 'citation', 'publication_date' (ISO 8601), 'license', 'creator_name', 'creator_orcid'. Lives on the specification (not the instance) because it describes the published design. notes: anyOf: - type: string - type: 'null' title: Notes description: Free-text notes about the cell specification id: type: string title: Id description: Unique identifier for the cell specification organization_id: type: string title: Organization Id description: Organization ID of the cell specification project_id: anyOf: - type: string - type: 'null' title: Project Id description: Project this cell specification belongs to created_by: anyOf: - type: string - type: 'null' title: Created By description: User ID of the user who created this specification created_by_email: anyOf: - type: string - type: 'null' title: Created By Email description: Email of the user who created this specification instance_ids: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Instance Ids description: List of instance IDs associated with the cell specification type: object required: - name - ratings - id - organization_id title: CellSpecification description: Model representing a cell specification as returned by the API. CellInstance: properties: name: type: string title: Name description: Name of the cell instance (serial number) batch: anyOf: - type: string - type: 'null' title: Batch description: Batch number/identifier date_manufactured: anyOf: - type: string format: date-time - type: 'null' title: Date Manufactured description: Date of manufacture measured_properties: anyOf: - additionalProperties: true type: object - type: 'null' title: Measured Properties description: >- Measured (not designed) properties of this specific cell, grouped by component. Numeric values use the Quantity format. Example: {'cathode': {'loading': {'value': 7.06, 'unit': 'mg.cm-2'}}, 'cell': {'initial_capacity': {'value': 1.08, 'unit': 'A.h'}}}. Designed properties (target loading, rated capacity) belong on the cell specification. notes: anyOf: - type: string - type: 'null' title: Notes description: Free-text notes about the cell instance id: type: string title: Id description: Unique identifier for the cell instance cell_specification_id: type: string title: Cell Specification Id description: Foreign key to the cell specification organization_id: type: string title: Organization Id description: Organization this cell instance belongs to. project_id: anyOf: - type: string - type: 'null' title: Project Id description: Project this cell instance belongs to created_by: anyOf: - type: string - type: 'null' title: Created By description: User ID of the user who created this instance created_by_email: anyOf: - type: string - type: 'null' title: Created By Email description: Email of the user who created this instance created_at: type: string format: date-time title: Created At description: Timestamp when the instance was created updated_at: type: string format: date-time title: Updated At description: Timestamp when the instance was last updated measurement_ids: anyOf: - items: additionalProperties: true type: object type: array - type: 'null' title: Measurement Ids description: List of measurement IDs associated with the cell instance type: object required: - name - id - cell_specification_id - organization_id - created_at - updated_at title: CellInstance description: Model representing a cell instance as returned by the API. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError Ratings: properties: capacity: $ref: '#/components/schemas/Quantity' description: 'Rated capacity, e.g., {''value'': 0.002, ''unit'': ''A.h''}' voltage_min: $ref: '#/components/schemas/Quantity' description: 'Minimum voltage, e.g., {''value'': 2.5, ''unit'': ''V''}' voltage_max: $ref: '#/components/schemas/Quantity' description: 'Maximum voltage, e.g., {''value'': 4.2, ''unit'': ''V''}' nominal_voltage: anyOf: - $ref: '#/components/schemas/Quantity' - type: 'null' description: 'Nominal voltage, e.g., {''value'': 3.6, ''unit'': ''V''}' energy: anyOf: - $ref: '#/components/schemas/Quantity' - type: 'null' description: 'Rated energy, e.g., {''value'': 7.2, ''unit'': ''mW.h''}' energy_density_gravimetric: anyOf: - $ref: '#/components/schemas/Quantity' - type: 'null' description: 'Gravimetric energy density, e.g., {value: 250, unit: ''W.h.kg-1''}' energy_density_volumetric: anyOf: - $ref: '#/components/schemas/Quantity' - type: 'null' description: 'Volumetric energy density, e.g., {''value'': 650, ''unit'': ''W.h.L-1''}' max_discharge_rate: anyOf: - $ref: '#/components/schemas/Quantity' - type: 'null' description: 'Max discharge C-rate, e.g., {''value'': 2, ''unit'': ''C''}' max_charge_rate: anyOf: - $ref: '#/components/schemas/Quantity' - type: 'null' description: 'Max charge C-rate, e.g., {''value'': 1, ''unit'': ''C''}' type: object required: - capacity - voltage_min - voltage_max title: Ratings description: Electrical ratings from spec sheet / design targets. Quantity: properties: value: anyOf: - type: number - type: integer title: Value unit: type: string title: Unit description: >- Unit string in PyBaMM notation: '.'-separated atoms with signed integer exponents (e.g. 'A.h', 'mg.cm-2', 'W.h.kg-1'). Pint-style strings ('A*h', 'mg/cm**2') are also accepted and normalized to PyBaMM notation. Common units: V, A, A.h, W.h, degC, s, ohm. type: object required: - value - unit title: Quantity description: >- A numeric value with its physical unit. All numeric fields that carry physical meaning across the cell-data API (capacities, voltages, masses, temperatures, etc.) use this structured format rather than bare floats. That keeps the units on the wire so the server, clients, and downstream consumers cannot disagree about them. Canonical form: ```json {"value": 1.1, "unit": "A.h"} ``` Common units used across the platform: ``V``, ``A``, ``A.h``, ``W.h``, ``degC``, ``s``, ``ohm``, ``mm``, ``g``, ``mg.cm-2``, ``C`` (C-rate). Units are stored in PyBaMM notation: ``.``-separated atoms with signed integer exponents and no ``*``/``/`` (``mg.cm-2``, ``A.h``, ``W.h.kg-1``). Pint-style strings (``mg/cm**2``, ``A*h``, ``W*h/kg``) are still accepted on input for backwards compatibility and are normalized to PyBaMM notation on construction. Either form parses correctly via :meth:`to_pint`. ````