Skip to main content

Customers & Reports

Customers are the people you test; reports are their processed biomarker results. The two travel together: a report is always fetched through its customer.

List customers

GET /api/v1/customers

Returns the customers belonging to your business. A customer record is created automatically when a kit is registered to a new email address, so customerID values only exist for registered kits (the kit webhook payload carries the customerID once registration completes).

Fetch a report

GET /api/v1/customers/{customerID}/reports/{reportID}

Returns a released report for the given customer. Whether a report is visible to its user is controlled by your publishing settings (manual review or auto-publish); see Global Settings.

note

With a sandbox token these endpoints return only your sandbox customers and reports; see Sandbox Testing.

Open the live API playground

Full request and response schemas for every endpoint, testable with your sandbox token.