Skip to content

Location resource (FHIR R4)

Location is the FHIR R4 resource for details and position information for a physical place where services are provided and resources and participants may be stored, found, contained, or accommodated.

ResourceLocation
FHIR versionR4 (4.0.1)
Canonical URLhttp://hl7.org/fhir/StructureDefinition/Location
Required elementsnone; every top-level element is optional (min 0) in base R4
IG profiles in this catalog3

Example

{
  "resourceType": "Location",
  "id": "location-f4926e2799e283bd2952773edac471ae",
  "status": "active",
  "name": "Emergency Department",
  "mode": "instance",
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/v3-RoleCode",
          "code": "HOSP",
          "display": "Hospital"
        }
      ]
    }
  ],
  "telecom": [
    {
      "system": "phone",
      "value": "+1-555-534-7667",
      "use": "work"
    }
  ],
  "address": {
    "use": "work",
    "type": "physical",
    "line": [
      "483 Hospital Dr"
    ],
    "city": "Medical City",
    "state": "MC",
    "postalCode": "75277",
    "country": "US"
  },
  "position": {
    "longitude": -63.23242305923664,
    "latitude": 42.56192131162163
  },
  "managingOrganization": {
    "reference": "Organization/organization-main",
    "display": "General Hospital"
  }
}

Generated by the Pidgeon engine: pidgeon generate Location --seed 20260722.

Validation context

  • strict pidgeon validate grades a Location instance against the base R4 structure definition: missing required elements raise REQUIRED_FIELD_MISSING and cardinality violations raise CARDINALITY_MIN or CARDINALITY_MAX.(REQUIRED_FIELD_MISSING)
  • strict Profile validation grades the same instance against an installed IG profile: profile cardinality findings carry FHIR-PROFILE-CARDINALITY and terminology binding findings carry FHIR-PROFILE-BINDING.(FHIR-PROFILE-CARDINALITY)

This answer, in your terminal

pidgeon lookup Location

Wire it into your AI agent:

claude mcp add pidgeon -- npx -y @pidgeonhealth/mcp

Download Post free to browse this reference with generation attached.

FHIR® R4 © Health Level Seven International. FHIR R4 specification content is used under its CC0 license; this page is a derivative work and is not endorsed by HL7 International.

HL7® and FHIR® are registered trademarks of Health Level Seven International.

Published by Pattern Engine LLC (Pidgeon Health).

Rendered from the same machine-readable definitions the Pidgeon engine validates against. Exported from the Pidgeon engine's FHIR R4 definitions (CC0); example generated with seed 20260722.