Procedure

The Procedure API enables Humana members to exchange their history of previous medical procedures with third party applications. This API conforms to the R4 FHIR standard and the US Core STU3 Implementation Guide.


URL


Headers

ACCEPT application/json
AUTHORIZATION Bearer {ACCESS_TOKEN}

Sample Request

curl -X GET \
https://sandbox-fhir.humana.com/api/Procedure \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {your access token}' \
curl -X GET \
https://fhir.humana.com/api/Procedure \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {your access token}' \

Sample Response


{
    "resourceType": "Bundle",
    "type": "searchset",
    "timestamp": "2025-01-15T16:28:58.358+00:00",
    "meta": {
        "lastUpdated": "2025-01-15T16:28:58.358+00:00",
        "versionId": "945cdc27-0ba4-487c-9e8a-c15d4fa9145f"
    },
    "entry": [
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/ab11a9a2272d5769ff59113dce6b5ecb5afbda62e14fe0c8af48327b2a8cefd0",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "ab11a9a2272d5769ff59113dce6b5ecb5afbda62e14fe0c8af48327b2a8cefd0",
                "meta": {
                    "versionId": "ea888dc0-f5c2-4dc2-9f7b-dc8bd58517b0",
                    "lastUpdated": "2024-12-27T20:13:45.828+00:00"
                },
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "92014",
                            "display": "COMPREHENSIVE VISIT"
                        },
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "V2025",
                            "display": "FRAMES"
                        },
                        {
                            "system": "https://bluebutton.cms.gov/resources/codesystem/hcpcs",
                            "code": "V2799",
                            "display": "OPHTHALMOLOGY"
                        },
                        {
                            "system": "https://bluebutton.cms.gov/resources/codesystem/hcpcs",
                            "code": "V2750",
                            "display": "LENSE"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
                },
                "performedPeriod": {
                    "start": "2024-03-11",
                    "end": "2024-03-11"
                },
                "performer": [
                    {
                        "actor": {
                            "identifier": {
                                "system": "http://hl7.org/fhir/sid/us-npi",
                                "value": "1942644661"
                            }
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/f8c587d5ee2ff2a1c26a7fad77a91700588799e747d76b7af73c7c3dec7f44ab",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "f8c587d5ee2ff2a1c26a7fad77a91700588799e747d76b7af73c7c3dec7f44ab",
                "meta": {
                    "versionId": "2ba67702-ca3a-45f2-a8d0-b3b6f65c93d5",
                    "lastUpdated": "2024-12-27T20:13:46.733+00:00"
                },
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "99213",
                            "display": "PHYSICIAN VISIT"
                        },
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "96372",
                            "display": "ADMIN"
                        },
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "1000F",
                            "display": "PHYSICIAN VISIT"
                        },
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "1036F",
                            "display": "PHYSICIAN VISIT"
                        },
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "3080F",
                            "display": "PHYSICIAN VISIT"
                        },
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "1125F",
                            "display": "PHYSICIAN VISIT"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
                },
                "performedPeriod": {
                    "start": "2024-08-15",
                    "end": "2024-08-15"
                },
                "performer": [
                    {
                        "actor": {
                            "identifier": {
                                "system": "http://hl7.org/fhir/sid/us-npi",
                                "value": "1568172575"
                            }
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/4afc307d938dfb2eaf6daed3fca3c24ff37db2e7ad1b5b782ae921c236b30f2b",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "4afc307d938dfb2eaf6daed3fca3c24ff37db2e7ad1b5b782ae921c236b30f2b",
                "meta": {
                    "versionId": "ee3b9686-93d0-45e2-b9f6-81b962e5c7ad",
                    "lastUpdated": "2024-12-27T20:13:46.959+00:00"
                },
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93015",
                            "display": "X RAY"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
                },
                "performedPeriod": {
                    "start": "2024-05-07",
                    "end": "2024-05-07"
                },
                "performer": [
                    {
                        "actor": {
                            "identifier": {
                                "system": "http://hl7.org/fhir/sid/us-npi",
                                "value": "1891882007"
                            }
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/dccfea0f762355a7781b1daff842f2ef446976d5d08c2fdffb71b73f57e4d6ab",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "dccfea0f762355a7781b1daff842f2ef446976d5d08c2fdffb71b73f57e4d6ab",
                "meta": {
                    "versionId": "7f0ce6e4-c2a9-4181-b96b-afe3547bccf3",
                    "lastUpdated": "2024-12-27T20:13:47.189+00:00"
                },
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93224",
                            "display": "X RAY"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/5a357166754b59777137634248494434654c336d68773d3d"
                },
                "performedPeriod": {
                    "start": "2024-05-08",
                    "end": "2024-05-08"
                },
                "performer": [
                    {
                        "actor": {
                            "identifier": {
                                "system": "http://hl7.org/fhir/sid/us-npi",
                                "value": "1891882007"
                            }
                        }
                    }
                ]
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/85b84c29c4c366638ec6db466bcae3517bd9b095c9b339e15153d18a0fe1b820",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "85b84c29c4c366638ec6db466bcae3517bd9b095c9b339e15153d18a0fe1b820",
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "99214"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/2cca535cc257e6108cc85b358d84ebf9c792d54fd5dbd73eb7a23cd66a2a2b27"
                },
                "performedPeriod": {
                    "start": "2024-07-22",
                    "end": "2024-07-22"
                },
                "meta": {
                    "versionId": "5f1443bb-0aea-472c-937e-50816da268f8",
                    "lastUpdated": "2025-01-06T03:21:05.487+00:00"
                }
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/caab3dcfc17b6da666f688a5603e62a684dea26f86356c17d7c39ff14815ea83",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "caab3dcfc17b6da666f688a5603e62a684dea26f86356c17d7c39ff14815ea83",
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93298"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/2cca535cc257e6108cc85b358d84ebf9c792d54fd5dbd73eb7a23cd66a2a2b27"
                },
                "performedPeriod": {
                    "start": "2024-07-12",
                    "end": "2024-07-12"
                },
                "meta": {
                    "versionId": "70719dbf-c575-45b5-92d4-b1a2bae53b68",
                    "lastUpdated": "2025-01-06T03:21:05.834+00:00"
                }
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/e6902966abeab5831ee571d4dd3a6d391174b1cd9560ff27f5c8355cfb42f38b",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "e6902966abeab5831ee571d4dd3a6d391174b1cd9560ff27f5c8355cfb42f38b",
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93298"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/2cca535cc257e6108cc85b358d84ebf9c792d54fd5dbd73eb7a23cd66a2a2b27"
                },
                "performedPeriod": {
                    "start": "2024-05-11",
                    "end": "2024-05-11"
                },
                "meta": {
                    "versionId": "bac683af-25f4-4d4e-bc2f-e98686a46bab",
                    "lastUpdated": "2025-01-06T03:21:06.160+00:00"
                }
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/5cb6f5118a67f07ed0b141e809deb2d9bd03a3bb4a77bd6a4bc97ee8427b4304",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "5cb6f5118a67f07ed0b141e809deb2d9bd03a3bb4a77bd6a4bc97ee8427b4304",
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93298"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/2cca535cc257e6108cc85b358d84ebf9c792d54fd5dbd73eb7a23cd66a2a2b27"
                },
                "performedPeriod": {
                    "start": "2023-12-08",
                    "end": "2023-12-08"
                },
                "meta": {
                    "versionId": "573c130f-19c5-4dfe-a5eb-06125cc1d6f6",
                    "lastUpdated": "2025-01-06T03:21:06.519+00:00"
                }
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/08cf506cab06f327759d74add0e8450b44210859835c51405f70de9c5f44718e",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "08cf506cab06f327759d74add0e8450b44210859835c51405f70de9c5f44718e",
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93298"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/2cca535cc257e6108cc85b358d84ebf9c792d54fd5dbd73eb7a23cd66a2a2b27"
                },
                "performedPeriod": {
                    "start": "2024-01-08",
                    "end": "2024-01-08"
                },
                "meta": {
                    "versionId": "e3143467-0169-46e5-ad42-4b0e0db3212c",
                    "lastUpdated": "2025-01-06T03:21:06.859+00:00"
                }
            }
        },
        {
            "fullUrl": "https://sandbox-fhir.humana.com/Procedure/87cdbd43c6f5cea219854211472dee14e78576027fb2bf19b5f019a85b5154d9",
            "search": {
                "mode": "match"
            },
            "resource": {
                "resourceType": "Procedure",
                "id": "87cdbd43c6f5cea219854211472dee14e78576027fb2bf19b5f019a85b5154d9",
                "status": "completed",
                "code": {
                    "coding": [
                        {
                            "system": "http://www.ama-assn.org/go/cpt",
                            "code": "93298"
                        }
                    ]
                },
                "subject": {
                    "reference": "Patient/2cca535cc257e6108cc85b358d84ebf9c792d54fd5dbd73eb7a23cd66a2a2b27"
                },
                "performedPeriod": {
                    "start": "2024-02-08",
                    "end": "2024-02-08"
                },
                "meta": {
                    "versionId": "ce8fc6c9-2d85-4da0-855a-962a38f83ead",
                    "lastUpdated": "2025-01-06T03:21:07.169+00:00"
                }
            }
        }
    ],
    "total": 1030,
    "link": [
        {
            "relation": "self",
            "url": "https://sandbox-fhir.humana.com/Procedure?_total=accurate&_count=10&_skip=0"
        },
        {
            "relation": "next",
            "url": "https://sandbox-fhir.humana.com/Procedure?_total=accurate&_count=10&_skip=10"
        },
        {
            "relation": "last",
            "url": "https://sandbox-fhir.humana.com/Procedure?_total=accurate&_count=10&_skip=1020"
        }
    ],
    "id": "48de085b-4419-4f0c-9d43-04f9b660c3e1"
}