This page is the DICTIONARY. It says what each code MEANS — the definition of each code,
and what the code includes and excludes — so you can decide whether it is the right one. For the
full value list and how the codes nest, use the
complete event taxonomy.
<2-letter><ordinal> code, so the first two characters identify the domain. Filter with GET /api/v2/events?category=<DOMAIN>, or on a specific code with subcategory.
Codes are a published contract. A code string is in the warehouse and in customer queries, so codes are added and deprecated — never renamed. Filtering on one is safe to hard-code.
The domains
Governance
Acts of government that have taken effect: today, court rulings on whether a law or a government’s or official’s action is lawful. Coded in the POLITICAL lane and served as their own category. What an actor says, demands or threatens about such an act stays POLITICAL; criminal verdicts stay CRIME. These codes are assigned by the POLITICAL coder and served under their own category. Filter withGET /api/v2/events?category=GOVERNANCE, or on a specific subcategory code below. Every code here starts GV.
GV06
COURT RULING ON GOVERNMENT ACTION OR PUBLIC LAW
A court decides whether a law, or something a government or an official did in office, is lawful: a constitutional or supreme court strikes down or upholds a law, a judge blocks, suspends or lifts a block on an executive action, a court orders a government to act or to stop, or an international court rules on a state’s conduct. Coded in the POLITICAL lane; served under GOVERNANCE.
Also covers
- Constitutional court strikes down a law
- Judge blocks an executive order
- Court orders a government to act
- International court rules against a state
- Criminal verdicts, sentences and acquittals → CRIME, or 116
- Disputes between private parties → 116
- A lawsuit or petition filed, or a court agreeing to hear a case → 115, or no Event
- An investigating judge’s inquiry with no ruling → no Event
- A regulator’s decision about a company → CO06

