Solia Direct DocsControl Plane
⌘K

API ReferenceReference

Laboratory endpoints

Exact request and response contracts for the laboratory endpoints, generated from the enforced Partner API contract.

Machine-readable OpenAPI description

Endpoints in this group

GET/v1/labRetrieve the laboratory capability profile

Base path: /api/public/partner/v1. Every response carries request_id; every failure uses the standard error envelope documented under Errors.

GET/v1/lab

Retrieve the laboratory capability profile

Canonical, non-secret capability truth for the laboratory this key belongs to. Certification identifiers (CLIA, CAP) are not modeled in Solia today and are therefore reported as not_modeled rather than claimed, and the identity state is a laboratory self-declaration, never a verification.

Authentication & scope

  • Authentication: Authorization: Bearer <API key>. The key is bound to one laboratory, one API client and one environment.
  • Required scope: catalog:read. A key without it is refused with 403 forbidden.

Responses

  • 200 — The capability profile.
  • 403 — The key lacks catalog:read.
json
{
  "data": {
    "laboratory_id": "8f14e45f-ceea-4c2b-9b3f-2a1d0c7b6a11",
    "display_name": "string",
    "legal_name": "string",
    "operating_name": "string",
    "environment": "sandbox",
    "certifications": {
      "state": "not_modeled",
      "identifiers": [
        "string"
      ]
    },
    "jurisdictions": [
      "string"
    ],
    "service_geography": [
      "string"
    ],
    "collection_methods": [
      "string"
    ],
    "collection_modes": [
      "string"
    ],
    "specimen_categories": [
      "string"
    ],
    "coding_systems_supplied": [
      "string"
    ]
  },
  "request_id": "string",
  "cursor": "string"
}