Jump to

• Request
• Response

Get a procedure by ID

get

/Procedure/{id}

Note: The FHIR API endpoints described below are currently pending production deployment for electronic health record (EHR) environments. Developers are welcome and encouraged to develop against the specifications in anticipation of production availability, which will be announced at a later date.

Retrieves an individual procedure by the associated ID.

Request

Path Parameters

• id(required): string
  The logical resource ID.

Header Parameters

• accept(required): string

  The media type to be requested.

  Example: application/fhir+json

• authorization(required): string
  The credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer Token.

There's no request body for this operation.

Back to Top

Response

200 Response

Successful retrieve response.

Body ()

Root Schema : Procedure

Type: object

Show Source

• basedOn: array basedOn
  (USCDI) A request for this procedure.
• code(required): code
  (USCDI) The identification of the procedure.
• id(required): string
• performedDateTime: string (date-time)
  (USCDI) When the procedure was performed.
• resourceType(required): string
  Allowed Values: [ "Procedure" ]
• status(required): string
  (USCDI) The following values are supported:

  • preparation
  • in-progress
  • not-done
  • on-hold
  • stopped
  • completed
  • entered-in-error
  • unknown
• subject(required): subject
  (USCDI) Who the procedure was performed on.

{
    "type":"object",
    "required":[
        "resourceType",
        "id",
        "status",
        "code",
        "subject"
    ],
    "properties":{
        "resourceType":{
            "type":"string",
            "enum":[
                "Procedure"
            ]
        },
        "id":{
            "type":"string"
        },
        "basedOn":{
            "type":"array",
            "description":"(USCDI) A request for this procedure.",
            "items":{
                "$ref":"#/components/schemas/Reference"
            }
        },
        "status":{
            "type":"string",
            "description":"(USCDI) The following values are supported:\n  <ul>\n    <li><code>preparation</code></li>\n    <li><code>in-progress</code></li>\n    <li><code>not-done</code></li>\n    <li><code>on-hold</code></li>\n    <li><code>stopped</code></li>\n    <li><code>completed</code></li>\n    <li><code>entered-in-error</code></li>\n    <li><code>unknown</code></li>\n  </ul>\n"
        },
        "code":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/CodeableConcept"
                }
            ],
            "description":"(USCDI) The identification of the procedure."
        },
        "subject":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/Reference"
                }
            ],
            "description":"(USCDI) Who the procedure was performed on."
        },
        "performedDateTime":{
            "type":"string",
            "format":"date-time",
            "description":"(USCDI) When the procedure was performed."
        }
    }
}

Nested Schema : basedOn

Type: array

(USCDI) A request for this procedure.

Show Source

• Array of: object Reference

{
    "type":"array",
    "description":"(USCDI) A request for this procedure.",
    "items":{
        "$ref":"#/components/schemas/Reference"
    }
}

Nested Schema : code

(USCDI) The identification of the procedure.

Match All

(USCDI) The identification of the procedure.

Show Source

• object CodeableConcept

{
    "allOf":[
        {
            "$ref":"#/components/schemas/CodeableConcept"
        }
    ],
    "description":"(USCDI) The identification of the procedure."
}

Nested Schema : subject

(USCDI) Who the procedure was performed on.

Match All

(USCDI) Who the procedure was performed on.

Show Source

• object Reference

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Reference"
        }
    ],
    "description":"(USCDI) Who the procedure was performed on."
}

Nested Schema : Reference

Type: object

Show Source

• reference: string
• type: string

{
    "type":"object",
    "properties":{
        "reference":{
            "type":"string"
        },
        "type":{
            "type":"string"
        }
    }
}

Nested Schema : CodeableConcept

Type: object

Show Source

• coding: array coding
• text: string

{
    "type":"object",
    "properties":{
        "coding":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/Coding"
            }
        },
        "text":{
            "type":"string"
        }
    }
}

Nested Schema : coding

Type: array

Show Source

• Array of: object Coding

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/Coding"
    }
}

Nested Schema : Coding

Type: object

Show Source

• code: string
• display: string
• system: string (uri)

{
    "type":"object",
    "properties":{
        "system":{
            "type":"string",
            "format":"uri"
        },
        "code":{
            "type":"string"
        },
        "display":{
            "type":"string"
        }
    }
}

Default Response

An OperationOutcome describing any error that occurred.

Body ()

Root Schema : OperationOutcome

Type: object

Show Source

• issue(required): array issue
• resourceType(required): string
  Allowed Values: [ "OperationOutcome" ]

{
    "type":"object",
    "required":[
        "resourceType",
        "issue"
    ],
    "properties":{
        "resourceType":{
            "type":"string",
            "enum":[
                "OperationOutcome"
            ]
        },
        "issue":{
            "type":"array",
            "items":{
                "type":"object",
                "required":[
                    "severity",
                    "code"
                ],
                "properties":{
                    "severity":{
                        "type":"string"
                    },
                    "code":{
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : issue

Type: array

Show Source

• Array of: object items

{
    "type":"array",
    "items":{
        "type":"object",
        "required":[
            "severity",
            "code"
        ],
        "properties":{
            "severity":{
                "type":"string"
            },
            "code":{
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• code(required): string
• severity(required): string

{
    "type":"object",
    "required":[
        "severity",
        "code"
    ],
    "properties":{
        "severity":{
            "type":"string"
        },
        "code":{
            "type":"string"
        }
    }
}

Back to Top