Search Appointment Tasks

POST

https://api.ferry.health/api/v1/appointment-tasks-embedded/search

POST

/api/v1/appointment-tasks-embedded/search

1 curl -X POST https://api.ferry.health/api/v1/appointment-tasks-embedded/search \
2      -H "Authorization: Bearer <token>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "filter": {
6     "patientId": "ferry.patient.84396f99-a7d1-44f9-ae8b-01741931269e"
7   },
8   "pagination": {
9     "page": 0,
10     "pageSize": 10
11   }
12 }'

200Search appointment tasks

1 {
2   "appointmentTasks": [
3     {
4       "status": "FINDING_APPOINTMENT_OPTIONS",
5       "createdAt": "2025-08-06T16:54:21.000Z",
6       "id": "ferry.task-appointment.a3327c6c-1cc2-4f56-a137-6c457550a04e",
7       "isTaskCanceled": false,
8       "patient": {
9         "id": "ferry.patient.84396f99-a7d1-44f9-ae8b-01741931269e",
10         "phoneNumber": "+12234567890",
11         "firstName": "John",
12         "lastName": "Doe",
13         "dateOfBirth": "1980-01-01",
14         "gender": "MALE",
15         "address": "123 Main St, Anytown, CA",
16         "hasOnboarded": true,
17         "insurancePlanName": "Aetna - Managed Choice Open Access",
18         "insurancePlanMemberId": "123456789",
19         "email": "john.doe@example.com"
20       },
21       "task": {
22         "providerSpecialty": "Gastroenterologist",
23         "reasonForVisit": "Ulcerative Colitis",
24         "timeFrame": "Within the next month",
25         "distanceInMiles": 5
26       }
27     }
28   ],
29   "pagination": {
30     "page": 0,
31     "pageSize": 10,
32     "itemsInPage": 10,
33     "totalItems": 1
34   }
35 }

Search appointment tasks.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

filterobjectOptional

The filter to apply to the search.

paginationobjectOptional

The pagination input.

Response

This endpoint returns an object.

appointmentTaskslist of objects

The appointment tasks associated with this patient.

paginationobject

The pagination data.