---
title: "Details for one upcoming bill vote"
method: GET
path: "/upcoming-votes/items/{billId}"
tags: ["Upcoming Votes"]
---

# Details for one upcoming bill vote

`GET /upcoming-votes/items/{billId}`

## Request

- Base URL: `https://api.signal8.ai/api/v1/public`
- URL: `https://api.signal8.ai/api/v1/public/upcoming-votes/items/{billId}`
- Auth: API key in header `X-Api-Key`

Full detail for a single upcoming vote, looked up by bill ID
(e.g. `119-hr-3633` — use the `billKey` from the list endpoint, not a
stock ticker).

Returns the bill's affected sectors and verified tickers (each backed by
a quote from the actual bill text), the sponsor's disclosed STOCK Act
trades that match those tickers, key dates, and status history (e.g. a
"pulled" bill means leadership lost the votes).

Note: sponsor trades are public-record disclosures shown with both the
trade date and the disclosure date — they are not evidence of wrongdoing.

**Credit cost: 10**

## Path parameters

- `billId` string, required

## Response `200`

Floor item detail

- object

## Other responses

- `400`: Invalid request parameters
- `401`: Missing or invalid API key
- `402`: Not enough credits for this request
- `404`: Resource not found
- `429`: Rate limit exceeded
- `503`: Upstream floor-intelligence service unavailable (`FLOOR_INTELLIGENCE_UNAVAILABLE`)

---

[API](https://skmtc.dev/signal8/apis/signal8-public-api.md) · [All operations](https://skmtc.dev/signal8/apis/signal8-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signal8/apis/signal8-public-api/revisions/5a18ae8d6d58?raw)
