Chparl Search Business
chparl_search_businessSearch Swiss parliamentary business by title substring, published submitter label, type, current status, submission session, inclusive submission dates, committee role, a member's own roles (personNumber, optionally one role such as author or cosignatory), or topic tag (tagId; without committeeId or personNumber it needs a submission-date window of at most 366 days). Use chparl_list_reference to resolve codes and chparl_get_business to read a returned businessId. Follow nextCursor with unchanged filters; newest canonical business IDs appear first. Author searches omit the business total. Committee searches, and personNumber searches without role, page role candidates and may return short pages without a distinct business total; a personNumber search with one role reports an exact total. Metadata labels remain in de, fr, or it without translation fallback.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "chparl_search_business"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | With personNumber only: one role the member holds. author (Urheber/Auteur/Autore), cosignatory (Mitunterzeichner/Cosignataire/Cofirmatario), spokesperson (Sprecher/Porte-parole/Relatore, e.g. for a parliamentary group's business), opponent (Bekämpfer/Opposant/Opposto), or successor (Übernehmer/Repreneur/Assumente, took over a departed author's business). With one role the result reports an exact totalCount; omit role for every role. | |
| limit | No | Page request, default 20; clamped to 100. Committee pages, and personNumber pages without role, count candidate roles and return each business once, so they may hold fewer businesses. | |
| query | No | One title substring, preserving punctuation and diacritics. | |
| tagId | No | Topic tag ID from chparl_list_reference topic tags, matched as one whole element of the business's pipe-delimited Tags (12 does not match 1216). Without committeeId or personNumber, requires submittedFrom and submittedTo spanning at most 366 inclusive days and reports totalCount on the first page only; if a call runs out of time, retry with a narrower submission window. | |
| author | No | Substring of the published submitter label, not every co-signatory. | |
| cursor | No | Opaque nextCursor from a previous call with identical filters; omit to start. | |
| typeId | No | Business type code from chparl_list_reference topic business_types. | |
| language | No | Metadata language: de (default), fr, or it. | de |
| statusId | No | Current status code from chparl_list_reference topic statuses. | |
| sessionId | No | Submission session ID from chparl_list_reference topic sessions. | |
| committeeId | No | Committee number from chparl_list_reference topic committees; matches any published committee role. | |
| submittedTo | No | Inclusive submission-date upper bound, YYYY-MM-DD. | |
| personNumber | No | Exact member PersonNumber from chparl_search_members, chparl_get_member, a chparl_get_votes member row, or a chparl_search_transcripts passage speaker; former members included. Matches business where that member holds a published role, co-signatures included. Cannot combine with committeeId. | |
| submittedFrom | No | Inclusive submission-date lower bound, YYYY-MM-DD. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Combined clamp, short-page, or empty-result guidance. | |
| hasMore | No | Whether older matching businesses remain. | |
| businesses | No | Distinct complete business summaries on this page. | |
| nextCursor | No | Continue after the smallest delivered business ID using identical filters. | |
| provenance | No | Attribution, publication status, and source download dates. | |
| totalCount | No | Original-filter business total; omitted for author searches, committee searches, personNumber searches without role, and continuation pages of a tagId search without committeeId or personNumber, whose first page carries it. | |
| returnedCount | No | Distinct businesses actually delivered. | |
| effectiveLimit | No | Effective business or role-candidate limit after clamping. | |
| effectiveFilters | No | Effective business discovery filters and defaults. |