Get tags
Lists every tag belonging to the authenticated company. Tags are the reusable labels you attach to products and taxes to categorize, group, and filter them.
Results are ordered by creation time, oldest first, and paginated. Narrow the set with the
inserted_datetime and updated_datetime range filters; otherwise it returns the full set for the
company, one page at a time. Follow next_page in the response until it is null to walk the whole list.
Any authenticated API key for the company may read tags; no additional settings permission is required.
BearerAuthorizationBearer <token>API token generated in Distru (Settings → Distru API). Send it on every request as Authorization: Bearer YOUR_API_TOKEN.
ids[]?array<string>Restrict the result to specific tags by ID (the same ID returned as each tag's id). Repeat the bracketed key once per ID. Unknown IDs simply match nothing; an empty list is treated as no filter. At most 200 IDs may be given.
inserted_datetime?stringFilter to tags by their creation datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range: 2022-07-10T00:00:00Z, matches on or after that instant, ,2022-07-10T00:00:00Z matches on or before it.
updated_datetime?stringFilter to tags by their last-updated datetime, given as a comma-separated start,end pair of ISO8601 datetimes (inclusive). Either bound may be omitted for an open-ended range.
page?stringPage selector. Page size is fixed by the server; paginate by following the next_page URL in each response rather than building page selectors yourself — it is null on the last page. next_page uses page[after]=<cursor>, an opaque token marking where the next page resumes; pass it back exactly as given, and only to the endpoint that issued it. This is seek-based, so every page stays fast no matter how deep you page.
A list of tags
*/*- response
A collection of tags
data?array<>Tags
next_page?stringURL for the next page of results; null when there is no next page
curl -X GET 'https://app.distru.com/public/v1/tags'{ "data": [ { "id": "00000000-0000-0000-0000-000000000001", "inserted_datetime": "2026-10-08T09:10:05.692324Z", "name": "T1", "updated_datetime": "2026-10-08T09:10:05.692324Z" }, { "id": "00000000-0000-0000-0000-000000000002", "inserted_datetime": "2026-10-08T09:10:05.693609Z", "name": "T2", "updated_datetime": "2026-10-08T09:10:05.693609Z" }, { "id": "00000000-0000-0000-0000-000000000003", "inserted_datetime": "2026-10-08T09:10:05.694122Z", "name": "T3", "updated_datetime": "2026-10-08T09:10:05.694122Z" } ], "next_page": "https://www.example.com/public/v1/tags?page[after]=ZHwyMDI2LTEwLTA4VDA5OjEwOjA1LjY5NDEyMlp8aXwwMDAwMDAwMC0wMDAwLTAwMDAtMDAwMC0wMDAwMDAwMDAwMDM"}