{
  "openapi": "3.0.1",
  "info": {
    "title": "European Court of Human Rights - Case Law Search (HUDOC)",
    "description": "Search ECHR judgments and decisions in HUDOC (official): full text with AND/OR/NOT, filters by state, article, violation, importance; headnote and operative part.",
    "version": "0.1",
    "x-build-id": "yvckcQW0gZE15NRRg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/legaltech~tedh/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-legaltech-tedh",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/legaltech~tedh/runs": {
      "post": {
        "operationId": "runs-sync-legaltech-tedh",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/legaltech~tedh/run-sync": {
      "post": {
        "operationId": "run-sync-legaltech-tedh",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "One search per item, full text of the documents (English or French; translations in other languages are searched in their language). Syntax: words (implicit AND), \"exact phrase\", AND / OR / NOT (also Y / O / NO and ET / OU / SAUF), -word, * wildcard and parentheses. Example: (eviction OR demolition) AND Roma.",
            "items": {
              "type": "string"
            }
          },
          "caseIds": {
            "title": "Case identifiers",
            "type": "array",
            "description": "Direct lookup: application number (36760/06), ECLI (ECLI:CE:ECHR:2012:0117JUD003676006) or HUDOC item id (001-117763). An application number uses the document type and language filters; an ECLI returns that document in the selected language (every available language if there is none); an item id returns that exact document.",
            "items": {
              "type": "string"
            }
          },
          "documentTypes": {
            "title": "Document types",
            "type": "array",
            "description": "Collections of HUDOC to search. Default: judgments.",
            "items": {
              "type": "string",
              "enum": [
                "JUDGMENTS",
                "DECISIONS",
                "CLIN",
                "COMMUNICATEDCASES",
                "ADVISORYOPINIONS",
                "RESOLUTIONS",
                "REPORTS"
              ],
              "enumTitles": [
                "Judgments",
                "Decisions (admissibility)",
                "Legal summaries (Case-Law Information Note)",
                "Communicated cases",
                "Advisory opinions",
                "Committee of Ministers resolutions (execution)",
                "Commission reports"
              ]
            },
            "default": [
              "JUDGMENTS"
            ]
          },
          "formations": {
            "title": "Court formation",
            "type": "array",
            "description": "Applies to judgments and to decisions. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "GRANDCHAMBER",
                "CHAMBER",
                "COMMITTEE"
              ],
              "enumTitles": [
                "Grand Chamber",
                "Chamber",
                "Committee"
              ]
            }
          },
          "respondentStates": {
            "title": "Respondent states",
            "type": "array",
            "description": "Empty = all states.",
            "items": {
              "type": "string",
              "enum": [
                "ALB",
                "AND",
                "ARM",
                "AUT",
                "AZE",
                "BEL",
                "BIH",
                "BGR",
                "HRV",
                "CYP",
                "CZE",
                "DNK",
                "EST",
                "FIN",
                "FRA",
                "GEO",
                "DEU",
                "GRC",
                "HUN",
                "ISL",
                "IRL",
                "ITA",
                "LVA",
                "LIE",
                "LTU",
                "LUX",
                "MLT",
                "MDA",
                "MCO",
                "MNE",
                "NLD",
                "MKD",
                "NOR",
                "POL",
                "PRT",
                "ROU",
                "RUS",
                "SMR",
                "SRB",
                "SVK",
                "SVN",
                "ESP",
                "SWE",
                "CHE",
                "TUR",
                "UKR",
                "GBR"
              ],
              "enumTitles": [
                "Albania",
                "Andorra",
                "Armenia",
                "Austria",
                "Azerbaijan",
                "Belgium",
                "Bosnia and Herzegovina",
                "Bulgaria",
                "Croatia",
                "Cyprus",
                "Czech Republic",
                "Denmark",
                "Estonia",
                "Finland",
                "France",
                "Georgia",
                "Germany",
                "Greece",
                "Hungary",
                "Iceland",
                "Ireland",
                "Italy",
                "Latvia",
                "Liechtenstein",
                "Lithuania",
                "Luxembourg",
                "Malta",
                "Moldova",
                "Monaco",
                "Montenegro",
                "Netherlands",
                "North Macedonia",
                "Norway",
                "Poland",
                "Portugal",
                "Romania",
                "Russia",
                "San Marino",
                "Serbia",
                "Slovakia",
                "Slovenia",
                "Spain",
                "Sweden",
                "Switzerland",
                "Türkiye",
                "Ukraine",
                "United Kingdom"
              ]
            }
          },
          "articles": {
            "title": "Convention articles invoked",
            "type": "array",
            "description": "Articles examined in the case, in HUDOC notation: \"8\", \"6-1\" (Article 6 § 1), \"14+8\" (Article 14 taken with 8), \"P1-1\" (Protocol 1, Article 1). \"Art. 8\", \"6.1\" or \"6 § 1\" are also accepted. Exact match: \"8\" does not return Article 18. Several = any of them.",
            "items": {
              "type": "string"
            }
          },
          "violatedArticles": {
            "title": "Violation found of",
            "type": "array",
            "description": "Only cases where the Court found a violation of these articles (same format: \"8\", \"6-1\", \"P1-1\"). Exact match: \"6\" finds violations recorded under Article 6 as a whole, \"6-1\" under Article 6 § 1.",
            "items": {
              "type": "string"
            }
          },
          "importance": {
            "title": "Importance level",
            "type": "array",
            "description": "HUDOC importance levels. Key cases and level 1 are the ones that develop the case law. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "1",
                "2",
                "3",
                "4"
              ],
              "enumTitles": [
                "Key cases",
                "Level 1 (high)",
                "Level 2 (medium)",
                "Level 3 (low)"
              ]
            }
          },
          "language": {
            "title": "Language",
            "enum": [
              "ENG",
              "FRE",
              "SPA",
              "ITA",
              "POR",
              "GER",
              "RUS",
              "TUR",
              "UKR",
              "POL",
              "ANY"
            ],
            "type": "string",
            "description": "Language of the documents. The Court publishes in English and French; other languages are official translations, available for a selection of cases.",
            "default": "ENG"
          },
          "dateFrom": {
            "title": "Date from",
            "type": "string",
            "description": "Earliest decision date (YYYY-MM-DD)."
          },
          "dateTo": {
            "title": "Date to",
            "type": "string",
            "description": "Latest decision date (YYYY-MM-DD)."
          },
          "sortOrder": {
            "title": "Sort by",
            "enum": [
              "relevance",
              "newest",
              "oldest"
            ],
            "type": "string",
            "description": "Relevance uses the HUDOC ranking. Without search terms, newest first.",
            "default": "relevance"
          },
          "maxResults": {
            "title": "Max results per search",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Maximum documents per search term (and per case identifier, up to 50).",
            "default": 20
          },
          "includeText": {
            "title": "Read the documents",
            "type": "boolean",
            "description": "Opens each document to extract the official headnote (Art 8 • Family life • …), the operative part (FOR THESE REASONS…) and relevant passages. When a judgment exists only in the other official language (about a third of the English entries are French-only), the text is read from that original and textLanguage says so. Disable for metadata only (much faster).",
            "default": true
          },
          "passages": {
            "title": "Passages per document",
            "minimum": 0,
            "maximum": 20,
            "type": "integer",
            "description": "Paragraphs where the search terms appear. 0 = none.",
            "default": 3
          },
          "includeFullText": {
            "title": "Include full text",
            "type": "boolean",
            "description": "Adds the full text of each document (large output).",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. The source usually works without a proxy. If it blocks, use Apify RESIDENTIAL (FR) or your own proxyUrls; requests then use sticky sessions, IP rotation and a Chrome TLS fingerprint.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}