Jump to

• Request
• Response

Get a provenance by ID

get

/Provenance/{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 provenance 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 : Provenance

Type: object

Show Source

• agent(required): array agent
  (USCDI) The actor involved.
• id(required): string
• recorded(required): string (date-time)
  (USCDI) The timestamp when the activity was recorded or updated.
• resourceType(required): string
  Allowed Values: [ "Provenance" ]
• target(required): array target
  (USCDI) The resource this provenance record supports.

{
    "type":"object",
    "required":[
        "resourceType",
        "id",
        "target",
        "recorded",
        "agent"
    ],
    "properties":{
        "resourceType":{
            "type":"string",
            "enum":[
                "Provenance"
            ]
        },
        "id":{
            "type":"string"
        },
        "target":{
            "type":"array",
            "description":"(USCDI) The resource this provenance record supports.",
            "items":{
                "$ref":"#/components/schemas/Reference"
            }
        },
        "recorded":{
            "type":"string",
            "format":"date-time",
            "description":"(USCDI) The timestamp when the activity was recorded or updated."
        },
        "agent":{
            "type":"array",
            "description":"(USCDI) The actor involved.",
            "items":{
                "$ref":"#/components/schemas/ProvenanceAgent"
            }
        }
    }
}

Nested Schema : agent

Type: array

(USCDI) The actor involved.

Show Source

• Array of: object ProvenanceAgent

{
    "type":"array",
    "description":"(USCDI) The actor involved.",
    "items":{
        "$ref":"#/components/schemas/ProvenanceAgent"
    }
}

Nested Schema : target

Type: array

(USCDI) The resource this provenance record supports.

Show Source

• Array of: object Reference

{
    "type":"array",
    "description":"(USCDI) The resource this provenance record supports.",
    "items":{
        "$ref":"#/components/schemas/Reference"
    }
}

Nested Schema : ProvenanceAgent

Type: object

Show Source

• onBehalfOf: onBehalfOf
  (USCDI) Who the agent is representing.
• type: type
  (USCDI) How the agent participated.
• who(required): who
  (USCDI) Who participated.

{
    "type":"object",
    "required":[
        "who"
    ],
    "properties":{
        "type":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/CodeableConcept"
                }
            ],
            "description":"(USCDI) How the agent participated."
        },
        "who":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/Reference"
                }
            ],
            "description":"(USCDI) Who participated."
        },
        "onBehalfOf":{
            "allOf":[
                {
                    "$ref":"#/components/schemas/Reference"
                }
            ],
            "description":"(USCDI) Who the agent is representing."
        }
    }
}

Nested Schema : onBehalfOf

(USCDI) Who the agent is representing.

Match All

(USCDI) Who the agent is representing.

Show Source

• object Reference

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Reference"
        }
    ],
    "description":"(USCDI) Who the agent is representing."
}

Nested Schema : type

(USCDI) How the agent participated.

Match All

(USCDI) How the agent participated.

Show Source

• object CodeableConcept

{
    "allOf":[
        {
            "$ref":"#/components/schemas/CodeableConcept"
        }
    ],
    "description":"(USCDI) How the agent participated."
}

Nested Schema : who

(USCDI) Who participated.

Match All

(USCDI) Who participated.

Show Source

• object Reference

{
    "allOf":[
        {
            "$ref":"#/components/schemas/Reference"
        }
    ],
    "description":"(USCDI) Who participated."
}

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