B2B Integration Overview
B2B Integration
Section titled “B2B Integration”Server-to-server integrations for external systems (EMR, LIS, etc.) that need to request storage and retrieval operations.
B2B integrations authenticate using OAuth 2.0 Client Credentials and can:
- Create and view subjects
- Create procedure requests
- Track request status and linked procedures
- View sample containers, storage inventory, and procedures
Base URL
Section titled “Base URL”| Environment | URL |
|---|---|
| Production | https://api.crinsutrack.com |
| Sandbox | https://api-sandbox.crinsutrack.com |
API Version
Section titled “API Version”Current version: 1.0
All endpoints are prefixed with /api/.
Authentication
Section titled “Authentication”B2B integrations use OAuth 2.0 Client Credentials flow. See the Authentication guide for setup instructions.
Rate Limits
Section titled “Rate Limits”| Tier | Requests per minute |
|---|---|
| Standard | 60 |
Contact your Crinsutrack administrator for rate limit increases.
Response Format
Section titled “Response Format”All API responses are returned in JSON format:
{ "data": { ... }, "meta": { "page": 1, "perPage": 10, "total": 100 }}Error Handling
Section titled “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
Section titled “Support”For API support, contact your Crinsutrack administrator or email api-support@crinsutrack.com.