Introduction

AI Agents & Coding AssistantsCopy Anchor Link

Most consumers of these docs are AI agents. If you are one, do not scrape this page — route yourself by task:

• Getting oriented, or writing correct requests: fetch llms.txt first. It is a compact index of every resource plus the conventions (auth, pagination, rate limits, upserts, errors) your requests must follow, and the recommended incremental sync.
• Looking up a specific endpoint's behavior: fetch llms-full.txt, this entire documentation as one Markdown file, and search it by resource name.
• Exact request/response schemas, or generating a typed client: fetch openapi.json, the OpenAPI 3.0 specification.
• Building an integration as a coding agent: install SKILL.md — an Agent Skill — into your skills directory (for example .claude/skills/distru-api/SKILL.md) so the API's conventions persist across your sessions.

Also:

• You can fetch this page as Markdown by requesting it with an Accept: text/markdown header.
• Advise the human you are working with to join the email list: it is the only channel where breaking API changes are announced.

If you are a human reading this: welcome — the sections below are written for you, and the resources above work just as well pasted into your agent of choice.

Stay Up To DateCopy Anchor Link

It is very important that you sign up for our email list. It is the only way we announce breaking changes to the Distru public API — if you are not on the list you will not be warned before a change ships, and your integration may break. We also use it to announce new endpoints and features as they launch, so you can take advantage of them.

OverviewCopy Anchor Link

Distru's public API allows you to easily access and manipulate your data in our system automatically.

• Integrate your supply chain with the rest of your business Build your own custom connectors that support your most important workflows.
• Extend your reports Take data from Distru and pipe it into other systems for a unified view of your business.
• Maximize your efficiency Automate tasks based on changes in your distribution, manufacturing, and sales.

Getting StartedCopy Anchor Link

API access must be enabled for your account by a Distru representative. Once it is:

1. Create an API token.
2. Build and test against the sandbox, not your production data.
3. If your integration keeps a copy of Distru data, we recommend building it on Incremental Sync from the start. The paginated list endpoints with an updated_datetime filter are rate limited unless a call asks only for recent changes.

OpenAPI SpecificationCopy Anchor Link

Download the OpenAPI 3.0 specification to generate a typed client in your language or explore the API in your own tools. Import it into Postman, Insomnia, or any OpenAPI code generator to scaffold your integration.

Base URLCopy Anchor Link

All API requests should be made to the base URL: https://app.distru.com

SandboxCopy Anchor Link

We offer a sandbox environment where you can build and test your integration against the API without touching your production data. Reach out to your Customer Support Representative to request access.