Search Patient profiles by mobile number

curl --request GET \
  --url https://api.eka.care/dr/v1/business/patients/search \
  --header 'auth: <auth>'

import requests

url = "https://api.eka.care/dr/v1/business/patients/search"

headers = {"auth": "<auth>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {auth: '<auth>'}};

fetch('https://api.eka.care/dr/v1/business/patients/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eka.care/dr/v1/business/patients/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "auth: <auth>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eka.care/dr/v1/business/patients/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("auth", "<auth>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.eka.care/dr/v1/business/patients/search")
  .header("auth", "<auth>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.eka.care/dr/v1/business/patients/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["auth"] = '<auth>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "profiles": [
      {
        "name": "Amit Kumar",
        "patient_id": "987654321098722",
        "patient_profile": {
          "patient_id": "987654321098722",
          "first_name": "Amit",
          "middle_name": "",
          "last_name": "Kumar",
          "dob": "1990-05-15",
          "gender": "M",
          "mobile": "+919876543210",
          "created_at": "2024-08-13T07:31:53.750Z"
        }
      },
      {
        "name": "Priya Sharma",
        "patient_id": "98765432109222",
        "patient_profile": {
          "patient_id": "987654321098722",
          "first_name": "Priya",
          "middle_name": "",
          "last_name": "Sharma",
          "dob": "1985-09-20",
          "gender": "F",
          "mobile": "+918765432109",
          "created_at": "2023-10-26T06:20:36.758Z"
        }
      },
      {
        "name": "Rahul Gupta",
        "patient_id": "987654321098765",
        "patient_profile": {
          "patient_id": "987654321098765",
          "first_name": "Rahul",
          "middle_name": "",
          "last_name": "Gupta",
          "dob": "1978-11-30",
          "gender": "M",
          "mobile": "+917654321098",
          "created_at": "2024-08-14T09:01:14.806Z"
        }
      }
    ]
  }
}

{
  "data": {},
  "status_code": 403,
  "success": false,
  "error": {
    "code": "UNAUTHORIZED_ACCESS",
    "message": "You do not have permission to search for patients"
  }
}

{
  "error": {
    "code": "PATIENTS_NOT_FOUND",
    "message": "No patients found with the provided mobile number"
  },
  "status_code": 404,
  "success": false
}

{
  "data": {},
  "status_code": 500,
  "success": false,
  "error": {
    "code": "SERVER_ERROR",
    "message": "An unexpected error occurred on the server"
  }
}

Patient Registration APIs (Deprecated)

Search Patient profiles by mobile number

This API provides functionality to get all profiles of patient by their mobile number in business’ directory.

This API only works on 10 digit mobile number and cannot be used for searching partial phone numbers. The patient with given mobile number should already be registered with business account for results to show up.

Request Parameter

Parameter	Type	Expected Values	Description	Required/Optional/Not Required
mobile	string	10 digit phone number	Patient’s mobile number	Required

Response parameter

Parameter	Type	Expected Values	Description
data	object		Response data object
data.profiles	array		List of patient profiles
data.profiles[].name	string	”Amit Kumar”	Patient’s full name
data.profiles[].patient_id	string	”123456789012345”	Unique identifier for the patient (can be null)
data.profiles[].patient_profile	object		Detailed patient profile information
data.profiles[].patient_profile.created_at	string	”2024-08-13T07:31:53.750Z”	Timestamp of profile creation
data.profiles[].patient_profile.dob	string	”1990-05-15”	Patient’s date of birth
data.profiles[].patient_profile.first_name	string	”Amit”	Patient’s first name
data.profiles[].patient_profile.middle_name	string	""	Patient’s middle name (can be empty)
data.profiles[].patient_profile.last_name	string	”Kumar”	Patient’s last name
data.profiles[].patient_profile.gender	string	”M” / “F” / “O”	Patient’s gender
data.profiles[].patient_profile.mobile	string	”+919876543210”	Patient’s mobile number
data.profiles[].patient_profile.patient_id	string \| null	”123456789012345”	Unique identifier for the patient (can be null)
status_code	integer	200	HTTP status code of the response
success	boolean	true	Indicates if the request was successful

