curl --request POST \
--url https://api.openloophealth.com/v0.1/insurance-discoveries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"subscriber": {
"first_name": "Erica",
"last_name": "McDaniel",
"date_of_birth": "1991-04-27",
"address": {
"state": "WI",
"line_1": "<string>",
"line_2": "<string>",
"city": "<string>",
"zip": "53703"
},
"gender": "<string>",
"ssn": "<string>"
},
"date_of_service": "2026-06-23"
}
'import requests
url = "https://api.openloophealth.com/v0.1/insurance-discoveries"
payload = {
"subscriber": {
"first_name": "Erica",
"last_name": "McDaniel",
"date_of_birth": "1991-04-27",
"address": {
"state": "WI",
"line_1": "<string>",
"line_2": "<string>",
"city": "<string>",
"zip": "53703"
},
"gender": "<string>",
"ssn": "<string>"
},
"date_of_service": "2026-06-23"
}
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: 'Erica',
last_name: 'McDaniel',
date_of_birth: '1991-04-27',
address: {
state: 'WI',
line_1: '<string>',
line_2: '<string>',
city: '<string>',
zip: '53703'
},
gender: '<string>',
ssn: '<string>'
},
date_of_service: '2026-06-23'
})
};
fetch('https://api.openloophealth.com/v0.1/insurance-discoveries', 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/insurance-discoveries",
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' => 'Erica',
'last_name' => 'McDaniel',
'date_of_birth' => '1991-04-27',
'address' => [
'state' => 'WI',
'line_1' => '<string>',
'line_2' => '<string>',
'city' => '<string>',
'zip' => '53703'
],
'gender' => '<string>',
'ssn' => '<string>'
],
'date_of_service' => '2026-06-23'
]),
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/insurance-discoveries"
payload := strings.NewReader("{\n \"subscriber\": {\n \"first_name\": \"Erica\",\n \"last_name\": \"McDaniel\",\n \"date_of_birth\": \"1991-04-27\",\n \"address\": {\n \"state\": \"WI\",\n \"line_1\": \"<string>\",\n \"line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"zip\": \"53703\"\n },\n \"gender\": \"<string>\",\n \"ssn\": \"<string>\"\n },\n \"date_of_service\": \"2026-06-23\"\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/insurance-discoveries")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"subscriber\": {\n \"first_name\": \"Erica\",\n \"last_name\": \"McDaniel\",\n \"date_of_birth\": \"1991-04-27\",\n \"address\": {\n \"state\": \"WI\",\n \"line_1\": \"<string>\",\n \"line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"zip\": \"53703\"\n },\n \"gender\": \"<string>\",\n \"ssn\": \"<string>\"\n },\n \"date_of_service\": \"2026-06-23\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openloophealth.com/v0.1/insurance-discoveries")
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\": \"Erica\",\n \"last_name\": \"McDaniel\",\n \"date_of_birth\": \"1991-04-27\",\n \"address\": {\n \"state\": \"WI\",\n \"line_1\": \"<string>\",\n \"line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"zip\": \"53703\"\n },\n \"gender\": \"<string>\",\n \"ssn\": \"<string>\"\n },\n \"date_of_service\": \"2026-06-23\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"error_code": "BAD_REQUEST"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "<string>",
"error_code": "<string>"
},
"request_id": "<string>"
}{
"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 insurance discovery
Finds coverage a patient may have when you do not know their payer or member id, from demographics alone. Queued rather than answered inline: this call answers 202 with an id and status: PENDING, and the result arrives on GET /insurance-discoveries/{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.
subscriber.address.state is required, and is the state of care rather than a mailing address: it narrows the search and selects the OpenLoop entity the inquiry is submitted under. The rest of the address is optional and improves matching, as does subscriber.ssn, which is never echoed back.
Repeat submissions are absorbed for five minutes. An identical submission inside that window answers 200 instead of 202, carrying the original id and deduplicated: true, and queues nothing new. The window matches the whole question, so a corrected submission is a new search.
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/insurance-discoveries \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"subscriber": {
"first_name": "Erica",
"last_name": "McDaniel",
"date_of_birth": "1991-04-27",
"address": {
"state": "WI",
"line_1": "<string>",
"line_2": "<string>",
"city": "<string>",
"zip": "53703"
},
"gender": "<string>",
"ssn": "<string>"
},
"date_of_service": "2026-06-23"
}
'import requests
url = "https://api.openloophealth.com/v0.1/insurance-discoveries"
payload = {
"subscriber": {
"first_name": "Erica",
"last_name": "McDaniel",
"date_of_birth": "1991-04-27",
"address": {
"state": "WI",
"line_1": "<string>",
"line_2": "<string>",
"city": "<string>",
"zip": "53703"
},
"gender": "<string>",
"ssn": "<string>"
},
"date_of_service": "2026-06-23"
}
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: 'Erica',
last_name: 'McDaniel',
date_of_birth: '1991-04-27',
address: {
state: 'WI',
line_1: '<string>',
line_2: '<string>',
city: '<string>',
zip: '53703'
},
gender: '<string>',
ssn: '<string>'
},
date_of_service: '2026-06-23'
})
};
fetch('https://api.openloophealth.com/v0.1/insurance-discoveries', 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/insurance-discoveries",
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' => 'Erica',
'last_name' => 'McDaniel',
'date_of_birth' => '1991-04-27',
'address' => [
'state' => 'WI',
'line_1' => '<string>',
'line_2' => '<string>',
'city' => '<string>',
'zip' => '53703'
],
'gender' => '<string>',
'ssn' => '<string>'
],
'date_of_service' => '2026-06-23'
]),
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/insurance-discoveries"
payload := strings.NewReader("{\n \"subscriber\": {\n \"first_name\": \"Erica\",\n \"last_name\": \"McDaniel\",\n \"date_of_birth\": \"1991-04-27\",\n \"address\": {\n \"state\": \"WI\",\n \"line_1\": \"<string>\",\n \"line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"zip\": \"53703\"\n },\n \"gender\": \"<string>\",\n \"ssn\": \"<string>\"\n },\n \"date_of_service\": \"2026-06-23\"\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/insurance-discoveries")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"subscriber\": {\n \"first_name\": \"Erica\",\n \"last_name\": \"McDaniel\",\n \"date_of_birth\": \"1991-04-27\",\n \"address\": {\n \"state\": \"WI\",\n \"line_1\": \"<string>\",\n \"line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"zip\": \"53703\"\n },\n \"gender\": \"<string>\",\n \"ssn\": \"<string>\"\n },\n \"date_of_service\": \"2026-06-23\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.openloophealth.com/v0.1/insurance-discoveries")
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\": \"Erica\",\n \"last_name\": \"McDaniel\",\n \"date_of_birth\": \"1991-04-27\",\n \"address\": {\n \"state\": \"WI\",\n \"line_1\": \"<string>\",\n \"line_2\": \"<string>\",\n \"city\": \"<string>\",\n \"zip\": \"53703\"\n },\n \"gender\": \"<string>\",\n \"ssn\": \"<string>\"\n },\n \"date_of_service\": \"2026-06-23\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"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",
"error_code": "BAD_REQUEST"
},
"request_id": "c1a7f3e2-5b9d-4a68-9f21-7d3c4b6e8a05"
}{
"error": {
"message": "<string>",
"error_code": "<string>"
},
"request_id": "<string>"
}{
"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"
}
