Use the B2B API to connect your organisation's system directly to Hill Labs. Your integration gets server-to-server access to the API functions agreed during onboarding.
What the B2B API supports
- Create a new order and submit samples or sampling supplies.
- Receive job result notifications through a configured endpoint.
- Download available job reports.
- Search results history and retrieve authorised results.
- Register a donor through the API.
Hill Labs confirms the API functions and configuration available to your integration during onboarding.
How to get started
- Confirm your integration scope. Contact the Hill Labs support team to discuss which API functions your integration needs and the onboarding process.
- Arrange credentials and environments. Hill Labs will provide the configuration needed for development and testing.
- Build against the API guides. Start with Authentication, then follow the endpoint guides for your selected functions. Send requests over HTTPS with JSON payloads.
- Complete testing and prepare for production. Work with your Hill Labs contact to complete testing and arrange production access.
Authentication
To authenticate, request an access token using OAuth 2.0 and send it with each API request as a bearer token. See Authentication for the token endpoint, request format and security guidance. Keep your API credentials on your server and do not expose them in browser-based code.
Get support
Contact the Hill Labs support team at cx@hill-labs.co.nz to discuss onboarding, configuration or questions about the API.