Medication Order Metadata

GET

api

info

orders

cURL

curl --request GET \
  --url https://sdp.suki.ai/api/v1/info/orders \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>'

import requests

url = "https://sdp.suki.ai/api/v1/info/orders"

headers = {"sdp_suki_token": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {sdp_suki_token: '<api-key>'}};

fetch('https://sdp.suki.ai/api/v1/info/orders', 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://sdp.suki.ai/api/v1/info/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "sdp_suki_token: <api-key>"
  ],
]);

$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://sdp.suki.ai/api/v1/info/orders"

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

	req.Header.Add("sdp_suki_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://sdp.suki.ai/api/v1/info/orders")
  .header("sdp_suki_token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sdp.suki.ai/api/v1/info/orders")

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

request = Net::HTTP::Get.new(url)
request["sdp_suki_token"] = '<api-key>'

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

{
  "coding_systems": [
    {
      "code": "RXCUI"
    }
  ],
  "dosage_units": [
    {
      "code": "TAB"
    }
  ],
  "encounter_relations": [
    {
      "code": "CURRENT_ENCOUNTER"
    }
  ],
  "frequency_types": [
    {
      "code": "ONE_A_DAY"
    }
  ],
  "origins": [
    {
      "code": "SUKI_AMBIENT"
    }
  ],
  "statuses": [
    {
      "code": "ACTIVE"
    }
  ],
  "timings": [
    {
      "code": "WITH_MEALS"
    }
  ]
}

{
  "code": 401,
  "message": "invalid token"
}

{
  "code": 403,
  "message": "forbidden"
}

Use this endpoint to get supported metadata for medication orders in one response, including coding systems, dosage units, frequency types, timings, statuses, origins, and encounter relations. For more information about medication orders, refer to the Medication orders.

Code examples

Python
TypeScript

import requests

url = "https://sdp.suki-stage.com/api/v1/info/orders"
headers = {
    "sdp_suki_token": "<sdp_suki_token>",
    "sdp_provider_id": "<sdp_provider_id>"
}

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

if response.status_code == 200:
    order_info = response.json()
    print("Medication order metadata:")
    print(f"  Coding systems: {len(order_info.get('coding_systems', []))}")
    print(f"  Dosage units: {len(order_info.get('dosage_units', []))}")
    print(f"  Encounter relations: {len(order_info.get('encounter_relations', []))}")
    print(f"  Frequency types: {len(order_info.get('frequency_types', []))}")
    print(f"  Origins: {len(order_info.get('origins', []))}")
    print(f"  Statuses: {len(order_info.get('statuses', []))}")
    print(f"  Timings: {len(order_info.get('timings', []))}")
else:
    print(f"Failed to get medication order metadata: {response.status_code}")
    print(response.json())

const response = await fetch('https://sdp.suki-stage.com/api/v1/info/orders', {
  headers: {
    'sdp_suki_token': '<sdp_suki_token>',
    'sdp_provider_id': '<sdp_provider_id>'
  }
});

if (response.ok) {
  const orderInfo = await response.json();
  console.log('Medication order metadata:');
  console.log(`  Coding systems: ${orderInfo.coding_systems?.length ?? 0}`);
  console.log(`  Dosage units: ${orderInfo.dosage_units?.length ?? 0}`);
  console.log(`  Encounter relations: ${orderInfo.encounter_relations?.length ?? 0}`);
  console.log(`  Frequency types: ${orderInfo.frequency_types?.length ?? 0}`);
  console.log(`  Origins: ${orderInfo.origins?.length ?? 0}`);
  console.log(`  Statuses: ${orderInfo.statuses?.length ?? 0}`);
  console.log(`  Timings: ${orderInfo.timings?.length ?? 0}`);
} else {
  const error = await response.json();
  console.error(`Failed to get medication order metadata: ${response.status}`, error);
}

Authorizations

sdp_suki_token

string

header

required

Suki access token for the authenticated provider. Obtain this by calling Login or Register with a valid partner_token. Pass the suki_token value from the JSON response as the sdp_suki_token header on REST requests and non-browser WebSocket upgrades. Browser WebSocket clients pass the token in Sec-WebSocket-Protocol instead. Tokens expire after one hour; call Login again to refresh.

Headers

sdp_provider_id

string

Optional - Stable identifier for the active provider. Omit for standard partners whose partner_token identifies the user. Required for Bearer partners and Single Auth Token authentication where multiple providers share one partner_token. Use the same provider_id you sent on Login or Register.

Example:

"provider-123"

Response

Request succeeded.

Response body for the /info/orders endpoint

coding_systems

object[]

Information about supported medication coding systems

Show child attributes

dosage_units

object[]

Information about supported dosage units

Show child attributes

encounter_relations

object[]

Information about supported order encounter relations

Show child attributes

frequency_types

object[]

Information about supported frequency types

Show child attributes

origins

object[]

Information about supported order origins

Show child attributes

statuses

object[]

Information about supported medication order statuses

Show child attributes

timings

object[]

Information about supported medication timings

Show child attributes

Last modified on June 12, 2026

Medication Orders Info API

Medication Coding Systems

⌘I

cURL

curl --request GET \
  --url https://sdp.suki.ai/api/v1/info/orders \
  --header 'sdp_suki_token: <sdp_suki_token>' \
  --header 'sdp_provider_id: <sdp_provider_id>'

import requests

url = "https://sdp.suki.ai/api/v1/info/orders"

headers = {"sdp_suki_token": "<api-key>"}

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

print(response.text)

const options = {method: 'GET', headers: {sdp_suki_token: '<api-key>'}};

fetch('https://sdp.suki.ai/api/v1/info/orders', 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://sdp.suki.ai/api/v1/info/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "sdp_suki_token: <api-key>"
  ],
]);

$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://sdp.suki.ai/api/v1/info/orders"

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

	req.Header.Add("sdp_suki_token", "<api-key>")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://sdp.suki.ai/api/v1/info/orders")
  .header("sdp_suki_token", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sdp.suki.ai/api/v1/info/orders")

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

request = Net::HTTP::Get.new(url)
request["sdp_suki_token"] = '<api-key>'

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

{
  "coding_systems": [
    {
      "code": "RXCUI"
    }
  ],
  "dosage_units": [
    {
      "code": "TAB"
    }
  ],
  "encounter_relations": [
    {
      "code": "CURRENT_ENCOUNTER"
    }
  ],
  "frequency_types": [
    {
      "code": "ONE_A_DAY"
    }
  ],
  "origins": [
    {
      "code": "SUKI_AMBIENT"
    }
  ],
  "statuses": [
    {
      "code": "ACTIVE"
    }
  ],
  "timings": [
    {
      "code": "WITH_MEALS"
    }
  ]
}

{
  "code": 401,
  "message": "invalid token"
}

{
  "code": 403,
  "message": "forbidden"
}

​Code examples

Authorizations

Headers

Response

Code examples