Status Codes

• 200: Success

• 403: Patient/Business data missing

• 500: Wrong API URL/Wrong JSON request/ Something went wrong

GET

business

patients

Search Patient profiles by mobile number

curl --request GET \
  --url https://api.eka.care/dr/v1/business/patients/search \
  --header 'auth: <auth>'

import requests

url = "https://api.eka.care/dr/v1/business/patients/search"

headers = {"auth": "<auth>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {auth: '<auth>'}};

fetch('https://api.eka.care/dr/v1/business/patients/search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.eka.care/dr/v1/business/patients/search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "auth: <auth>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.eka.care/dr/v1/business/patients/search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("auth", "<auth>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.eka.care/dr/v1/business/patients/search")
  .header("auth", "<auth>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.eka.care/dr/v1/business/patients/search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["auth"] = '<auth>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "profiles": [
      {
        "name": "Amit Kumar",
        "patient_id": "987654321098722",
        "patient_profile": {
          "patient_id": "987654321098722",
          "first_name": "Amit",
          "middle_name": "",
          "last_name": "Kumar",
          "dob": "1990-05-15",
          "gender": "M",
          "mobile": "+919876543210",
          "created_at": "2024-08-13T07:31:53.750Z"
        }
      },
      {
        "name": "Priya Sharma",
        "patient_id": "98765432109222",
        "patient_profile": {
          "patient_id": "987654321098722",
          "first_name": "Priya",
          "middle_name": "",
          "last_name": "Sharma",
          "dob": "1985-09-20",
          "gender": "F",
          "mobile": "+918765432109",
          "created_at": "2023-10-26T06:20:36.758Z"
        }
      },
      {
        "name": "Rahul Gupta",
        "patient_id": "987654321098765",
        "patient_profile": {
          "patient_id": "987654321098765",
          "first_name": "Rahul",
          "middle_name": "",
          "last_name": "Gupta",
          "dob": "1978-11-30",
          "gender": "M",
          "mobile": "+917654321098",
          "created_at": "2024-08-14T09:01:14.806Z"
        }
      }
    ]
  }
}

{
  "data": {},
  "status_code": 403,
  "success": false,
  "error": {
    "code": "UNAUTHORIZED_ACCESS",
    "message": "You do not have permission to search for patients"
  }
}

{
  "error": {
    "code": "PATIENTS_NOT_FOUND",
    "message": "No patients found with the provided mobile number"
  },
  "status_code": 404,
  "success": false
}

{
  "data": {},
  "status_code": 500,
  "success": false,
  "error": {
    "code": "SERVER_ERROR",
    "message": "An unexpected error occurred on the server"
  }
}

Headers

auth

string

required

The auth token of the user. It is used to authenticate the user.

Query Parameters

mobile

string

required

Example:

"<mobile_no>"

Response

data

Data2 · object

required

Show child attributes

Example:

{
  "patients": [
    {
      "patient_id": "123456789",
      "name": "Test Patient",
      "clinic_id": "12345678",
      "patient_profile": {
        "patient_id": "123456789",
        "first_name": "Test",
        "middle_name": "",
        "last_name": "Patient",
        "dob": "1984-11-11",
        "email": "ekademo@gmail.com",
        "gen": "M",
        "mobile": "+919999999999",
        "created_at": "2021-03-19T13:15:26.318Z"
      }
    },
    {
      "patient_id": "234567890",
      "name": "Test PT 2",
      "is_recent": false,
      "clinic_id": null,
      "patient_profile": {
        "first_name": "Test",
        "middle_name": "PT",
        "last_name": "2",
        "patient_id": "234567890",
        "email": "demo_test@eka.care",
        "gen": "M",
        "mobile": "+91999999999",
        "dob": "1991-11-11",
        "created_at": "2021-03-19T13:15:26318Z"
      }
    }
  ]
}

Add Patient to Directory Get patient details by profile id