Overview

Server-to-server integrations for external systems (EMR, LIS, etc.) that need to request storage and retrieval operations.

API version

Current version: 1.0

All endpoints are prefixed with /api/v1/external.

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
Container	Storage level within a storage solution (canister, cane, rack, box)
Storage Solution	Physical cryogenic unit (tank, dewar) that holds containers across multiple storage levels. Integrations can query available solutions and their current inventory within a facility.
Procedure	A store or retrieval operation tied to a subject. 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:

{
  "data": { ... },
  "meta": {
    "page": 1,
    "perPage": 10,
    "total": 100
  }
}

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.