Legal Data Hunter Discover API

The Discover API from Legal Data Hunter — 4 operation(s) for discover.

GitHub OpenAPI

Operations 4

GET /v1/discover/countries List Countries #
GET /v1/discover/countries/{country_code}/sources List Sources #
GET /v1/discover/sources/{source}/filters Get Filters #
GET /v1/discover/courts List Courts #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/legaldatahunter-com:legaldatahunter-com-discover-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

legaldatahunter-com-discover-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Legal Search Discover API
  description: Hybrid semantic + keyword search over EU legal data (case law, legislation, doctrine).
  version: 0.1.0
tags:
- name: Discover
paths:
  /v1/discover/countries:
    get:
      tags:
      - Discover
      summary: List Countries
      description: List all countries with source and document counts.
      operationId: list_countries_v1_discover_countries_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CountriesResponse'
  /v1/discover/countries/{country_code}/sources:
    get:
      tags:
      - Discover
      summary: List Sources
      description: 'List all sources for a given country with metadata.


        By default hides sources with document_count == 0 (placeholders awaiting

        backfill). Pass include_empty=true to see them.'
      operationId: list_sources_v1_discover_countries__country_code__sources_get
      parameters:
      - name: country_code
        in: path
        required: true
        schema:
          type: string
          title: Country Code
      - name: include_empty
        in: query
        required: false
        schema:
          type: boolean
          description: Include sources with 0 indexed documents
          default: false
          title: Include Empty
        description: Include sources with 0 indexed documents
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SourcesResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/discover/sources/{source}/filters:
    get:
      tags:
      - Discover
      summary: Get Filters
      description: 'Get available filter values for a specific source.


        Returns distinct courts, jurisdictions, chambers, decision types, languages,

        and date range. For sources where courts are stored in meta->>''jurisdiction''

        (e.g., FR/Judilibre), those are included too.


        Sources whose `data_types` list is multi-element span multiple namespaces.

        Use the `namespace` query param to pick which one''s filters you want.'
      operationId: get_filters_v1_discover_sources__source__filters_get
      parameters:
      - name: source
        in: path
        required: true
        schema:
          type: string
          title: Source
      - name: namespace
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: 'For sources that span multiple namespaces (per discover_sources'' data_types), pick which one to inspect: ''case_law'', ''legislation'', or ''doctrine''. Defaults to whichever namespace has the most rows.'
          title: Namespace
        description: 'For sources that span multiple namespaces (per discover_sources'' data_types), pick which one to inspect: ''case_law'', ''legislation'', or ''doctrine''. Defaults to whichever namespace has the most rows.'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FilterOptions'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/discover/courts:
    get:
      tags:
      - Discover
      summary: List Courts
      description: 'Get distinct courts available for search filtering.


        These are courts stored in the case_law `court` column which maps

        to Pinecone metadata, so they work as search filters.

        Optionally filter by country or source.'
      operationId: list_courts_v1_discover_courts_get
      parameters:
      - name: country
        in: query
        required: false
        schema:
          type: string
          title: Country
      - name: source
        in: query
        required: false
        schema:
          type: string
          title: Source
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    CountriesResponse:
      properties:
        countries:
          items:
            $ref: '#/components/schemas/CountryInfo'
          type: array
          title: Countries
      type: object
      required:
      - countries
      title: CountriesResponse
    CountryInfo:
      properties:
        code:
          type: string
          title: Code
        case_law_sources:
          type: integer
          title: Case Law Sources
          default: 0
        legislation_sources:
          type: integer
          title: Legislation Sources
          default: 0
        doctrine_sources:
          type: integer
          title: Doctrine Sources
          default: 0
        total_documents:
          type: integer
          title: Total Documents
          default: 0
      type: object
      required:
      - code
      title: CountryInfo
    SourcesResponse:
      properties:
        country:
          type: string
          title: Country
        sources:
          items:
            $ref: '#/components/schemas/SourceInfo'
          type: array
          title: Sources
      type: object
      required:
      - country
      - sources
      title: SourcesResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FilterOptions:
      properties:
        courts:
          items:
            type: string
          type: array
          title: Courts
        jurisdictions:
          items:
            type: string
          type: array
          title: Jurisdictions
        chambers:
          items:
            type: string
          type: array
          title: Chambers
        decision_types:
          items:
            type: string
          type: array
          title: Decision Types
        languages:
          items:
            type: string
          type: array
          title: Languages
        court_tiers:
          items:
            type: integer
          type: array
          title: Court Tiers
        subdivisions:
          items:
            type: string
          type: array
          title: Subdivisions
        date_range:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Date Range
      type: object
      title: FilterOptions
    SourceInfo:
      properties:
        source_id:
          type: string
          title: Source Id
        data_types:
          items:
            type: string
          type: array
          title: Data Types
        court_name:
          anyOf:
          - type: string
          - type: 'null'
          title: Court Name
        tier:
          anyOf:
          - type: integer
          - type: 'null'
          title: Tier
        document_count:
          type: integer
          title: Document Count
          default: 0
        date_range:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Date Range
        notes:
          anyOf:
          - type: string
          - type: 'null'
          title: Notes
      type: object
      required:
      - source_id
      title: SourceInfo
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError