NovirAPI

Novir InstaCLEAR partner API

Place drug-test orders, follow them to a result, and receive webhooks when they change.

Base URL

https://api.mynovir.com/v1Open the API reference →

Authentication

Novir issues each partner an API key. Send it on every request as a bearer token or in the x-api-key header.

Authorization: Bearer <api key>
x-api-key: <api key>

Keys are scoped to the locations they were issued for and carry scopes:

  • orders:read list and read orders
  • orders:write create orders
  • results:read reserved; results are on the order
  • locations:read list locations and their SKUs
  • organizations:read not used by this API
  • files:read download report files

Placing an order

  1. GET /locations — pick the locationId.
  2. GET /locations/{id}/skus — pick the skuId (and a testType if the SKU lists any).
  3. POST /orders, then follow the order with webhooks or GET /orders/{id}.

Webhooks

Novir POSTs order events to endpoints configured for your organization: an ORDER_HISTORY event on every status change and a TEST_COMPLETE event when a result is final. Payloads are documented in the reference.