Your Distru Data, Out of Distru, in 20 Minutes

Questions this answersQuestions this answersfaq

how do I get a Distru API key?how do I get a Distru API key?where does the Distru API token come from?

An admin creates it in Distru under Settings, then Integrations, then Distru API, with Create API Key. It carries that admin's permissions and expires one year after it is issued, so two keys at the same company can return different rows. Treat it like the alarm code: never in a chat window, never in a spreadsheet, only on the machine that runs the script.An admin creates it in Distru under Settings, then Integrations, then Distru API, with Create API Key. It carries that admin's permissions and expires one year after it is issued, so two keys at the same company can return different rows. Treat it like the alarm code: never in a chat window, never in a spreadsheet, only on the machine that runs the script.An admin creates it under Settings, Integrations, Distru API. The token inherits that admin's permissions and team restrictions and expires one year after issue, so create it on the account that should see the data. Keep it in an environment variable server-side, never in a file you could commit, and send it as an Authorization Bearer header.

how do I export all my orders out of Distru automatically?how do I export all my orders out of Distru automatically?how does pagination work on the Distru public API?

Everything sits under one address, then the thing you want: orders, packages, products, inventory. Long lists arrive one page at a time, so you ask for the first page and then follow the next-page address it hands back, exactly as given, until there is none left. Do not write the script yourself: ask an AI to, then read it for three things, that the key comes from outside the file, that it follows next_page, and that a dry run sends nothing.Everything sits under one address, then the thing you want: orders, packages, products, inventory. Long lists arrive one page at a time, so you ask for the first page and then follow the next-page address it hands back, exactly as given, until there is none left. Do not write the script yourself: ask an AI to, then read it for three things, that the key comes from outside the file, that it follows next_page, and that a dry run sends nothing.GET the list endpoint under the v1 base path with a bearer token, then walk the data and next_page envelope: while next_page, follow it verbatim, since it already carries your filters. Never assume a page size, which Distru says outright can change. Datetime filters are inclusive comma ranges and array filters repeat a bracketed key, so a bare scalar where an array is expected is a 400.

why is the Distru API rejecting my request?why is the Distru API rejecting my request?what does a 400 mean here?

Usually a filter name that does not exist. Keys issued on or after 31 August 2026 are strict, so a misspelled parameter is rejected rather than quietly ignored, which is good for you and confusing for a model that guessed a field name. This is exactly why you run the script in dry-run first and read the address it prints before anything is sent.Usually a filter name that does not exist. Keys issued on or after 31 August 2026 are strict, so a misspelled parameter is rejected rather than quietly ignored, which is good for you and confusing for a model that guessed a field name. This is exactly why you run the script in dry-run first and read the address it prints before anything is sent.Every rejection comes back in one envelope: an errors list, each entry carrying a message and a pointer at the offending field. The only status codes v1 returns are 400, 401, 403, 404 and 429, so there is no 422 branch to write. Keys issued on or after 2026-08-31 return 400 on an unknown parameter instead of ignoring it, which is the case an LLM-written client hits when it invents a filter name.