Orders
Create kit orders for your recipients, singly or in bulk — large bulk uploads are processed asynchronously via a pollable job. Pay with prepaid credits or a saved payment method; orders that cannot be charged are created as pending and paid later from the Admin Dashboard. Retrieve individual orders or list them with filters and pagination. A legacy Zapier-compatible create-order alias and token health check exist for older integrations; new integrations should use POST /api/v1/create-order.
Create an order (legacy Zapier alias)
Deprecated — use `POST /api/v1/create-order` instead. Accepts the flat Zapier-style payload (top-level `first_name`, `last_name`, `email`, `street1`, `city`, `state`, `zip`, `kitType`, `quantity`) and processes it identically to `POST /api/v1/create-order`.
Verify an API token
Returns `200` with `{ 'message': 'OK' }` when the API token is valid. Used by the legacy Zapier integration to verify credentials; it also works as a general connectivity check.
Create an order
Creates an order and ships kits to the recipient, deducting credits when your balance covers it.
Get bulk order job status
Returns progress and per-row results for an asynchronous bulk order job created via
Get an order
Returns a single order with recipient details, `externalID`/`externalTags`, registration info, and the current `kitStatus` and `sampleStatus` of every kit in the order. Poll this endpoint after `POST /api/v1/create-order` to track fulfillment, or rely on the outbound kit-updated webhook for push updates.
List orders
Returns your orders, newest first, with pagination metadata. Filter by kit or sample status, order or registration date range, registered customer (email or customer ID), or `sku`. Pages are 0-based; `size` defaults to 50 and is capped at 250. Fetch a single order with `GET /api/v1/orders/{id}`.