curl --request GET \
--url https://api.openloophealth.com/v0.1/eligibility-verifications/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.openloophealth.com/v0.1/eligibility-verifications/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.openloophealth.com/v0.1/eligibility-verifications/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.openloophealth.com/v0.1/eligibility-verifications/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.openloophealth.com/v0.1/eligibility-verifications/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.openloophealth.com/v0.1/eligibility-verifications/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openloophealth.com/v0.1/eligibility-verifications/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"retry_after_ms": 500,
"result": {
"status": "complete.eligible",
"benefits": [
{
"network_status": "IN NETWORK",
"copay": 25,
"coinsurance": 0.1,
"deductible": {
"individual": {
"total": 1500,
"remaining": 400
},
"family": {
"total": 1500,
"remaining": 400
}
},
"out_of_pocket": {
"individual": {
"total": 1500,
"remaining": 400
},
"family": {
"total": 1500,
"remaining": 400
}
}
}
],
"status_reason": "error.provider.enrollment",
"patient": {
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "1957-11-10",
"member_id": "<string>",
"gender": "<string>",
"address": {
"state": "WI",
"line_1": "<string>",
"line_2": "<string>",
"city": "<string>",
"zip": "53703"
}
},
"plan": {
"active": true,
"name": "PPO Gold",
"number": "<string>",
"insurance_type_code": "<string>",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"network_id": "<string>"
},
"payer": {
"id": "61101",
"name": "Aetna"
},
"group": {
"number": "<string>",
"name": "<string>"
}
},
"reason": "<string>"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Missing `id`",
"error_code": "BAD_REQUEST"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "the token carries no organization",
"error_code": "AUTHENTICATION_ERROR"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "insufficient_permissions",
"error_code": "FORBIDDEN"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Check not found.",
"error_code": "NOT_FOUND"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Too many requests. Retry later.",
"error_code": "TOO_MANY_REQUESTS"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Internal server error",
"error_code": "UNHANDLED_EXCEPTION"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}Retrieve an eligibility verification
Returns the check’s current state, and its result once the payer has answered. This route reads what was stored and never calls a payer, so a PENDING answer means the check is still running.
Read both statuses. The top-level status says whether the check ran. result.status says what the payer said. A COMPLETE check whose result.status is error.member.name ran normally — the payer could not match the patient on the name you sent. Only complete.eligible and complete.ineligible are answers about coverage.
Wait retry_after_ms between polls. Polling sooner while the check is still pending answers 429; a check that has since been answered returns 200 with its result instead. The first poll is never refused, so no interval is reported until a pending read tells you to wait.
Scoped to the submitting organization: a check belonging to another one answers 404, the same as an id that never existed.
A check is kept for 48 hours; after that the id answers 404.
Not yet enabled on the production edge. This path appears in the reference but answers 404 against the production server, and there is no committed enablement date. Do not sequence a launch behind it — confirm status with your OLH implementation contact before designing against it.
Permissions: eligibility:read
curl --request GET \
--url https://api.openloophealth.com/v0.1/eligibility-verifications/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.openloophealth.com/v0.1/eligibility-verifications/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.openloophealth.com/v0.1/eligibility-verifications/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.openloophealth.com/v0.1/eligibility-verifications/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.openloophealth.com/v0.1/eligibility-verifications/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.openloophealth.com/v0.1/eligibility-verifications/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openloophealth.com/v0.1/eligibility-verifications/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"retry_after_ms": 500,
"result": {
"status": "complete.eligible",
"benefits": [
{
"network_status": "IN NETWORK",
"copay": 25,
"coinsurance": 0.1,
"deductible": {
"individual": {
"total": 1500,
"remaining": 400
},
"family": {
"total": 1500,
"remaining": 400
}
},
"out_of_pocket": {
"individual": {
"total": 1500,
"remaining": 400
},
"family": {
"total": 1500,
"remaining": 400
}
}
}
],
"status_reason": "error.provider.enrollment",
"patient": {
"first_name": "<string>",
"last_name": "<string>",
"date_of_birth": "1957-11-10",
"member_id": "<string>",
"gender": "<string>",
"address": {
"state": "WI",
"line_1": "<string>",
"line_2": "<string>",
"city": "<string>",
"zip": "53703"
}
},
"plan": {
"active": true,
"name": "PPO Gold",
"number": "<string>",
"insurance_type_code": "<string>",
"start_date": "2026-01-01",
"end_date": "2026-12-31",
"network_id": "<string>"
},
"payer": {
"id": "61101",
"name": "Aetna"
},
"group": {
"number": "<string>",
"name": "<string>"
}
},
"reason": "<string>"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Missing `id`",
"error_code": "BAD_REQUEST"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "the token carries no organization",
"error_code": "AUTHENTICATION_ERROR"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "insufficient_permissions",
"error_code": "FORBIDDEN"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Check not found.",
"error_code": "NOT_FOUND"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Too many requests. Retry later.",
"error_code": "TOO_MANY_REQUESTS"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Internal server error",
"error_code": "UNHANDLED_EXCEPTION"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}
