search - TeamCare APIs

If there is an inbound call, this end point will tell us whether the patient is new or existing. We can take data from patient. That data will be used further for appointmnet scheduling or finding an appointment of a patient.

GET api/v1/ai_voice/organizations/597/patients/search

This endpoint retrieves the patient who is calling Practice if already existing in TC database. This will be necessary for avoiding duplication of patients while scheduling an appointment. We can search the patient with fewer attributes also but data or birth and phone_number will be mandatory. The id returned will be sent in finding appointments.

Parameters

curl -X GET "https://app.teamcaredental.com/api/v1/ai_voice/organizations/:organization_id/patients/search" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "patient": {
      "first_name": "test",
      "last_name": "patient",
      "birth_date": "1977-02-25",
      "phone_number": "1122334455"
    }
  }'

const response = await fetch("https://app.teamcaredental.com/api/v1/ai_voice/organizations/:organization_id/patients/search?patient[first_name]=test&patient[last_name]=patient&patient[birth_date]=1977-02-25&patient[phone_number]=1122334455", {
  headers: {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN"
  }
})

const data = await response.json()

import requests

response = requests.get(
    "https://app.teamcaredental.com/api/v1/ai_voice/organizations/:organization_id/patients/search",
    headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
    json={
      "patient": {
        "first_name": "test",
        "last_name": "patient",
        "birth_date": "1977-02-25",
        "phone_number": "1122334455"
      }
    }
)

data = response.json()

require "net/http"
require "json"

uri = URI("https://app.teamcaredental.com/api/v1/ai_voice/organizations/:organization_id/patients/search")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_ACCESS_TOKEN"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "patient" => {
    "first_name" => "test",
    "last_name" => "patient",
    "birth_date" => "1977-02-25",
    "phone_number" => "1122334455"
  }
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

data = JSON.parse(response.body)

Response

The response will be used for appointment scheduling etc.

Content-Type: application/json

{
    "data": {
        "id": "2os6GZzZ",
        "type": "patient",
        "attributes": {
            "first_name": "test",
            "last_name": "01",
            "birth_date": "0001-01-01",
            "email": "test@gmail.com",
            "phone_number": "7262275678"
        }
    }
}

⌘I