# API Reference For Labs

Endpoints for testing labs: manage orders, samples, test results, COAs, and clients. The General reference has the guides covering authentication, request signing, and the response envelope.

Every page below is also available as Markdown by appending `.md` to its URL. The complete OpenAPI 3.1 spec for this section: https://api.confidentcannabis.com/v0/docs/labs/openapi.json

## Clients

Client organizations of a testing lab.

- [Get a client](https://api.confidentcannabis.com/v0/docs/labs/get-client-details.md): GET /v0/labs/client/{client_id}
- [Invite a user to a client](https://api.confidentcannabis.com/v0/docs/labs/post-client-invite.md): POST /v0/labs/client/{client_id}/invite
- [List clients](https://api.confidentcannabis.com/v0/docs/labs/get-clients.md): GET /v0/labs/clients

## Labs

Testing lab information.

- [Get the current lab](https://api.confidentcannabis.com/v0/docs/labs/get-lab.md): GET /v0/labs/lab

## Orders

Create, inspect, and manage testing orders.

- [Create an order](https://api.confidentcannabis.com/v0/docs/labs/create-order.md): POST /v0/labs/order
- [Get an order](https://api.confidentcannabis.com/v0/docs/labs/get-order-details.md): GET /v0/labs/order/{order_id}
- [Update an order](https://api.confidentcannabis.com/v0/docs/labs/patch-order.md): PATCH /v0/labs/order/{order_id}
- [Upload an order document](https://api.confidentcannabis.com/v0/docs/labs/post-order-document.md): POST /v0/labs/order/{order_id}/document
- [Add a sample to an order](https://api.confidentcannabis.com/v0/docs/labs/add-sample-to-order.md): POST /v0/labs/order/{order_id}/samples
- [Cancel an order](https://api.confidentcannabis.com/v0/docs/labs/cancel-order.md): POST /v0/labs/order/{order_id}/status/cancel
- [Complete an order](https://api.confidentcannabis.com/v0/docs/labs/complete-order.md): POST /v0/labs/order/{order_id}/status/complete
- [Revise an order](https://api.confidentcannabis.com/v0/docs/labs/revise-order.md): POST /v0/labs/order/{order_id}/status/revise
- [Un-cancel an order](https://api.confidentcannabis.com/v0/docs/labs/uncancel-order.md): POST /v0/labs/order/{order_id}/status/uncancel
- [Unverify an order](https://api.confidentcannabis.com/v0/docs/labs/unverify-order.md): POST /v0/labs/order/{order_id}/status/unverify
- [Verify an order](https://api.confidentcannabis.com/v0/docs/labs/verify-order.md): POST /v0/labs/order/{order_id}/status/verify
- [List orders](https://api.confidentcannabis.com/v0/docs/labs/get-orders.md): GET /v0/labs/orders

## Samples

Samples under test and their results, files, and edits.

- [Get sample details](https://api.confidentcannabis.com/v0/docs/labs/get-sample-details.md): GET /v0/labs/sample/{sample_id}
- [Edit a sample](https://api.confidentcannabis.com/v0/docs/labs/edit-sample.md): PATCH /v0/labs/sample/{sample_id}
- [Upload a sample CoA](https://api.confidentcannabis.com/v0/docs/labs/post-sample-coa.md): POST /v0/labs/sample/{sample_id}/coa
- [Upload a CoA addition](https://api.confidentcannabis.com/v0/docs/labs/post-sample-coa-addition.md): POST /v0/labs/sample/{sample_id}/coa_addition
- [Upload a sample image](https://api.confidentcannabis.com/v0/docs/labs/post-sample-image.md): POST /v0/labs/sample/{sample_id}/image
- [Submit test results](https://api.confidentcannabis.com/v0/docs/labs/post-sample-test-results.md): POST /v0/labs/sample/{sample_id}/test_results
- [Adjust weight on hand](https://api.confidentcannabis.com/v0/docs/labs/adjust-weight-on-hand.md): POST /v0/labs/sample/{sample_id}/weight_on_hand
- [List samples](https://api.confidentcannabis.com/v0/docs/labs/get-samples.md): GET /v0/labs/samples

## Test Packages

Test packages offered by the lab.

- [List test packages](https://api.confidentcannabis.com/v0/docs/labs/get-test-packages.md): GET /v0/labs/testpackages

---

HTML version: https://api.confidentcannabis.com/v0/docs/labs/  
OpenAPI spec for this section: https://api.confidentcannabis.com/v0/docs/labs/openapi.json  
Request Signing guide: https://api.confidentcannabis.com/v0/docs/request-signing.md