Mentions

See every document that names a bill, person, or organisation, with the exact quote.

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.