Order RPh Labs tests for your customers, and follow each one to results.

{
  "ok": true,
  "partner": "Acme Wellness",
  "results_pdfs": false,
  "key_issued_at": "2026-10-16T14:05:00Z",
  "key_expires_at": "2027-10-16T14:05:00Z",
  "time": "2026-10-18T09:30:00Z"
}

{
  "tests": [
    {
      "id": 71,
      "sku": "RPH-PGX-299",
      "name": "CLIA-Accredited Pharmacogenetic Testing Kit",
      "slug": "pharmacogenetic-testing-kit",
      "url": "https://rphlabs.com/pharmacogenetic-testing-kit/",
      "price": "299.00",
      "regular_price": "299.00",
      "sale_price": null,
      "currency": "USD",
      "in_stock": true,
      "short_description": "At-home pharmacogenetic testing kit: one cheek swab shows how your genes are likely to affect 240+ medications.",
      "description": "…",
      "images": ["https://rphlabs.com/wp-content/uploads/2026/09/kit-box-1.webp"],
      "categories": ["CGx & PGX"],
      "requires_physician_review": true,
      "limit_per_person": { "quantity": 1, "days": 365 },
      "updated_at": "2026-10-12T09:30:00Z"
    }
  ],
  "count": 1
}

curl -X POST https://rphlabs.com/wp-json/rph-labs/partner/v1/orders \
  -H "X-RPH-Api-Key: $RPH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_id": "ACME-100245",
    "test_id": 71,
    "patient": {
      "first_name": "Dana",
      "last_name": "Rivera",
      "email": "dana.rivera@example.com",
      "phone": "(305) 555-0142",
      "dob": "1984-03-09",
      "sex": "female"
    },
    "shipping_address": {
      "address_1": "1200 Brickell Ave",
      "address_2": "Apt 1504",
      "city": "Miami",
      "state": "FL",
      "postcode": "33131",
      "country": "US"
    },
    "billing_address": {
      "address_1": "1200 Brickell Ave",
      "address_2": "Apt 1504",
      "city": "Miami",
      "state": "FL",
      "postcode": "33131",
      "country": "US"
    },
    "intake": {
      "current_medications": ["Sertraline 50 mg", "Atorvastatin 20 mg"],
      "considering_medications": ["Bupropion"],
      "allergies": ["Penicillin"],
      "conditions": ["None"]
    },
    "notes": "",
    "send_payment_email": true
  }'

const address = {
  address_1: "1200 Brickell Ave", address_2: "Apt 1504",
  city: "Miami", state: "FL", postcode: "33131", country: "US",
};
const res = await fetch("https://rphlabs.com/wp-json/rph-labs/partner/v1/orders", {
  method: "POST",
  headers: {
    "X-RPH-Api-Key": process.env.RPH_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    external_id: "ACME-100245",
    notes: "",
    test_id: 71,
    patient: {
      first_name: "Dana", last_name: "Rivera",
      email: "dana.rivera@example.com", phone: "3055550142",
      dob: "1984-03-09", sex: "female",
    },
    shipping_address: address,
    billing_address: address,
    intake: {
      current_medications: ["Sertraline 50 mg"],
      considering_medications: ["Bupropion"],
      allergies: ["Penicillin"],
      conditions: ["None"],
    },
    send_payment_email: true,
  }),
});
const order = await res.json();
if (!res.ok) throw new Error(order.message);
console.log(order.payment.url);

import os, requests

address = {
    "address_1": "1200 Brickell Ave", "address_2": "",
    "city": "Miami", "state": "FL", "postcode": "33131", "country": "US",
}

r = requests.post(
    "https://rphlabs.com/wp-json/rph-labs/partner/v1/orders",
    headers={"X-RPH-Api-Key": os.environ["RPH_API_KEY"]},
    json={
        "external_id": "ACME-100245",
        "test_id": 71,
        "patient": {
            "first_name": "Dana", "last_name": "Rivera",
            "email": "dana.rivera@example.com", "phone": "3055550142",
            "dob": "1984-03-09", "sex": "female",
        },
        "shipping_address": address,
        "billing_address": address,
        "notes": "",
        "intake": {
            "current_medications": ["Sertraline 50 mg"],
            "considering_medications": ["Bupropion"],
            "allergies": ["Penicillin"],
            "conditions": ["None"],
        },
        "send_payment_email": True,
    },
    timeout=30,
)
r.raise_for_status()
print(r.json()["payment"]["url"])

