documentreference.json

{
   "resource": "DocumentReference",
   "toolName": "documentreference",
   "title": "Document Reference",
   "description": "Search for or read a FHIR DocumentReference resource indexing clinical documents, notes, PDFs, and images. For direct read, provide _id alone. For search, provide patient, subject, identifier, encounter, author, custodian, or relatesto. Use category or type to narrow results. For quantitative analysis, prefer structured resources before DocumentReference unless the user explicitly asks for narrative documentation.",
   "supportsDirectRead": true,
   "searchParams": {
      "_id": "DocumentReference resource ID — performs direct read when provided alone",
      "_lastupdated": "Filter by meta.lastUpdated date or date range",
      "authenticator": "Who/what authenticated the document",
      "author": "Who authored the document",
      "category": "Document categorization",
      "contenttype": "MIME type of the document content",
      "custodian": "Organization maintaining the document",
      "date": "When the document reference was created",
      "description": "Human-readable description",
      "docstatus": "Status of the underlying document: preliminary, final, amended, entered-in-error",
      "encounter": "Encounter context of the document",
      "event": "Main clinical acts documented",
      "facility": "Kind of facility where patient was seen",
      "format": "Format/content rules for the document",
      "identifier": "Business identifier",
      "language": "Human language of the content",
      "location": "URI where the data can be found",
      "patient": "Patient resource ID or reference",
      "period": "Time period the document content covers",
      "related": "Related identifiers or resources",
      "relatesto": "Target of the relationship (DocumentReference reference)",
      "relation": "Type of relationship: replaces, transforms, signs, appends",
      "relationship": "Combination of relation and relatesto",
      "security-label": "Document security-tags",
      "setting": "Additional context of the document content (practice setting)",
      "status": "Document status: current, superseded, entered-in-error",
      "subject": "Subject of the document (Patient or Group)",
      "type": "Kind of document (LOINC preferred)"
   },
   "requireOneOf": [
      "patient",
      "subject",
      "identifier",
      "encounter",
      "author",
      "custodian",
      "relatesto"
   ]
}