> ## 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

> List and inspect regulatory documents

# 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

```bash theme={null}
GET /api/workspaces/:workspaceId/references
```

<ParamField query="search" type="string">
  Search by title or external ID
</ParamField>

<ParamField query="source" type="string">
  Filter by source ID
</ParamField>

<ParamField query="type" type="string">
  Filter by type: `"regulation"`, `"guidance"`, or `"standard"`
</ParamField>

**Response:**

```json theme={null}
[
  {
    "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"
    }
  }
]
```

<Note>
  References respect the subscription model: source subscribed + reference not explicitly unsubscribed, OR reference explicitly subscribed regardless of source.
</Note>

## Get reference detail

```bash theme={null}
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:**

```json theme={null}
{
  "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"
      }
    }
  ]
}
```

<Note>
  `sharedFile.signedUrl` is a temporary S3 URL. It expires after a few hours — fetch a fresh one by calling this endpoint again.
</Note>