오류 레퍼런스
모든 오류 응답 본문에는 code, 일반 텍스트로 된 message, request_id, remedies 목록이 포함됩니다. docs 필드는 이 페이지의 해당 코드 항목으로 연결됩니다.
invalid_request (400)
매개변수가 누락되었거나 형식이 잘못되었습니다. 메시지에 해당 매개변수 이름이 표시됩니다. 요청을 수정한 후 다시 전송하세요.
unauthorized (401)
요청에 포함된 API 키의 형식이 잘못되었거나, 키가 폐기되었거나, 경로에 필요한 권한 범위가 없습니다. 모든 데이터 경로는 키 없이도 작동합니다. 키 없이 이용할 때의 한도를 적용하려면 Authorization 헤더를 제거하세요. 키는 아직 일반에 발급되지 않습니다. API 키를 참고하세요.
payment_required (402)
이 응답은 호스트 agent.financial.md에서만 반환됩니다. 해당 호스트의 유료 경로는 결제가 필요하며, PAYMENT-REQUIRED 헤더에 가격과 조건이 포함됩니다. x402로 결제한 후 다시 호출하거나, 일일 한도 내에서 키 없이 api.financial.md의 같은 경로를 호출하세요. 요금을 참고하세요.
unknown_company (404)
company 매개변수와 일치하는 기업이 없습니다. CIK(cik:320193)를 사용하거나 GET /v1/companies?q=로 검색하세요. 상장폐지된 기업은 티커로 조회할 수 없으므로 CIK를 사용하세요. GET /v1/companies?status=delisted는 해당 기업 목록을 반환합니다.
unknown_concept (404)
해당 항목 또는 비율의 ID가 기업 템플릿에 없습니다. GET /v1/company/metrics는 ID 목록을 반환합니다.
not_found (404)
경로, 공시 서류 또는 근거 ID가 존재하지 않습니다. 접수번호 또는 근거 ID를 확인하세요.
not_covered (404)
알려진 기업이지만 해당 기업에 대해 이 데이터셋은 제공되지 않습니다. 응답 본문에 available_datasets가 표시됩니다. IFRS에 따라 보고하는 공시 제출 기업은 공시 서류가 있지만 표준화된 재무제표는 아직 없습니다.
rate_limited (429)
이 유형의 경로에 대한 일일 한도를 모두 사용했습니다. Retry-After에 표시된 초만큼 기다리세요. 한도는 문서 페이지에 안내되어 있습니다. 더 높은 한도의 키는 아직 발급되지 않습니다.
upstream_unavailable (503)
API가 데이터베이스에 연결하지 못했습니다. 잠시 기다린 후 다시 시도하세요. request_id는 해당 호출을 찾는 데 도움이 됩니다.