Get strains
List the strains in your catalog. A strain is a reference record — a genetic classification you attach to products — so this endpoint is a lookup of that catalog, not of inventory or orders. Use it to resolve a strain's id before referencing it elsewhere, or to sync your local copy of the strain list.
Results are scoped to your company and paginated (up to 5000 strains per page). Filter by name (case-insensitive substring), types (one or more genetic classifications), or by creation/last-modified window. When more than one filter is supplied they combine with AND (a strain must satisfy every filter to be returned). Both datetime filters are inclusive on the bounds you provide. Strains are not soft-deleted or archived, so every strain in your catalog is returned — there are no hidden states to account for.
Responses are eventually consistent: a strain you just created or updated may take up to 1 second to appear here or reflect its latest values.
Required permission: settings_permissions_strains.
Query parameters
Restrict the result to specific strains by ID (the same ID returned as each strain'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.
Filter by creation datetime. Accepts a comma-separated from,to range (ISO-8601 UTC); either bound is inclusive and either side may be omitted. 2022-07-10T00:00:00Z, returns strains created on or after that instant; ,2022-07-10T00:00:00Z returns those created on or before it; 2022-07-01T00:00:00Z,2022-07-31T23:59:59Z returns a closed window. Omit entirely to apply no creation-time filter.
Case-insensitive substring match on the strain name (partial matches count; e.g. kush matches OG Kush). Send a single value, not a list.
Page 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.
Restrict the result to strains whose genetic classification (strain_type) is any of the given types (SCREAMING_CASE, matches ANY). Repeat the bracketed key once per type. An empty list is treated as no filter; at most 200 types may be given.
Filter by last-modified datetime. Accepts a comma-separated from,to range (ISO-8601 UTC); either bound is inclusive and either side may be omitted. ,2022-07-10T00:00:00Z returns strains last modified on or before that instant; 2022-07-10T00:00:00Z, returns those modified on or after it. Omit entirely to apply no update-time filter.
Response
A list of strains
Changes
No recorded changes to this endpoint across all 1 revision of this API.