# PolicyMate API

> Retrieve bills, documents, mentions, and recommendations from PolicyMate with a read-only REST API.

- [Introduction](https://docs.policymate.io/index.md): Retrieve the legislative and regulatory record PolicyMate maintains, from national parliaments to city councils.
- [Authentication](https://docs.policymate.io/authentication.md): Create an organisation API key, send it with every request, and control which workspaces it can read.
- [Requests and Responses](https://docs.policymate.io/requests.md): Base URL, identifiers and dates, access rules, rate limits, errors, and versioning.
- [Pagination](https://docs.policymate.io/pagination.md): Page through lists with cursors and keep your own copy of the data in sync.
- [Webhooks](https://docs.policymate.io/webhooks.md): Get notified the moment a bill, document, event, or recommendation changes, and verify every delivery.
- [Jurisdictions and Categories](https://docs.policymate.io/reference/jurisdictions-and-categories.md): List the jurisdictions your account covers and the policy categories you can filter by.
- [Bills](https://docs.policymate.io/reference/bills.md): Search bills, filter them, and read their milestones and texts.
- [Documents](https://docs.policymate.io/reference/documents.md): Retrieve notices, agendas, minutes, and staff reports, with their text, publishers, and events.
- [Mentions](https://docs.policymate.io/reference/mentions.md): See every document that names a bill, person, or organisation, with the exact quote.
- [Recommendations](https://docs.policymate.io/reference/recommendations.md): Read the records PolicyMate recommends to your workspaces, with their importance and the reason.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.