Billing & Insurance
Post claim payments
Resolves the location from the X-Vendor-Request-Key header (slot); no location_id in the path.
Creates insurance claim payments from a Stedi claim status response and posts them to the PMS.
Send the claim status response exactly as returned by Stedi in stedi_response. One claim payment is created for each entry in claims that matches a claim (see Matching), using that claim’s:
claimStatus.amountPaidas the check amountclaimStatus.checkNumberandclaimStatus.checkIssueDatepayer.organizationNameas the carrier name
Matching
- Claim:
claimStatus.clearingHouseClaimNumberis matched to the claim’sclearinghouse_claim_id. Set it first withPATCH /locations/{location_id}/insurance_claims/{insurance_claim_id}. Entries with noclearingHouseClaimNumber, or one that matches no claim in the location, are skipped: no claim payment is created and they are not included in the response. - Procedures: each
serviceDetails[].service.procedureIdmust be the PMS procedure ID (Open DentalProcNum) of a procedure on that claim that is not yet attached to a payment. ItsamountPaidis posted as the insurance payment for that procedure.
PMS writeback
Each claim payment is written to the PMS in the background. For Open Dental:
- Each matched procedure is marked Received with its paid amount.
- The claim is marked Received.
- The check is created and attached to the claim. Offices with Open Dental’s
ClaimPaymentBatchOnlypreference use the batch claim payment endpoint.
The check amount must equal the total paid across the claim’s received procedures. Write-offs and deductibles are not posted: a claim status response does not include them.
Writeback runs only for Open Dental practices. If a procedure cannot be matched to an unpaid procedure on the claim, the writeback stops at that procedure and records an error; procedures before it may already be marked Received.
Requires an API key with RCM enabled. Keys without it receive 401 with {"errors": "RCM is not enabled for this API key"}; contact TeamCare support to enable it.
POST
/
claim_payments
Post claim payments
curl --request POST \
--url https://api.teamcaredental.com/api/v2/vendors/claim_payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Vendor-Request-Key: <api-key>' \
--data '
{
"claim_payment": {
"stedi_response": {
"claims": [
{
"claimStatus": {
"amountPaid": "68.00",
"checkIssueDate": "2025-07-17",
"checkNumber": "123456789",
"clearingHouseClaimNumber": "CH-0098431",
"patientAccountNumber": "17/3",
"statusCategoryCode": "F1",
"statusCategoryCodeValue": "Finalized/Payment - The claim/line has been paid.",
"statusCode": "65",
"submittedAmount": "68.00"
},
"serviceDetails": [
{
"service": {
"procedureId": "21",
"amountPaid": "60.00",
"submittedAmount": "60.00",
"submittedUnits": "1"
}
},
{
"service": {
"procedureId": "23",
"amountPaid": "8.00",
"submittedAmount": "8.00",
"submittedUnits": "1"
}
}
]
}
],
"controlNumber": "123456789",
"payer": {
"organizationName": "UNITEDHEALTHCARE",
"payerIdentification": "87726"
}
}
}
}
'import requests
url = "https://api.teamcaredental.com/api/v2/vendors/claim_payments"
payload = { "claim_payment": { "stedi_response": {
"claims": [
{
"claimStatus": {
"amountPaid": "68.00",
"checkIssueDate": "2025-07-17",
"checkNumber": "123456789",
"clearingHouseClaimNumber": "CH-0098431",
"patientAccountNumber": "17/3",
"statusCategoryCode": "F1",
"statusCategoryCodeValue": "Finalized/Payment - The claim/line has been paid.",
"statusCode": "65",
"submittedAmount": "68.00"
},
"serviceDetails": [{ "service": {
"procedureId": "21",
"amountPaid": "60.00",
"submittedAmount": "60.00",
"submittedUnits": "1"
} }, { "service": {
"procedureId": "23",
"amountPaid": "8.00",
"submittedAmount": "8.00",
"submittedUnits": "1"
} }]
}
],
"controlNumber": "123456789",
"payer": {
"organizationName": "UNITEDHEALTHCARE",
"payerIdentification": "87726"
}
} } }
headers = {
"Authorization": "Bearer <token>",
"X-Vendor-Request-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'X-Vendor-Request-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
claim_payment: {
stedi_response: {
claims: [
{
claimStatus: {
amountPaid: '68.00',
checkIssueDate: '2025-07-17',
checkNumber: '123456789',
clearingHouseClaimNumber: 'CH-0098431',
patientAccountNumber: '17/3',
statusCategoryCode: 'F1',
statusCategoryCodeValue: 'Finalized/Payment - The claim/line has been paid.',
statusCode: '65',
submittedAmount: '68.00'
},
serviceDetails: [
{
service: {
procedureId: '21',
amountPaid: '60.00',
submittedAmount: '60.00',
submittedUnits: '1'
}
},
{
service: {
procedureId: '23',
amountPaid: '8.00',
submittedAmount: '8.00',
submittedUnits: '1'
}
}
]
}
],
controlNumber: '123456789',
payer: {organizationName: 'UNITEDHEALTHCARE', payerIdentification: '87726'}
}
}
})
};
fetch('https://api.teamcaredental.com/api/v2/vendors/claim_payments', 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.teamcaredental.com/api/v2/vendors/claim_payments",
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([
'claim_payment' => [
'stedi_response' => [
'claims' => [
[
'claimStatus' => [
'amountPaid' => '68.00',
'checkIssueDate' => '2025-07-17',
'checkNumber' => '123456789',
'clearingHouseClaimNumber' => 'CH-0098431',
'patientAccountNumber' => '17/3',
'statusCategoryCode' => 'F1',
'statusCategoryCodeValue' => 'Finalized/Payment - The claim/line has been paid.',
'statusCode' => '65',
'submittedAmount' => '68.00'
],
'serviceDetails' => [
[
'service' => [
'procedureId' => '21',
'amountPaid' => '60.00',
'submittedAmount' => '60.00',
'submittedUnits' => '1'
]
],
[
'service' => [
'procedureId' => '23',
'amountPaid' => '8.00',
'submittedAmount' => '8.00',
'submittedUnits' => '1'
]
]
]
]
],
'controlNumber' => '123456789',
'payer' => [
'organizationName' => 'UNITEDHEALTHCARE',
'payerIdentification' => '87726'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"X-Vendor-Request-Key: <api-key>"
],
]);
$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.teamcaredental.com/api/v2/vendors/claim_payments"
payload := strings.NewReader("{\n \"claim_payment\": {\n \"stedi_response\": {\n \"claims\": [\n {\n \"claimStatus\": {\n \"amountPaid\": \"68.00\",\n \"checkIssueDate\": \"2025-07-17\",\n \"checkNumber\": \"123456789\",\n \"clearingHouseClaimNumber\": \"CH-0098431\",\n \"patientAccountNumber\": \"17/3\",\n \"statusCategoryCode\": \"F1\",\n \"statusCategoryCodeValue\": \"Finalized/Payment - The claim/line has been paid.\",\n \"statusCode\": \"65\",\n \"submittedAmount\": \"68.00\"\n },\n \"serviceDetails\": [\n {\n \"service\": {\n \"procedureId\": \"21\",\n \"amountPaid\": \"60.00\",\n \"submittedAmount\": \"60.00\",\n \"submittedUnits\": \"1\"\n }\n },\n {\n \"service\": {\n \"procedureId\": \"23\",\n \"amountPaid\": \"8.00\",\n \"submittedAmount\": \"8.00\",\n \"submittedUnits\": \"1\"\n }\n }\n ]\n }\n ],\n \"controlNumber\": \"123456789\",\n \"payer\": {\n \"organizationName\": \"UNITEDHEALTHCARE\",\n \"payerIdentification\": \"87726\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("X-Vendor-Request-Key", "<api-key>")
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.teamcaredental.com/api/v2/vendors/claim_payments")
.header("Authorization", "Bearer <token>")
.header("X-Vendor-Request-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"claim_payment\": {\n \"stedi_response\": {\n \"claims\": [\n {\n \"claimStatus\": {\n \"amountPaid\": \"68.00\",\n \"checkIssueDate\": \"2025-07-17\",\n \"checkNumber\": \"123456789\",\n \"clearingHouseClaimNumber\": \"CH-0098431\",\n \"patientAccountNumber\": \"17/3\",\n \"statusCategoryCode\": \"F1\",\n \"statusCategoryCodeValue\": \"Finalized/Payment - The claim/line has been paid.\",\n \"statusCode\": \"65\",\n \"submittedAmount\": \"68.00\"\n },\n \"serviceDetails\": [\n {\n \"service\": {\n \"procedureId\": \"21\",\n \"amountPaid\": \"60.00\",\n \"submittedAmount\": \"60.00\",\n \"submittedUnits\": \"1\"\n }\n },\n {\n \"service\": {\n \"procedureId\": \"23\",\n \"amountPaid\": \"8.00\",\n \"submittedAmount\": \"8.00\",\n \"submittedUnits\": \"1\"\n }\n }\n ]\n }\n ],\n \"controlNumber\": \"123456789\",\n \"payer\": {\n \"organizationName\": \"UNITEDHEALTHCARE\",\n \"payerIdentification\": \"87726\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.teamcaredental.com/api/v2/vendors/claim_payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Vendor-Request-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"claim_payment\": {\n \"stedi_response\": {\n \"claims\": [\n {\n \"claimStatus\": {\n \"amountPaid\": \"68.00\",\n \"checkIssueDate\": \"2025-07-17\",\n \"checkNumber\": \"123456789\",\n \"clearingHouseClaimNumber\": \"CH-0098431\",\n \"patientAccountNumber\": \"17/3\",\n \"statusCategoryCode\": \"F1\",\n \"statusCategoryCodeValue\": \"Finalized/Payment - The claim/line has been paid.\",\n \"statusCode\": \"65\",\n \"submittedAmount\": \"68.00\"\n },\n \"serviceDetails\": [\n {\n \"service\": {\n \"procedureId\": \"21\",\n \"amountPaid\": \"60.00\",\n \"submittedAmount\": \"60.00\",\n \"submittedUnits\": \"1\"\n }\n },\n {\n \"service\": {\n \"procedureId\": \"23\",\n \"amountPaid\": \"8.00\",\n \"submittedAmount\": \"8.00\",\n \"submittedUnits\": \"1\"\n }\n }\n ]\n }\n ],\n \"controlNumber\": \"123456789\",\n \"payer\": {\n \"organizationName\": \"UNITEDHEALTHCARE\",\n \"payerIdentification\": \"87726\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "301",
"type": "claim_payment",
"attributes": {
"deleted": false,
"check_date": null,
"date_issued": "2025-07-17",
"check_amount": "68.0",
"check_number": "123456789",
"carrier_name": "UNITEDHEALTHCARE",
"note": "Posted through Stedi 123456789",
"updated_at": "2026-10-09T09:15:02.000Z"
}
}
]
}Authorizations
JWT returned by POST /auth/token. Valid for six hours.
Request key returned by POST /locations/{location_id}/slots. Identifies the practice for a data request; valid for 6 hours (the access token's lifetime) and subject to the firm's concurrent-slot quota.
Body
application/json
Show child attributes
Show child attributes
Response
The created claim payments, one per matched claim in the Stedi response. Empty when no claim matches.
Show child attributes
Show child attributes
⌘I
Post claim payments
curl --request POST \
--url https://api.teamcaredental.com/api/v2/vendors/claim_payments \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Vendor-Request-Key: <api-key>' \
--data '
{
"claim_payment": {
"stedi_response": {
"claims": [
{
"claimStatus": {
"amountPaid": "68.00",
"checkIssueDate": "2025-07-17",
"checkNumber": "123456789",
"clearingHouseClaimNumber": "CH-0098431",
"patientAccountNumber": "17/3",
"statusCategoryCode": "F1",
"statusCategoryCodeValue": "Finalized/Payment - The claim/line has been paid.",
"statusCode": "65",
"submittedAmount": "68.00"
},
"serviceDetails": [
{
"service": {
"procedureId": "21",
"amountPaid": "60.00",
"submittedAmount": "60.00",
"submittedUnits": "1"
}
},
{
"service": {
"procedureId": "23",
"amountPaid": "8.00",
"submittedAmount": "8.00",
"submittedUnits": "1"
}
}
]
}
],
"controlNumber": "123456789",
"payer": {
"organizationName": "UNITEDHEALTHCARE",
"payerIdentification": "87726"
}
}
}
}
'import requests
url = "https://api.teamcaredental.com/api/v2/vendors/claim_payments"
payload = { "claim_payment": { "stedi_response": {
"claims": [
{
"claimStatus": {
"amountPaid": "68.00",
"checkIssueDate": "2025-07-17",
"checkNumber": "123456789",
"clearingHouseClaimNumber": "CH-0098431",
"patientAccountNumber": "17/3",
"statusCategoryCode": "F1",
"statusCategoryCodeValue": "Finalized/Payment - The claim/line has been paid.",
"statusCode": "65",
"submittedAmount": "68.00"
},
"serviceDetails": [{ "service": {
"procedureId": "21",
"amountPaid": "60.00",
"submittedAmount": "60.00",
"submittedUnits": "1"
} }, { "service": {
"procedureId": "23",
"amountPaid": "8.00",
"submittedAmount": "8.00",
"submittedUnits": "1"
} }]
}
],
"controlNumber": "123456789",
"payer": {
"organizationName": "UNITEDHEALTHCARE",
"payerIdentification": "87726"
}
} } }
headers = {
"Authorization": "Bearer <token>",
"X-Vendor-Request-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: 'Bearer <token>',
'X-Vendor-Request-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
claim_payment: {
stedi_response: {
claims: [
{
claimStatus: {
amountPaid: '68.00',
checkIssueDate: '2025-07-17',
checkNumber: '123456789',
clearingHouseClaimNumber: 'CH-0098431',
patientAccountNumber: '17/3',
statusCategoryCode: 'F1',
statusCategoryCodeValue: 'Finalized/Payment - The claim/line has been paid.',
statusCode: '65',
submittedAmount: '68.00'
},
serviceDetails: [
{
service: {
procedureId: '21',
amountPaid: '60.00',
submittedAmount: '60.00',
submittedUnits: '1'
}
},
{
service: {
procedureId: '23',
amountPaid: '8.00',
submittedAmount: '8.00',
submittedUnits: '1'
}
}
]
}
],
controlNumber: '123456789',
payer: {organizationName: 'UNITEDHEALTHCARE', payerIdentification: '87726'}
}
}
})
};
fetch('https://api.teamcaredental.com/api/v2/vendors/claim_payments', 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.teamcaredental.com/api/v2/vendors/claim_payments",
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([
'claim_payment' => [
'stedi_response' => [
'claims' => [
[
'claimStatus' => [
'amountPaid' => '68.00',
'checkIssueDate' => '2025-07-17',
'checkNumber' => '123456789',
'clearingHouseClaimNumber' => 'CH-0098431',
'patientAccountNumber' => '17/3',
'statusCategoryCode' => 'F1',
'statusCategoryCodeValue' => 'Finalized/Payment - The claim/line has been paid.',
'statusCode' => '65',
'submittedAmount' => '68.00'
],
'serviceDetails' => [
[
'service' => [
'procedureId' => '21',
'amountPaid' => '60.00',
'submittedAmount' => '60.00',
'submittedUnits' => '1'
]
],
[
'service' => [
'procedureId' => '23',
'amountPaid' => '8.00',
'submittedAmount' => '8.00',
'submittedUnits' => '1'
]
]
]
]
],
'controlNumber' => '123456789',
'payer' => [
'organizationName' => 'UNITEDHEALTHCARE',
'payerIdentification' => '87726'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"X-Vendor-Request-Key: <api-key>"
],
]);
$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.teamcaredental.com/api/v2/vendors/claim_payments"
payload := strings.NewReader("{\n \"claim_payment\": {\n \"stedi_response\": {\n \"claims\": [\n {\n \"claimStatus\": {\n \"amountPaid\": \"68.00\",\n \"checkIssueDate\": \"2025-07-17\",\n \"checkNumber\": \"123456789\",\n \"clearingHouseClaimNumber\": \"CH-0098431\",\n \"patientAccountNumber\": \"17/3\",\n \"statusCategoryCode\": \"F1\",\n \"statusCategoryCodeValue\": \"Finalized/Payment - The claim/line has been paid.\",\n \"statusCode\": \"65\",\n \"submittedAmount\": \"68.00\"\n },\n \"serviceDetails\": [\n {\n \"service\": {\n \"procedureId\": \"21\",\n \"amountPaid\": \"60.00\",\n \"submittedAmount\": \"60.00\",\n \"submittedUnits\": \"1\"\n }\n },\n {\n \"service\": {\n \"procedureId\": \"23\",\n \"amountPaid\": \"8.00\",\n \"submittedAmount\": \"8.00\",\n \"submittedUnits\": \"1\"\n }\n }\n ]\n }\n ],\n \"controlNumber\": \"123456789\",\n \"payer\": {\n \"organizationName\": \"UNITEDHEALTHCARE\",\n \"payerIdentification\": \"87726\"\n }\n }\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("X-Vendor-Request-Key", "<api-key>")
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.teamcaredental.com/api/v2/vendors/claim_payments")
.header("Authorization", "Bearer <token>")
.header("X-Vendor-Request-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"claim_payment\": {\n \"stedi_response\": {\n \"claims\": [\n {\n \"claimStatus\": {\n \"amountPaid\": \"68.00\",\n \"checkIssueDate\": \"2025-07-17\",\n \"checkNumber\": \"123456789\",\n \"clearingHouseClaimNumber\": \"CH-0098431\",\n \"patientAccountNumber\": \"17/3\",\n \"statusCategoryCode\": \"F1\",\n \"statusCategoryCodeValue\": \"Finalized/Payment - The claim/line has been paid.\",\n \"statusCode\": \"65\",\n \"submittedAmount\": \"68.00\"\n },\n \"serviceDetails\": [\n {\n \"service\": {\n \"procedureId\": \"21\",\n \"amountPaid\": \"60.00\",\n \"submittedAmount\": \"60.00\",\n \"submittedUnits\": \"1\"\n }\n },\n {\n \"service\": {\n \"procedureId\": \"23\",\n \"amountPaid\": \"8.00\",\n \"submittedAmount\": \"8.00\",\n \"submittedUnits\": \"1\"\n }\n }\n ]\n }\n ],\n \"controlNumber\": \"123456789\",\n \"payer\": {\n \"organizationName\": \"UNITEDHEALTHCARE\",\n \"payerIdentification\": \"87726\"\n }\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.teamcaredental.com/api/v2/vendors/claim_payments")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["X-Vendor-Request-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"claim_payment\": {\n \"stedi_response\": {\n \"claims\": [\n {\n \"claimStatus\": {\n \"amountPaid\": \"68.00\",\n \"checkIssueDate\": \"2025-07-17\",\n \"checkNumber\": \"123456789\",\n \"clearingHouseClaimNumber\": \"CH-0098431\",\n \"patientAccountNumber\": \"17/3\",\n \"statusCategoryCode\": \"F1\",\n \"statusCategoryCodeValue\": \"Finalized/Payment - The claim/line has been paid.\",\n \"statusCode\": \"65\",\n \"submittedAmount\": \"68.00\"\n },\n \"serviceDetails\": [\n {\n \"service\": {\n \"procedureId\": \"21\",\n \"amountPaid\": \"60.00\",\n \"submittedAmount\": \"60.00\",\n \"submittedUnits\": \"1\"\n }\n },\n {\n \"service\": {\n \"procedureId\": \"23\",\n \"amountPaid\": \"8.00\",\n \"submittedAmount\": \"8.00\",\n \"submittedUnits\": \"1\"\n }\n }\n ]\n }\n ],\n \"controlNumber\": \"123456789\",\n \"payer\": {\n \"organizationName\": \"UNITEDHEALTHCARE\",\n \"payerIdentification\": \"87726\"\n }\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "301",
"type": "claim_payment",
"attributes": {
"deleted": false,
"check_date": null,
"date_issued": "2025-07-17",
"check_amount": "68.0",
"check_number": "123456789",
"carrier_name": "UNITEDHEALTHCARE",
"note": "Posted through Stedi 123456789",
"updated_at": "2026-10-09T09:15:02.000Z"
}
}
]
}