Create Verify-Insurance Task

Create an insurance-verification task.

Specify up to five providers and up to three insurance plans. Ferry will check the payer’s provider portal and contact the provider’s office to determine whether each provider is in-network or out-of-network for each plan.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

providerslist of objectsRequired

The providers whose insurance coverage needs to be verified. At least one provider is required, and at most five providers can be specified.

insurancePlanslist of objectsRequired

The insurance plans that must be checked with each provider. At least one plan is required, and at most three plans can be specified.

zipCodestringRequired

The zip code of the member.

notesstringOptional

Any additional notes that are relevant for the insurance verification task.

customMetadataanyOptional

Custom metadata to associate with this task. When you retrieve a task, this metadata will be included in the response.

Response

This endpoint returns an object.

verifyInsuranceTaskIdstring

The ID of the insurance-verification task.

1	curl -X POST https://api.ferry.health/api/v1/verify-insurance \
2	-H "Authorization: Bearer <token>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"providers": [
6	{
7	"npi": "1234567890",
8	"address": "123 Happy Lane, San Francisco, CA 94106",
9	"url": "www.doctors.com/jane-smith"
10	},
11	{
12	"npi": "0001234567",
13	"address": "456 Medical Street, San Francisco, CA 94106"
14	}
15	],
16	"insurancePlans": [
17	{
18	"planName": "Choice Plus",
19	"hiosId": "12345CA8910123",
20	"carrierName": "UnitedHealthCare"
21	}
22	],
23	"zipCode": "94133"
24	}'

1	{
2	"verifyInsuranceTaskId": "ferry.task-verify-in-network.5d3ebb83-af31-41ca-9f85-e442927b8371"
3	}