> ## Documentation Index
> Fetch the complete documentation index at: https://docs.policymate.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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.


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