FHIR © HL7.org  |  Server Home  |  XIG Home  |  XIG Stats  |  Server Source  |  FHIR  

FHIR IG Statistics: OperationDefinition/bc-entity-practitioner-query

Packagefhir.ca-bc.provider
Resource TypeOperationDefinition
Idbc-entity-practitioner-query
FHIR VersionR4
Sourcehttps://simplifier.net/resolve?scope=fhir.ca-bc.provider@1.0.1&canonical=http://hlth.gov.bc.ca/fhir/provider/OperationDefinition/bc-entity-practitioner-query
URLhttp://hlth.gov.bc.ca/fhir/provider/OperationDefinition/bc-entity-practitioner-query
Version1.0.0
Statusactive
Date2025-02-28T00:26:03+00:00
NamePractitionerEntityQuery
TitleQuery for a practitioner without returning associations
Realmus
Authorityhl7
DescriptionThis operation is used to query for a practitioner and will return the information for that practitioner without following associations to other providers, organizations, or facilities.
Typetrue
Kindquery

Resources that use this resource

CapabilityStatement
bc-plr-server-capability-statementBC PLR Server Capability Statement

Resources that this resource uses

No resources found


Narrative

Note: links and images are rebased to the (stated) source

Generated Narrative: OperationDefinition bc-entity-practitioner-query

URL: [base]/Practitioner/$entityQuery

URL: [base]/Practitioner/[id]/$entityQuery

Parameters

UseNameScopeCardinalityTypeBindingDocumentation
INidentifier0..1string
(string)

String, representing the full identifier value with system and value, e.g. identifier=[system]|[value]

INfamily0..1string
(string)

Search for practitioners with the specified surname. May use trailing wildcards, e.g. Smith*

INgiven0..1string
(string)

Search for practitioners with the specified given name. May use trailing wildcards, e.g. Ann*

INstatus0..1string
(token)

Search for practitioners with a license that has the specified status.

INaddress-city0..1string
(string)

Search for practitioners with an address that includes the given city.

INgender0..1string
(token)

Search for practitioners with the specified gender.

INrole0..1string
(token)

Search for practitioners that have an associated PractitionerRole code with the specified value (e.g. MD or RN)

INcommunication0..1string
(token)

Search for practitioners who can communicate with the specified language code. May be a comma separated list of language codes, e.g. F01,E09.

INexpertise0..1string
(token)

Search for practitioners with a qualification that matches the specified expertise. May be a comma separated list of expertise codes, e.g. AM53,K34.

INstatus-reason0..1string
(token)

Search for practitioners with a license that has the specified status reason.

INwithHistory0..1boolean

true or false, The withHistory parameter instructs PLR to search through historical records for matching attributes. Only the current data is returned.

OUTbundle1..1Bundle

The Response Bundle with the OperationOutcome and the list of BCPractitionerBundle found by the search.


Source

{
  "resourceType": "OperationDefinition",
  "id": "bc-entity-practitioner-query",
  "text": {
    "status": "generated",
    "div": "<!-- snip (see above) -->"
  },
  "url": "http://hlth.gov.bc.ca/fhir/provider/OperationDefinition/bc-entity-practitioner-query",
  "version": "1.0.0",
  "name": "PractitionerEntityQuery",
  "title": "Query for a practitioner without returning associations",
  "status": "active",
  "kind": "query",
  "date": "2025-02-28T00:26:03+00:00",
  "publisher": "BC Ministry of Health",
  "contact": [
    {
      "name": "BC Ministry of Health",
      "telecom": [
        {
          "system": "url",
          "value": "https://www2.gov.bc.ca/gov/content/governments/organizational-structure/ministries-organizations/ministries/health"
        }
      ]
    }
  ],
  "description": "This operation is used to query for a practitioner and will return the information for that practitioner without following associations to other providers, organizations, or facilities.",
  "jurisdiction": [
    {
      "coding": [
        {
          "system": "urn:iso:std:iso:3166",
          "code": "CA",
          "display": "Canada"
        }
      ]
    }
  ],
  "code": "entityQuery",
  "resource": [
    "Practitioner"
  ],
  "system": false,
  "type": true,
  "instance": true,
  "parameter": [
    {
      "name": "identifier",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "String, representing the full identifier value with system and value, e.g. identifier=[system]|[value]",
      "type": "string",
      "searchType": "string"
    },
    {
      "name": "family",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with the specified surname. May use trailing wildcards, e.g. Smith*",
      "type": "string",
      "searchType": "string"
    },
    {
      "name": "given",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with the specified given name. May use trailing wildcards, e.g. Ann*",
      "type": "string",
      "searchType": "string"
    },
    {
      "name": "status",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with a license that has the specified status.",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "address-city",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with an address that includes the given city.",
      "type": "string",
      "searchType": "string"
    },
    {
      "name": "gender",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with the specified gender.",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "role",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners that have an associated PractitionerRole code with the specified value (e.g. MD or RN)",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "communication",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners who can communicate with the specified language code. May be a comma separated list of language codes, e.g. F01,E09.",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "expertise",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with a qualification that matches the specified expertise. May be a comma separated list of expertise codes, e.g. AM53,K34.",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "status-reason",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "Search for practitioners with a license that has the specified status reason.",
      "type": "string",
      "searchType": "token"
    },
    {
      "name": "withHistory",
      "use": "in",
      "min": 0,
      "max": "1",
      "documentation": "true or false, The withHistory parameter instructs PLR to search through historical records for matching attributes. Only the current data is returned.",
      "type": "boolean"
    },
    {
      "name": "bundle",
      "use": "out",
      "min": 1,
      "max": "1",
      "documentation": "The Response Bundle with the OperationOutcome and the list of BCPractitionerBundle found by the search.",
      "type": "Bundle"
    }
  ]
}