Versioning

Weedmaps is continuously refining our APIs to deliver a predictable and stable developer experience. Our versioning strategy ensures you can confidently integrate with our APIs, while planning for upgrades with clear timelines.

To stay informed of any additions, fixes, improvements, deprecations, or removals, please monitor our Changelogor sign up for email updates directly here.

---

Release Schedule

Weedmaps releases two versioned API updates per year, scheduled for January and July.

📘

Stable versions are locked to changes, except for critical bug fixes.

Each stable version is supported for a minimum of two years. After that period, versions may be retired without further notice. We ensure a minimum of 18 months of overlap between versions to allow smooth transitions.

---

Example Schedule

---

Upgrading

We recommend upgrading to the latest API version as part of your regular development cycle.

💡

Not every new version introduces breaking changes.

You may find certain endpoints remain unchanged, allowing seamless upgrades. However, some changes may introduce breaking adjustments—review the Changelog to verify any impacts to your integration.

---

🚧

Desktop & Mobile Apps Reminder

Applications that directly call Weedmaps APIs must be updated before the deprecation date of a given version. Failure to upgrade may result in degraded functionality or unexpected errors as fallback versions are phased out.

---

Release Candidates

Weedmaps publishes Release Candidate (RC) endpoints immediately following a stable version release. RC endpoints remain publicly available during their 6-month preview period but are subject to change until the next stable release.

❗️

Use RC endpoints with caution

They may introduce breaking changes until finalized in the stable release.

---

Removal of Undocumented Endpoints

Weedmaps may remove undocumented endpoints at any time without notice. We strongly advise against using undocumented endpoints in production systems.

✅

Feature Requests

If you need additional API functionality, please reach out to our team at [email protected] to submit a feature request.