$address = [
    'address_1' => '1200 Brickell Ave', 'address_2' => '',
    'city' => 'Miami', 'state' => 'FL', 'postcode' => '33131', 'country' => 'US',
];
$body = [
    'external_id'      => 'ACME-100245',
    'test_id'          => 71,
    'patient'          => [
        'first_name' => 'Dana', 'last_name' => 'Rivera',
        'email' => 'dana.rivera@example.com', 'phone' => '3055550142',
        'dob' => '1984-03-09', 'sex' => 'female',
    ],
    'shipping_address' => $address,
    'billing_address'  => $address,
    'notes'            => '',
    'intake'           => [
        'current_medications'     => ['Sertraline 50 mg'],
        'considering_medications' => ['Bupropion'],
        'allergies'               => ['Penicillin'],
        'conditions'              => ['None'],
    ],
    'send_payment_email' => true,
];
$ch = curl_init('https://rphlabs.com/wp-json/rph-labs/partner/v1/orders');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_POSTFIELDS     => json_encode($body),
    CURLOPT_HTTPHEADER     => [
        'X-RPH-Api-Key: ' . getenv('RPH_API_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$order = json_decode(curl_exec($ch), true);

{
  "orders": [ /* order objects */ ],
  "page": 1,
  "per_page": 20,
  "total": 57,
  "total_pages": 3
}

curl https://rphlabs.com/wp-json/rph-labs/partner/v1/orders/10452/results/11873 \
  -H "X-RPH-Api-Key: $RPH_API_KEY" \
  -o RPH-10452-results.pdf

{
  "id": 10452,
  "number": "10452",
  "external_id": "ACME-100245",
  "status": "kit_shipped",
  "created_at": "2026-10-16T14:05:00Z",
  "updated_at": "2026-10-17T16:40:12Z",
  "paid_at": "2026-10-16T15:22:48Z",
  "payment": {
    "required": false,
    "url": null,
    "total": "299.00",
    "currency": "USD"
  },
  "items": [
    { "test_id": 71, "sku": "RPH-PGX-299", "name": "CLIA-Accredited Pharmacogenetic Testing Kit", "quantity": 1, "total": "299.00" }
  ],
  "patient": {
    "first_name": "Dana", "last_name": "Rivera",
    "email": "dana.rivera@example.com", "phone": "3055550142", "dob": "1984-03-09"
  },
  "shipping_address": {
    "address_1": "1200 Brickell Ave", "address_2": "Apt 1504",
    "city": "Miami", "state": "FL", "postcode": "33131", "country": "US"
  },
  "physician_review": {
    "status": "approved",
    "intake_completed": true,
    "intake_url": null
  },
  "shipments": [
    {
      "kind": "outbound", "carrier": "USPS", "service": "Ground Advantage",
      "tracking_number": "9400111899223197428490",
      "tracking_url": "https://tools.usps.com/go/TrackConfirmAction?tLabels=9400111899223197428490",
      "created_at": "2026-10-17T16:40:00Z"
    }
  ],
  "sample": { "received": false, "received_at": null, "return_tracking_status": null },
  "results_available": 0,
  "results": null
}

curl -G https://rphlabs.com/wp-json/rph-labs/partner/v1/orders \
  -H "X-RPH-Api-Key: $RPH_API_KEY" \
  --data-urlencode "updated_after=2026-10-16T14:00:00Z" \
  --data-urlencode "per_page=100" \
  --data-urlencode "page=1"

const BASE = "https://rphlabs.com/wp-json/rph-labs/partner/v1";

// Returns every order changed since `since` (an ISO 8601 string).
export async function changedOrders(since) {
  const orders = [];
  for (let page = 1; ; page++) {
    const url = `${BASE}/orders?updated_after=${encodeURIComponent(since)}&per_page=100&page=${page}`;
    const res = await fetch(url, { headers: { "X-RPH-Api-Key": process.env.RPH_API_KEY } });
    if (!res.ok) throw new Error((await res.json()).message);
    const body = await res.json();
    orders.push(...body.orders);
    if (page >= body.total_pages) return orders;
  }
}

import os, requests

BASE = "https://rphlabs.com/wp-json/rph-labs/partner/v1"

def changed_orders(since: str) -> list:
    """Every order changed since `since` (an ISO 8601 string)."""
    orders, page = [], 1
    while True:
        r = requests.get(
            f"{BASE}/orders",
            headers={"X-RPH-Api-Key": os.environ["RPH_API_KEY"]},
            params={"updated_after": since, "per_page": 100, "page": page},
            timeout=30,
        )
        r.raise_for_status()
        body = r.json()
        orders += body["orders"]
        if page >= body["total_pages"]:
            return orders
        page += 1

function changed_orders(string $since): array {
    $orders = [];
    for ($page = 1; ; $page++) {
        $url = 'https://rphlabs.com/wp-json/rph-labs/partner/v1/orders?'
            . http_build_query(['updated_after' => $since, 'per_page' => 100, 'page' => $page]);
        $ch = curl_init($url);
        curl_setopt_array($ch, [
            CURLOPT_HTTPHEADER     => ['X-RPH-Api-Key: ' . getenv('RPH_API_KEY')],
            CURLOPT_RETURNTRANSFER => true,
        ]);
        $body = json_decode(curl_exec($ch), true);
        $orders = array_merge($orders, $body['orders']);
        if ($page >= $body['total_pages']) {
            return $orders;
        }
    }
}