Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.qalico.com/llms.txt

Use this file to discover all available pages before exploring further.

References

References are individual regulatory documents within a source — regulations, guidances, and standards. Only references from subscribed sources (or explicitly subscribed references) are returned.

List references

GET /api/workspaces/:workspaceId/references
Search by title or external ID
source
string
Filter by source ID
type
string
Filter by type: "regulation", "guidance", or "standard"
Response:
[
  {
    "id": "ref-uuid",
    "externalId": "21cfr-820",
    "title": "21 CFR Part 820 — Quality System Regulation",
    "type": "regulation",
    "url": "https://www.ecfr.gov/...",
    "source": {
      "id": "fda_21cfr",
      "title": "FDA 21 CFR",
      "geography": "us",
      "institutionName": "FDA"
    }
  }
]
References respect the subscription model: source subscribed + reference not explicitly unsubscribed, OR reference explicitly subscribed regardless of source.

Get reference detail

GET /api/workspaces/:workspaceId/references/:referenceId
Returns the full document with version history. Each version includes a signed URL for the PDF if available. Response:
{
  "id": "ref-uuid",
  "externalId": "21cfr-820",
  "title": "21 CFR Part 820 — Quality System Regulation",
  "description": "Current good manufacturing practice...",
  "type": "regulation",
  "url": "https://www.ecfr.gov/...",
  "source": {
    "id": "fda_21cfr",
    "title": "FDA 21 CFR",
    "geography": "us",
    "institutionName": "FDA"
  },
  "versions": [
    {
      "id": "version-uuid",
      "effectiveDate": "2026-02-02T00:00:00.000Z",
      "status": "final",
      "url": "https://...",
      "sharedFile": {
        "id": "file-uuid",
        "name": "21cfr-820-v2.pdf",
        "signedUrl": "https://s3.amazonaws.com/..."
      },
      "update": {
        "id": "update-uuid",
        "updateType": "revision",
        "shortSummary": "Aligned with ISO 13485",
        "publicationDate": "2026-01-15T00:00:00.000Z"
      }
    }
  ]
}
sharedFile.signedUrl is a temporary S3 URL. It expires after a few hours — fetch a fresh one by calling this endpoint again.