{"openapi":"3.1.0","info":{"title":"LegalIndex Public Directory API","version":"2.1.0","description":"Read-only Israeli law firm directory and separate live Israel Bar search. List order is not a quality ranking. Versioning policy: breaking REST changes use a new major /api/vN path. Deprecations are announced in /developers with Deprecation and Sunset headers before removing a version. No endpoints are currently deprecated."},"servers":[{"url":"https://legalindex.co.il"}],"paths":{"/api/v1/firms":{"get":{"operationId":"listFirms","summary":"List and filter law firms","parameters":[{"name":"q","in":"query","required":false,"description":"Name or practice search","schema":{"type":"string"}},{"name":"specialty","in":"query","required":false,"description":"Exact practice slug","schema":{"type":"string"}}],"responses":{"200":{"description":"Sourced data with checked_at, notice and data fields","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Per-worker-instance requests per 60 seconds"},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until this window resets"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"Rate limit exceeded; respect Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/firms/{id}":{"get":{"operationId":"getFirm","summary":"Retrieve one law firm with practices and evidence","parameters":[{"name":"id","in":"path","required":true,"description":"Firm slug","schema":{"type":"string"}}],"responses":{"200":{"description":"Sourced data with checked_at, notice and data fields","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Per-worker-instance requests per 60 seconds"},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until this window resets"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Unknown firm","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; respect Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/specialties":{"get":{"operationId":"listSpecialties","summary":"List the available practice areas and their firm shortlists","responses":{"200":{"description":"Sourced data with checked_at, notice and data fields","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Per-worker-instance requests per 60 seconds"},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until this window resets"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"429":{"description":"Rate limit exceeded; respect Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/v1/specialties/{slug}":{"get":{"operationId":"getSpecialty","summary":"Retrieve a practice area and its source-linked firm shortlist","parameters":[{"name":"slug","in":"path","required":true,"description":"Practice slug","schema":{"type":"string"}}],"responses":{"200":{"description":"Sourced data with checked_at, notice and data fields","headers":{"RateLimit-Limit":{"schema":{"type":"integer"},"description":"Per-worker-instance requests per 60 seconds"},"RateLimit-Remaining":{"schema":{"type":"integer"}},"RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until this window resets"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Envelope"}}}},"404":{"description":"Unknown practice","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; respect Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/api/lawyers/search":{"get":{"operationId":"searchLawyersIsrael","description":"At least firstName or lastName is required. Queries the official external source on demand.","parameters":[{"name":"firstName","in":"query","required":false,"description":"First name","schema":{"type":"string"}},{"name":"lastName","in":"query","required":false,"description":"Last name","schema":{"type":"string"}},{"name":"district","in":"query","required":false,"description":"District code 1 through 6","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000}}],"responses":{"200":{"description":"Live official-source search results"},"400":{"description":"Invalid query","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Rate limit exceeded; respect Retry-After","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"500":{"description":"Internal error","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"502":{"description":"External source unavailable","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}},"components":{"schemas":{"Problem":{"type":"object","required":["type","title","status","detail","error","code"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"error":{"type":"string"},"code":{"type":"string"}}},"Envelope":{"type":"object","required":["name","checked_at","notice","data"],"properties":{"name":{"type":"string"},"checked_at":{"type":"string","format":"date"},"notice":{"type":"string"},"data":{"description":"Source-linked firm profiles or practice shortlists"}}}}}}