Skip to main content

US Insurance Card Extraction

Extracts card owner, ID number, sex, hospital effective date and medical effective date from a US insurance card.

POSThttps://sandbox/pcs/UsInsuranceCard

Content-Type: application/json

Headers​

HeaderTypeRequiredDescription
keystringYesAPI key issued for authentication.

Request body​

FieldTypeRequiredDescription
recordIdstringYesUnique ID you assign to correlate the request with the response.
imagestringYesBase64 string / data URI of the insurance card image.

Example​

POST/pcs/UsInsuranceCard
curl --location 'https://sandbox/pcs/UsInsuranceCard' \
--header 'key: <your-api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "recordId": "1",
  "image": "data:image/png;base64,<BASE64_STRING>"
}'
200
{
"status": "TEXT NOT CLEAR",
"recordId": "1",
"data": {
  "Card_owner": "NAME-STRING",
  "ID_number": "W2N12345678M",
  "Sex": "MALE",
  "Hospital_effective_date": "01-01-2018",
  "Medical_effective_date": "01-01-2018"
},
"utc_time_stamp": "07/11/2024, 07:35:09"
}

Response​

FieldTypeDescription
statusstringSUCCESS, or a warning such as TEXT NOT CLEAR when parts of the card were hard to read.
recordIdstringEchoes the recordId sent in the request.
data.Card_ownerstringName of the insured card owner.
data.ID_numberstringMember / policy ID number.
data.SexstringCard owner's sex.
data.Hospital_effective_datestringHospital coverage effective date.
data.Medical_effective_datestringMedical coverage effective date.
utc_time_stampstringUTC timestamp of the response, DD/MM/YYYY, HH:mm:ss.

Error handling​

200 on success, 422 on a validation error — see Error handling for the common error shape.