Q: Do you have API Documentation?
A: Our current API Docs with a change log are located @ apidocs.distru.dev.
Q: How do I know when there are breaking changes?
A: Sign up for getting emails for breaking changes to the Distru API, here.
Q: How do we Authenticate / Provide 3rd party keys?
A: A Distru Account with API enabled will have an area to manage the creation and revoking of API keys.
These can be found in Main Menu > Settings > Integrations > Distru API.
Q: Do you have Webhooks?
A: We currently do not have webhooks available in the Distru API.
Q: Do you have Rate Limits?
A: We currently do not have rate limits in the Distru API, though recommended practice is a max of 2 calls/second.
Q: Do you have API Sandbox?
A: We do not have an API Sandbox, all calls will be made to the associated Distru Account that is live.
Q: How do you Paginate?
A: We use the page[number]= paramenter in the query of the call and also provide a next_page_url in the body of the response, if there is another page available.
Page Size limits for endpoints are listed in our API documentation.
Endpoint Query with Page Number Example:
https://app.distru.com/public/v1/products?page[number]=1
cURL Example:
curl --location --globoff 'https://app.distru.com/public/v1/products?page[number]=1' \
--header 'Authorization: Bearer ********* API KEY HERE *********'
Next Page URL Body Example (If Next Page Exits):
"next_page": "https://app.distru.com/public/v1/products?page[number]=2"
Q: How do you filter by a datetime parameter?
A:
Format is as follows: YYYY-MM-DDTHH:MM:SS.MSZ
Comma before the datetime = less than the date in the query.
Comma after the datetime = greater than the date in the query.
Examples:
products?updated_datetime=2025-05-04T04:40:21.817570Z,
Would return any record after May 4th, 2025.
products?updated_datetime=,2025-05-04T04:40:21.817570Z
Would return any record before May 4th, 2025
products?updated_datetime=2025-05-04T04:40:21.817570Z,2025-09-18T16:27:44.946871Z
Would return records between May 4th, 2025 and Sept 18th, 2025