GuarantorV1

Create guarantor

Beta
POST
https://api.joincandidhealth.com/api/guarantors/v1/:encounter_id
Creates a new guarantor and returns the newly created Guarantor object.

Path parameters

encounter_id
UUID

Request

This endpoint expects an object.
external_id
string
first_name
string
last_name
string
address
optional object
date_of_birth
optional date
email
optional string
email_consent
optional boolean
Defaults to false
phone_consent
optional boolean
Defaults to false
phone_numbers
optional list of objects

Response

This endpoint return an object.
email_consent
boolean
external_id
string
first_name
string
guarantor_id
UUID
last_name
string
phone_consent
boolean
phone_numbers
list of objects
address
optional object
date_of_birth
optional date
email
optional string

Errors

POST
/api/guarantors/v1/:encounter_id
curl -X POST https://api.joincandidhealth.com/api/guarantors/v1/d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32 \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"external_id": "string",
"first_name": "string",
"last_name": "string"
}'
Response
{
"email_consent": true,
"external_id": "string",
"first_name": "string",
"guarantor_id": "d5e9c84f-c2b2-4bf4-b4b0-7ffd7a9ffc32",
"last_name": "string",
"phone_consent": true,
"phone_numbers": [
{
"number": "string",
"type": "Home"
}
],
"address": {
"address1": "string",
"city": "string",
"state": "AA",
"zip_code": "string",
"address2": "string",
"zip_plus_four_code": "string"
},
"date_of_birth": "2023-01-01",
"email": "string"
}