Overview

Server-to-server integrations for external systems (EMR, LIS, witnessing systems) that need to request, audit, and manage subject samples storage and retrieval operations across your facilities.

API version

Current version: 1.0

All endpoints are prefixed with /api/v1/external. In code examples throughout this documentation, your-api-host is a placeholder for the hostname of your Crinsutrack instance.

Resources overview

The Crinsutrack API is organized around these core resources:

Resource	Description
Organization	Top-level account representing a company or institution
Facility	Physical location (lab, storage site) where procedures are performed
Subject	Individual whose samples are stored
Sample Container	Physical container (vial, straw) holding cryopreserved material
Storage Solution	Physical cryogenic unit (tank, dewar) holding cryopreserved containers across multiple levels (canister, cane). Integrations can query available solutions and their current inventory within a facility.
Procedure	A cryogenic operation performed on a storage solution, including store, retrieval, and LN2 refill. Integrations can create and track the full lifecycle from request through facility staff review to device execution and completion.

All resources are scoped by organization. B2B integrations can only access data within their authorized organization’s facilities.

Rate limits

Tier	Requests per minute
Standard	60

Contact your Crinsutrack administrator for rate limit increases.

Response format

All API responses are returned in JSON format. Single-resource endpoints return a JSON object; list endpoints return a JSON array.

Error handling

Error responses include a descriptive message:

{
  "error": {
    "code": "FORBIDDEN",
    "message": "Insufficient permissions to perform this operation"
  }
}

Code	Description
UNAUTHORIZED	Invalid or expired token
FORBIDDEN	Operation not permitted for B2B integrations
NOT_FOUND	Resource does not exist
VALIDATION_ERROR	Invalid request data

Support

For API support, contact your Crinsutrack administrator or email support@crinsurancelife.com.