Raw schema
{
"type": "object",
"properties": {
"case_number": {
"description": "Number of a single case: C-{num}/{year} (Court of Justice), T-{num}/{year} (General Court), or F-{num}/{year} (Civil Service Tribunal), e.g. C-131/12. Also accepts the case_reference form (\"Case C-97/23 P.\"), any procedural suffix after the year (P, R, PPU, β¦), and a pre-1989 Court of Justice number with no prefix (26/62). A value naming more than one case (\"C-131/12 and C-132/12\") is rejected; search each separately. Matches the judgments, orders, AG opinions, and other primary records filed under that number; derivative records (notices, abstracts, summaries, corrigenda) join only under include_derivative. Numbered Opinions and Rulings of the Court of Justice (\"Opinion 2/13\", \"Ruling 1/78\") are not reached by a case number; look one up by its CELEX (e.g. 62013CV0002). A value made only of CELEX characters is matched as a CELEX substring instead, case-insensitively: one opening with the sector and year (62014CJ0362), the year and both letters (2013CJ0131), or both letters and the number (CJ0131) is answered from the CELEX index; any other (12CJ0131, 0131) tests every CELEX and can take tens of seconds.",
"type": "string"
},
"keyword": {
"description": "Keyword matched against English case titles via the full-text index (multi-word input is treated as a phrase), and against CELEX numbers. A keyword that is a whole CELEX (e.g. 62023CO0097) matches that record, its numbered siblings (β¦(01) to β¦(20)), its _INF, _RES, _SUM, and _EXT records, and its corrigenda, with notices, abstracts, summaries, and corrigenda still joining only under include_derivative; for every record filed under a case, use case_number. A partial CELEX that opens with the sector and year (62013CJ), the year and type letters (2013CJ0131), or type letters followed by the number (CJ0131, J0131) matches every CELEX that holds it at that position; one opening with letters not followed by a digit (R(01)) tests every CELEX and can take tens of seconds; a bare year (2013) or a fragment opening mid-year or mid-number (013CJ0131, 0131) matches titles only. A keyword with no digit, or with a character no CELEX holds (a space, a period), matches titles only. A keyword with no letter or digit is rejected.",
"type": "string"
},
"court": {
"description": "Court filter, by the court letter at position 6 of the CELEX: CJEU (C) = Court of Justice of the EU, GC (T) = General Court. It does not narrow by record type: every primary record the court filed matches, and its derivative records (notices, abstracts, summaries, corrigenda) join only under include_derivative. Omit to search every court.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"enum": [
"CJEU",
"GC"
],
"description": "CJEU (C) = Court of Justice of the EU, GC (T) = General Court."
}
]
},
"case_type": {
"description": "Case type: judgment, order (procedural decision), or ag_opinion (Advocate General opinion or view). Omit to search all.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"enum": [
"judgment",
"order",
"ag_opinion"
],
"description": "judgment, order (procedural decision), or ag_opinion (Advocate General opinion or view)."
}
]
},
"member_state": {
"description": "Member state the case originates in, as CELLAR records it: the referring court's state on a preliminary reference, the defendant state on an action for failure to fulfil obligations, the applicant's state (or the member state party) on a direct action. A member state as its ISO 3166-1 alpha-3 code (DEU, GRC, GBR for the United Kingdom) or two-letter code (DE; EL or GR for Greece; UK or GB), in any case: the 27 member states plus the United Kingdom. Cases CELLAR records no country for, Civil Service Tribunal staff cases among them, never match. Leave blank or omit to search every state.",
"type": "string"
},
"procedure_type": {
"description": "Procedure type, as CELLAR classifies the case: preliminary_ruling (urgent references included), annulment, staff_case, appeal, failure_to_fulfil_obligations, damages, interim_measures, appeal_against_penalty, failure_to_act, or arbitration_clause. A case can carry several: an appeal also carries the action appealed. Each row lists its own in procedure_types. Omit to search all.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"enum": [
"preliminary_ruling",
"annulment",
"staff_case",
"appeal",
"failure_to_fulfil_obligations",
"damages",
"interim_measures",
"appeal_against_penalty",
"failure_to_act",
"arbitration_clause"
],
"description": "preliminary_ruling, annulment, staff_case, appeal, failure_to_fulfil_obligations, damages, interim_measures, appeal_against_penalty, failure_to_act, or arbitration_clause."
}
]
},
"outcome": {
"description": "Outcome CELLAR records with the procedure: successful, unfounded, inadmissible, or decision_unnecessary. With procedure_type, both hold on the same procedure (annulment with successful finds annulment actions that succeeded); alone, any procedure with that outcome. Preliminary references rarely record one. Omit to search all.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"enum": [
"successful",
"unfounded",
"inadmissible",
"decision_unnecessary"
],
"description": "successful, unfounded, inadmissible, or decision_unnecessary."
}
]
},
"subject": {
"description": "Subject phrase matched against the English labels of CELLAR's case-law subject classification: the search covers every subject whose label contains each word of the phrase, in any case and also inside a longer word (\"trade mark\" matches \"Trade marks\", \"personal data\" \"Protection of personal data\", \"tax\" also \"Taxation\"). query_echo.subject_labels names the subjects matched; each row lists its own in subjects. This is not the title's subject_matter keywords. A phrase matching no label returns an empty page with a notice. Leave blank or omit to search every subject.",
"type": "string"
},
"include_derivative": {
"default": false,
"description": "Include derivative sector-6 records β judicial information notices, case abstracts, case summaries, and corrigenda β alongside primary judgments, orders, AG opinions, and AG views. Default false: these are excluded so distinct primary cases fill the page. Ignored when case_type is set (that path already requires the selected primary type family). Has no effect beside member_state, procedure_type, outcome, or subject, since derivative records carry none of those facts.",
"type": "boolean"
},
"date_from": {
"description": "Start of date range in ISO 8601 format (YYYY-MM-DD). Leave blank or omit for no lower bound.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date in ISO 8601 format (YYYY-MM-DD)."
}
]
},
"date_to": {
"description": "End of date range in ISO 8601 format (YYYY-MM-DD). Leave blank or omit for no upper bound.",
"anyOf": [
{
"type": "string",
"const": ""
},
{
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "End date in ISO 8601 format (YYYY-MM-DD)."
}
]
},
"offset": {
"default": 0,
"description": "Pagination offset β number of results to skip. Defaults to 0. Must be below 10,000: CELLAR sorts at most 10,000 matches for one search, so pages stop at row 10,000; narrow with a date_from/date_to window to reach older cases.",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"default": 20,
"description": "Maximum number of results to return, served up to 100 per call; a larger value (up to 10,000) is served at 100 and reported in limit_clamp. Defaults to 20.",
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}