curl --request POST \
--url https://api.openloophealth.com/v0.1/eligibility-verifications \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"subscriber": {
"first_name": "Phillip",
"last_name": "Mozee",
"date_of_birth": "1957-11-10",
"member_id": "H77465998",
"address": {
"state": "WI"
}
},
"payer_id": "61101",
"date_of_service": "2026-08-28",
"specialty_code": "PSY",
"place_of_service_code": "02"
}
'import requests
url = "https://api.openloophealth.com/v0.1/eligibility-verifications"
payload = {
"subscriber": {
"first_name": "Phillip",
"last_name": "Mozee",
"date_of_birth": "1957-11-10",
"member_id": "H77465998",
"address": { "state": "WI" }
},
"payer_id": "61101",
"date_of_service": "2026-08-28",
"specialty_code": "PSY",
"place_of_service_code": "02"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
subscriber: {
first_name: 'Phillip',
last_name: 'Mozee',
date_of_birth: '1957-11-10',
member_id: 'H77465998',
address: {state: 'WI'}
},
payer_id: '61101',
date_of_service: '2026-08-28',
specialty_code: 'PSY',
place_of_service_code: '02'
})
};
fetch('https://api.openloophealth.com/v0.1/eligibility-verifications', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'subscriber' => [
'first_name' => 'Phillip',
'last_name' => 'Mozee',
'date_of_birth' => '1957-11-10',
'member_id' => 'H77465998',
'address' => [
'state' => 'WI'
]
],
'payer_id' => '61101',
'date_of_service' => '2026-08-28',
'specialty_code' => 'PSY',
'place_of_service_code' => '02'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.openloophealth.com/v0.1/eligibility-verifications"
payload := strings.NewReader("{\n \"subscriber\": {\n \"first_name\": \"Phillip\",\n \"last_name\": \"Mozee\",\n \"date_of_birth\": \"1957-11-10\",\n \"member_id\": \"H77465998\",\n \"address\": {\n \"state\": \"WI\"\n }\n },\n \"payer_id\": \"61101\",\n \"date_of_service\": \"2026-08-28\",\n \"specialty_code\": \"PSY\",\n \"place_of_service_code\": \"02\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.openloophealth.com/v0.1/eligibility-verifications")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"subscriber\": {\n \"first_name\": \"Phillip\",\n \"last_name\": \"Mozee\",\n \"date_of_birth\": \"1957-11-10\",\n \"member_id\": \"H77465998\",\n \"address\": {\n \"state\": \"WI\"\n }\n },\n \"payer_id\": \"61101\",\n \"date_of_service\": \"2026-08-28\",\n \"specialty_code\": \"PSY\",\n \"place_of_service_code\": \"02\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openloophealth.com/v0.1/eligibility-verifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"subscriber\": {\n \"first_name\": \"Phillip\",\n \"last_name\": \"Mozee\",\n \"date_of_birth\": \"1957-11-10\",\n \"member_id\": \"H77465998\",\n \"address\": {\n \"state\": \"WI\"\n }\n },\n \"payer_id\": \"61101\",\n \"date_of_service\": \"2026-08-28\",\n \"specialty_code\": \"PSY\",\n \"place_of_service_code\": \"02\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"deduplicated": true
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Invalid request: subscriber.member_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": "Internal server error",
"error_code": "UNHANDLED_EXCEPTION"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}Submit an eligibility verification
Asks a payer whether a patient’s coverage is active and what it covers. The check runs out of band: this call answers 202 with an id, and the answer arrives on GET /eligibility-verifications/{id}.
The organization comes from your access token’s organization claim; there is no body field or query parameter for it. A token carrying no claim is a 401.
No provider identifier is accepted: subscriber.address.state selects the OpenLoop entity the inquiry is submitted under.
payer_id must use the payer-id vocabulary your account uses. Ask your OpenLoop contact which one that is.
Repeat submissions are absorbed for five minutes. An identical check from your organization inside that window answers 200 with the original id and deduplicated: true rather than asking the payer again. The window matches the whole question — subscriber, payer, state, date of service, specialty and place of service — and only against a check that is still PENDING or already COMPLETE; a FAILED or TIMEOUT check never blocks a resubmission. Two identical submissions sent at once are serialized: one is answered 200 with the other’s id, or 409 if that one is not recorded yet.
A check here writes to no OpenLoop clinical record and starts no scheduling. If you need the result in a patient’s chart, that is a separate integration.
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:write
curl --request POST \
--url https://api.openloophealth.com/v0.1/eligibility-verifications \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"subscriber": {
"first_name": "Phillip",
"last_name": "Mozee",
"date_of_birth": "1957-11-10",
"member_id": "H77465998",
"address": {
"state": "WI"
}
},
"payer_id": "61101",
"date_of_service": "2026-08-28",
"specialty_code": "PSY",
"place_of_service_code": "02"
}
'import requests
url = "https://api.openloophealth.com/v0.1/eligibility-verifications"
payload = {
"subscriber": {
"first_name": "Phillip",
"last_name": "Mozee",
"date_of_birth": "1957-11-10",
"member_id": "H77465998",
"address": { "state": "WI" }
},
"payer_id": "61101",
"date_of_service": "2026-08-28",
"specialty_code": "PSY",
"place_of_service_code": "02"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
subscriber: {
first_name: 'Phillip',
last_name: 'Mozee',
date_of_birth: '1957-11-10',
member_id: 'H77465998',
address: {state: 'WI'}
},
payer_id: '61101',
date_of_service: '2026-08-28',
specialty_code: 'PSY',
place_of_service_code: '02'
})
};
fetch('https://api.openloophealth.com/v0.1/eligibility-verifications', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'subscriber' => [
'first_name' => 'Phillip',
'last_name' => 'Mozee',
'date_of_birth' => '1957-11-10',
'member_id' => 'H77465998',
'address' => [
'state' => 'WI'
]
],
'payer_id' => '61101',
'date_of_service' => '2026-08-28',
'specialty_code' => 'PSY',
'place_of_service_code' => '02'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.openloophealth.com/v0.1/eligibility-verifications"
payload := strings.NewReader("{\n \"subscriber\": {\n \"first_name\": \"Phillip\",\n \"last_name\": \"Mozee\",\n \"date_of_birth\": \"1957-11-10\",\n \"member_id\": \"H77465998\",\n \"address\": {\n \"state\": \"WI\"\n }\n },\n \"payer_id\": \"61101\",\n \"date_of_service\": \"2026-08-28\",\n \"specialty_code\": \"PSY\",\n \"place_of_service_code\": \"02\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.openloophealth.com/v0.1/eligibility-verifications")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"subscriber\": {\n \"first_name\": \"Phillip\",\n \"last_name\": \"Mozee\",\n \"date_of_birth\": \"1957-11-10\",\n \"member_id\": \"H77465998\",\n \"address\": {\n \"state\": \"WI\"\n }\n },\n \"payer_id\": \"61101\",\n \"date_of_service\": \"2026-08-28\",\n \"specialty_code\": \"PSY\",\n \"place_of_service_code\": \"02\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openloophealth.com/v0.1/eligibility-verifications")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"subscriber\": {\n \"first_name\": \"Phillip\",\n \"last_name\": \"Mozee\",\n \"date_of_birth\": \"1957-11-10\",\n \"member_id\": \"H77465998\",\n \"address\": {\n \"state\": \"WI\"\n }\n },\n \"payer_id\": \"61101\",\n \"date_of_service\": \"2026-08-28\",\n \"specialty_code\": \"PSY\",\n \"place_of_service_code\": \"02\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING",
"deduplicated": true
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "PENDING"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "Invalid request: subscriber.member_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": "Internal server error",
"error_code": "UNHANDLED_EXCEPTION"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}
