# Omnishelf Seller API

> Developer documentation for the Omnishelf Seller API — fulfilment orders, labels, tracking, inventory, and webhooks.

The Omnishelf Seller API lets sellers and fulfilment partners list the fulfilment orders they fulfil, download carrier labels, submit and read tracking, report inventory, and receive signed webhooks. Base URL: https://api.omnishelf.com. Authentication: Authorization: Bearer omni_sk_...

## Getting started

- [Overview](https://docs.omnishelf.com/index.md): What the API does, access, base URL
- [Quickstart](https://docs.omnishelf.com/quickstart/index.md): From a new key to a verified webhook in five steps

## Concepts

- [Fulfilment Lifecycle](https://docs.omnishelf.com/concepts/lifecycle/index.md): How orders move through the system
- [Authentication](https://docs.omnishelf.com/concepts/authentication/index.md): Bearer keys, scope, revocation, 401s
- [Conventions](https://docs.omnishelf.com/concepts/conventions/index.md): Identifier formats, timestamps, pagination

## API reference

- [Fulfilment Orders](https://docs.omnishelf.com/api/fulfilment-orders/index.md): List and fetch fulfilment orders
- [Labels](https://docs.omnishelf.com/api/labels/index.md): Order, shipment and parcel labels
- [Tracking](https://docs.omnishelf.com/api/tracking/index.md): Submit and read tracking
- [Inventory](https://docs.omnishelf.com/api/inventory/index.md): Warehouses and inventory
- [Utility](https://docs.omnishelf.com/api/utility/index.md): GET /v1/ping

## Webhooks

- [Overview & Events](https://docs.omnishelf.com/webhooks/overview/index.md): Event types and when nothing is sent
- [Payload Shape](https://docs.omnishelf.com/webhooks/payload/index.md): Envelope and payload fields
- [Signature Verification](https://docs.omnishelf.com/webhooks/verification/index.md): HMAC-SHA256 signature verification
- [Delivery & Retries](https://docs.omnishelf.com/webhooks/retries/index.md): Delivery timeout and retry schedule
- [Testing](https://docs.omnishelf.com/webhooks/testing/index.md): Testing a receiver locally

## Reference

- [Errors & Rate Limits](https://docs.omnishelf.com/reference/errors/index.md): Error codes and rate limits
- [Status Reference](https://docs.omnishelf.com/reference/status/index.md): Order, shipment and parcel statuses
- [Changelog](https://docs.omnishelf.com/reference/changelog/index.md): Dated changes within v1