Technical Reference

Neut Widget Customer Reference

Use this reference after the quickstart is working. It lists supported widget IDs, query variables, subject values, status filters, colorways, and bootstrap URL parameters.

Widget IDs And Paths

Widget	`widget_id`	Hosted path
Bill Preview	`bill-preview`	`/bill-preview-embed.html`
Vote Breakdown	`vote-breakdown`	`/vote-breakdown-embed.html`
Legislation By Subject	`legislation-by-subject`	`/legislation-by-subject-embed.html`

The production widget origin is https://widgets.neut.us.

Common Variables

Variable	Type	Required	Notes
`widget_id`	string	Yes	Must match one supported widget ID.
`instance_id`	string	Yes	Unique per placement. Use letters, numbers, dot, underscore, colon, or hyphen. Max 128 characters.
`article_id`	string	No	Useful for customer analytics or tracing.
`colorway`	string	No	Defaults to `Default`.

Do not include tenant_id in the browser payload. The customer backend reads it from server configuration.

Widget Variables

Bill Preview

Variable	Type	Required	Example	Notes
`bill_type`	string	Yes	`HR`	Usually uppercase.
`bill_number`	integer	Yes	`1`	Positive bill number.
`congress`	integer	Yes	`119`	Only the current Congress (119th) is currently supported.
`temp_text_url`	string	No	HTTPS URL	Fallback bill text URL for same-day coverage.
`temp_title`	string	No	`Sample Bill Title`	Fallback title for same-day coverage.

Vote Breakdown

Variable	Type	Required	Example	Notes
`member_type`	string	Yes	`Representative`	Must be `Representative` or `Senator`.
`last_name`	string	Yes	`Lofgren`	Member last name.
`state_code`	string	Yes	`CA`	Two-letter state code.
`district`	integer	House only	`18`	Use for House members. Omit for senators.
`congress`	integer	Yes	`119`	Only the current Congress (119th) is currently supported.
`page`	integer	No	`1`	Defaults to `1`.
`limit`	integer	No	`5`	Defaults to `10`.

Legislation By Subject

Variable	Type	Required	Example	Notes
`member_type`	string	Yes	`Representative`	Must be `Representative` or `Senator`.
`last_name`	string	Yes	`Lofgren`	Member last name.
`state_code`	string	Yes	`CA`	Two-letter state code.
`district`	integer	House only	`18`	Use for House members. Omit for senators.
`congress`	integer	Yes	`119`	Only the current Congress (119th) is currently supported.
`subject`	string	Yes	`Health & Social Welfare`	Must match a supported subject.
`status_filter`	string	No	`All`	Defaults to `All`.
`show_subject_filter`	boolean	No	`false`	Defaults to `true` if omitted by the final iframe URL.
`show_status_filter`	boolean	No	`false`	Defaults to `true` if omitted by the final iframe URL.

Supported Values

Subjects

Animals & Agriculture
Business & Trade
Crime
Culture and Society
Education
Energy & Conservation
Finance & Taxes
Geopolitics
Government Operations
Health & Social Welfare
Human, Civil, & Immigration Rights
Infrastructure & Housing
Labor & Employment
National Security & International Affairs
STEM

Status Filters

All
Introduced
With First Chamber
With Second Chamber
Presented to President
Became Law
Vetoed by President
Passed Resolutions

Colorways

Default
Dark
Paper
WashedSage
Slate
MonoLight

Bootstrap URL Parameters

Query parameter	Source	Notes
`tenant_id`	Server config	`WIDGET_TENANT_ID`.
`widget_id`	Validated request	Must match the hosted path.
`customer_origin`	Server config	`HOST_ORIGIN`; scheme and host only.
`bootstrap_timestamp`	Server generated	Base-10 Unix timestamp in whole seconds.
`bootstrap_nonce`	Server generated	Fresh random nonce for each embed URL.
`bootstrap_key_id`	Server config	`NEUT_MINT_KEY_ID`.
`bootstrap_assertion`	Server generated	HMAC assertion signed with `NEUT_MINT_SECRET`.

The hosted widget exchanges these bootstrap parameters with Neut. Do not put legacy access token, origin, timestamp, nonce, key ID, or signature params in the iframe URL.