Retrac API Reference - Introduction

Retrac’s API is in beta. Questions or feedback: [email protected].

Retrac exposes a REST API for managing workspace inventory: items, tags, locations, on-hand stock, transfers, and workspace metadata.

Authentication

API keys, scopes, and workspace ID

Safe integration practices

https://api.retrac.co

HTTPS is required. HTTP requests are not supported.

curl -s "https://api.retrac.co/items?workspaceId=YOUR_WORKSPACE_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Pass your API key as a Bearer token:

Authorization: Bearer YOUR_API_KEY

See Authentication for full-access vs restricted (retrac_) keys and scope details.

Most endpoints require workspaceId as a query parameter (full-access keys only):

https://api.retrac.co/items?workspaceId=YOUR_WORKSPACE_ID

Find it under Settings → General in the dashboard.

Resource	Endpoints	Description
Items	`/items`, `/items/bulk`, `/items/count`	Product catalog CRUD
Tags	`/tags`	Organize items
Locations	`/locations`, `/locations/count`	Warehouses, vans, sites
Inventory	`/inventory/balances`, `/inventory/movements`	Stock levels and ledger
Transfers	`/inventory/transfers`	Move stock between locations
Workspaces	`/workspaces`	Workspace metadata

OpenAPI spec: https://api.retrac.co

Code	Meaning
`200`	Success
`201`	Created
`400`	Bad request
`401`	Invalid or missing API key
`403`	Forbidden (scope, role, or plan)
`404`	Resource not found
`409`	Conflict (duplicate slug, name, etc.)
`429`	Rate limit exceeded
`500`	Server error

See Errors for machine-readable error codes.

The API is currently at version 0.0.1. Breaking changes will be minimized during beta; monitor this documentation for updates.