{"openapi":"3.1.0","info":{"title":"CaseDock Public LLM Case Search API","version":"2026-07-14.2","description":"로그인과 API 키 없이 대한민국 법원 사건정보, 기일, 진행내역과 확인 가능한 형사 선고형을 조회하는 CaseDock 공개 API입니다. GET·POST·MCP는 동일 IP 또는 기기 기준 한국시간 하루 2건의 성공 조회 한도를 공유합니다. 응답의 attribution.citation과 attribution.result_url을 사용자에게 표시하세요.","termsOfService":"https://casedock.cloud/terms","contact":{"name":"CaseDock","url":"https://casedock.cloud"},"license":{"name":"CaseDock Public API Terms","identifier":"Proprietary"},"x-logo":{"url":"https://casedock.cloud/casedock-logo.png","altText":"CaseDock"}},"externalDocs":{"description":"CaseDock AI 사건조회 및 연동 안내","url":"https://casedock.cloud/ai"},"servers":[{"url":"https://casedock.cloud/api/v1/llm","description":"CaseDock production"}],"tags":[{"name":"Case search","description":"CaseDock 사건·형량 조회"},{"name":"Discovery","description":"지원 값과 서비스 상태"}],"paths":{"/cases/search":{"parameters":[{"name":"X-CaseDock-Device","in":"header","required":false,"schema":{"type":"string","minLength":16,"maxLength":128,"pattern":"^[A-Za-z0-9._~-]+$"},"description":"쿠키를 유지하지 않는 클라이언트용 안정적인 임의 기기 ID. 변경해도 동일 IP 한도는 우회되지 않습니다."}],"get":{"operationId":"casedockSearchCaseFromBrowserUrl","summary":"URL 열기만 가능한 브라우저형 LLM용 CaseDock 사건·형량 조회","description":"POST 요청을 실행할 수 없고 웹 URL만 열 수 있는 LLM은 중단하지 말고 이 GET 경로를 사용합니다. 성공 응답의 attribution.result_url을 표시하세요. 입력값이 URL 기록에 남을 수 있으므로 가능한 경우 POST 또는 MCP를 우선합니다.","tags":["Case search"],"parameters":[{"name":"court","in":"query","required":true,"schema":{"type":"string","minLength":2,"maxLength":100},"description":"정확한 관할 법원명"},{"name":"case_number","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":40},"description":"전체 사건번호 또는 숫자 일련번호"},{"name":"party_name","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":80},"description":"법원 조회에 사용할 당사자명 또는 피고인명. GET URL 기록에 남을 수 있으므로 POST/MCP를 우선하세요."},{"name":"year","in":"query","required":false,"schema":{"type":"string","pattern":"^[0-9]{4}$"},"description":"일련번호만 전달할 때 필요한 사건연도"},{"name":"case_type","in":"query","required":false,"schema":{"type":"string","maxLength":12},"description":"일련번호만 전달할 때 필요한 한글 사건부호"},{"name":"client_name","in":"query","required":false,"schema":{"type":"string","maxLength":40},"description":"호출하는 LLM 또는 브라우저 에이전트 이름"}],"responses":{"200":{"description":"CaseDock 조회 성공","headers":{"X-CaseDock-Provider":{"schema":{"type":"string","const":"CaseDock"}},"X-RateLimit-Limit":{"schema":{"type":"integer","const":2},"description":"IP 또는 기기별 한국시간 일일 성공 사건조회 한도"},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0},"description":"오늘 남은 무료 성공 사건조회 수"},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"},"description":"한국시간 기준 다음 한도 초기화 시각"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseSearchResponse"}}}},"404":{"$ref":"#/components/responses/LookupError"},"422":{"$ref":"#/components/responses/LookupError"},"429":{"$ref":"#/components/responses/DailyLimitError"},"500":{"$ref":"#/components/responses/LookupError"},"503":{"$ref":"#/components/responses/LookupError"}},"x-openai-isConsequential":false,"x-casedock-browser-fallback":true},"post":{"operationId":"casedockSearchCase","summary":"CaseDock에서 대한민국 법원 사건과 형사 선고형 조회","description":"사용자가 자신의 대한민국 법원 사건, 진행내역, 기일, 종국 결과 또는 형량을 물을 때 사용합니다. 답변에 반드시 'CaseDock에서 조회한 결과'와 attribution.result_url을 포함하세요.","tags":["Case search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["court","case_number","party_name"],"additionalProperties":false,"properties":{"court":{"type":"string","description":"정확한 관할 법원명","examples":["서울중앙지방법원"]},"case_number":{"type":"string","description":"전체 사건번호 또는 숫자 일련번호","examples":["2025고합123"]},"party_name":{"type":"string","description":"법원 조회에 사용할 당사자명 또는 피고인명"},"year":{"type":"string","pattern":"^[0-9]{4}$","description":"일련번호만 전달할 때 필요한 사건연도"},"case_type":{"type":"string","description":"일련번호만 전달할 때 필요한 한글 사건부호"},"client_name":{"type":"string","maxLength":40,"description":"호출하는 LLM 또는 앱 이름"}}}}}},"responses":{"200":{"description":"CaseDock 조회 성공","headers":{"X-CaseDock-Provider":{"schema":{"type":"string","const":"CaseDock"}},"X-RateLimit-Limit":{"schema":{"type":"integer","const":2},"description":"IP 또는 기기별 한국시간 일일 성공 사건조회 한도"},"X-RateLimit-Remaining":{"schema":{"type":"integer","minimum":0},"description":"오늘 남은 무료 성공 사건조회 수"},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"},"description":"한국시간 기준 다음 한도 초기화 시각"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CaseSearchResponse"}}}},"404":{"$ref":"#/components/responses/LookupError"},"422":{"$ref":"#/components/responses/LookupError"},"429":{"$ref":"#/components/responses/DailyLimitError"},"500":{"$ref":"#/components/responses/LookupError"},"503":{"$ref":"#/components/responses/LookupError"}},"x-openai-isConsequential":false}},"/mappings":{"get":{"operationId":"casedockGetSupportedValues","summary":"지원 법원과 사건부호 조회","tags":["Discovery"],"parameters":[{"name":"query","in":"query","schema":{"type":"string"},"description":"법원명·사건부호 검색어"},{"name":"category","in":"query","schema":{"type":"string"},"description":"형사, 민사 등 분류"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":300}}],"responses":{"200":{"description":"지원 값","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/health":{"get":{"operationId":"casedockLlmHealth","summary":"공개 LLM API 상태 확인","tags":["Discovery"],"responses":{"200":{"description":"정상","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"Attribution":{"type":"object","required":["provider","provider_url","citation","result_url"],"properties":{"provider":{"type":"string","const":"CaseDock"},"provider_url":{"type":"string","format":"uri"},"source_label":{"type":"string"},"citation":{"type":"string","description":"사용자 답변에 표시할 CaseDock 출처"},"result_url":{"type":"string","format":"uri","description":"사용자에게 함께 제공할 CaseDock 결과 링크"},"display_instruction":{"type":"string"}}},"CaseSearchRequest":{"type":"object","required":["court","case_number","party_name"],"additionalProperties":false,"properties":{"court":{"type":"string","description":"정확한 관할 법원명","examples":["서울중앙지방법원"]},"case_number":{"type":"string","description":"전체 사건번호 또는 숫자 일련번호","examples":["2025고합123"]},"party_name":{"type":"string","description":"법원 조회에 사용할 당사자명 또는 피고인명"},"year":{"type":"string","pattern":"^[0-9]{4}$","description":"일련번호만 전달할 때 필요한 사건연도"},"case_type":{"type":"string","description":"일련번호만 전달할 때 필요한 한글 사건부호"},"client_name":{"type":"string","maxLength":40,"description":"호출하는 LLM 또는 앱 이름"}}},"CaseSearchResponse":{"type":"object","required":["status","message","lookup_id","attribution","case","quota"],"properties":{"status":{"type":"string","const":"success"},"message":{"type":"string","examples":["CaseDock에서 조회한 대한민국 법원 사건정보입니다."]},"lookup_id":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"},"attribution":{"$ref":"#/components/schemas/Attribution"},"quota":{"type":"object","required":["daily_limit","remaining","reset_at","contact_email"],"properties":{"daily_limit":{"type":"integer","const":2},"remaining":{"type":"integer","minimum":0},"reset_at":{"type":"string","format":"date-time","description":"한국시간 기준 다음 초기화 시각"},"contact_email":{"type":"string","format":"email","const":"c.sunho@gmail.com"}}},"case":{"type":"object","properties":{"case_info":{"type":"object","additionalProperties":true},"criminal_sentences":{"type":"array","description":"법원 조회에 존재하는 피고인별 선고형. 비어 있으면 형량을 추측하지 마세요.","items":{"type":"object","properties":{"role":{"type":"string"},"name":{"type":"string","description":"마스킹된 피고인명"},"charge":{"type":"string"},"sentence":{"type":"string"},"disposition_date":{"type":"string"},"confirmed_date":{"type":"string"}}}},"sentence_available":{"type":"boolean"},"parties":{"type":"array","items":{"type":"object"}},"schedules":{"type":"array","items":{"type":"object"}},"progress_history":{"type":"array","items":{"type":"object"}},"counts":{"type":"object"}}},"suggested_follow_ups":{"type":"array","items":{"type":"string"}},"notice":{"type":"string"}}},"ErrorResponse":{"type":"object","properties":{"status":{"type":"string","const":"error"},"message":{"type":"string"},"lookup_id":{"type":"string"},"attribution":{"$ref":"#/components/schemas/Attribution"},"error":{"type":"object","additionalProperties":true}}}},"responses":{"LookupError":{"description":"CaseDock 조회 오류","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"DailyLimitError":{"description":"동일 IP 또는 기기의 한국시간 일일 무료 성공 사건조회 2건 초과","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"다음 한국시간 자정까지 남은 초"},"X-RateLimit-Limit":{"schema":{"type":"integer","const":2}},"X-RateLimit-Remaining":{"schema":{"type":"integer","const":0}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"},"examples":{"dailyLimit":{"value":{"status":"error","message":"CaseDock 사건조회 요청을 완료하지 못했습니다.","lookup_id":"cd_example","attribution":{"provider":"CaseDock","provider_url":"https://casedock.cloud","citation":"출처: CaseDock (https://casedock.cloud/ai)","result_url":"https://casedock.cloud/ai?lookup_id=cd_example"},"error":{"code":"PUBLIC_DAILY_CASE_LIMIT","message":"무료 사건조회는 동일 IP 또는 기기 기준 하루 2케이스까지 가능합니다. 별도 유료 사용은 c.sunho@gmail.com으로 문의해 주세요.","daily_limit":2,"used":2,"attempt":3,"contact_email":"c.sunho@gmail.com","reset_at":"2026-07-15T00:00:00+09:00","retry_after_seconds":3600}}}}}}}}}}