Mentions

When a document names a bill, a person, or an organisation, PolicyMate records a mention along with the exact quote. Mentions let you see where a bill is discussed beyond its own record, and who is talking about it, whether that is a committee agenda, an agency comment letter, or a council resolution.

Retrieving Mentions

Mentions may be retrieved from either side of the relationship:

Endpoint	Returns
`GET /bills/{id}/mentions`	Every document that names the bill, newest first
`GET /people/{id}/mentions`	Every document that names the person
`GET /organisations/{id}/mentions`	Every document that names the organisation
`GET /documents/{id}/mentions`	Every bill, person, and organisation the document names

A mention looks like the following:

{
  "id": "88c4...",
  "subject": { "type": "bill", "id": "9b3e2c1a-...", "name": "HB 1234" },
  "document": {
    "id": "d51e...",
    "title": "Public Utility Commission open meeting agenda, March 6, 2027",
    "publisher": "Public Utility Commission of Texas",
    "published_date": "2027-02-27",
    "url": "https://..."
  },
  "quote": "Staff will brief the Commission on the reporting obligations HB 1234 would create for large data centers.",
  "verified": true
}

The subject.type attribute is bill, person, or organisation. The verified attribute is true when PolicyMate has matched the quote word for word against the source text, so you may cite it with confidence.

People and Organisations

The GET /people/{id} endpoint returns a legislator or official, along with their roles over time. You may retrieve the bills a person sponsored using the GET /people/{id}/bills endpoint:

{
  "id": "5c1d...",
  "name": "Jane Doe",
  "roles": [
    {
      "title": "State Representative, District 12",
      "organisation": { "id": "...", "name": "Texas House of Representatives" },
      "party": { "id": "...", "name": "Democratic Party" },
      "start_date": "2025-01-14",
      "end_date": null
    }
  ]
}

Similarly, the GET /organisations/{id} endpoint returns a committee, agency, party, or other body.

Getting Started

Using the API

Reference

Retrieving Mentions

People and Organisations

​Retrieving Mentions

​People and Organisations

Retrieving Mentions

People and Organisations