Parties and signals
Read a party, review a pending one, and record or assess its claimant signals.
Party IDs start with rpty_.
#GET/v1/radar/parties/:id
One party: name, category, role, whyHere, recital and quote, status, proposedBy, reviewedBy.
Errors: 404 — no party with that ID.
#POST/v1/radar/parties/:id/review
Approve or reject a party whose status is pending. Recorded as radar.party.reviewed.
| Body field | Required | Description |
|---|---|---|
outcome | yes | approved or rejected. |
reviewedBy | yes | Max 120. |
note | no | Max 500. |
Errors: 409 when the party is not pending (for example already approved, or a hypothesis).
#GET/v1/radar/parties/:id/signals
Response 200: { partyId, signals, signalCoverage }.
#POST/v1/radar/parties/:id/signals
Record one claimant signal. Recorded as radar.signal.recorded.
| Body field | Required | Description |
|---|---|---|
criterion | yes | See signal criteria. |
signal | yes | strong, medium, none or unknown. |
value | yes | The sourced observation or calculation. Max 600. |
sourceUrl | unless unknown | http(s) URL. |
by | yes | Max 120. |
Response 201: { partyId, signals, signalCoverage }.
#POST/v1/radar/parties/:id/signals/presence
Assess presence on the market against the French company registry.
| Body field | Description |
|---|---|
period | { from, to } ISO dates, or omitted. |
live | false (default) uses the stored fr_companies snapshot; true calls the API Recherche d'entreprises for activity dates. |
A French registry hit is at most medium. The result is recorded as a radar.signal.recorded event by BINA registry check.
Errors: 400 invalid period, 409 for live: true while offline. Not available in the hosted workspace.
#Signal criteria
| Criterion | Question it answers |
|---|---|
presence_on_market | Was the party active on the market during the infringement? |
declared_impact | Is an impact described for this party? |
change_in_results | Do its results show a change? |
visibility | Is it publicly visible on the issue? |
size_of_stake | How large is its stake? |