메인 콘텐츠로 건너뛰기
GET
서류 발급 결과 조회

인증

Authorization
string
header
필수

API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.

경로 매개변수

issuanceKey
string<uuid>
필수

발급 요청 응답의 issuanceKey

응답

조회 성공

서류 발급 요청과 결과

issuanceKey
string<uuid>
필수

발급 요청 식별자

clientReferenceId
string
필수

요청에 사용한 Bolta-Client-Reference-Id

type
enum<string>
필수

서류 종류

사용 가능한 옵션:
BUSINESS_REGISTRATION_PROOF,
BUSINESS_REGISTRATION_CERTIFICATE,
TAX_PAYMENT_CERTIFICATE,
VAT_TAX_BASE_PROOF,
STANDARD_FINANCIAL_STATEMENT_PROOF,
CORPORATE_REGISTRY_VIEW,
CORPORATE_REGISTRY_ISSUANCE
language
enum<string>
필수

발급한 서류의 언어. 사업자등록증명이 아닌 서류는 항상 KO입니다.

사용 가능한 옵션:
KO,
EN
status
enum<string>
필수

발급 상태

  • ACCEPTED: 접수, 기관 신청 전
  • SUBMITTED: 기관 신청 완료, 결과 대기
  • COMPLETED: 발급 완료
  • FAILED: 발급 실패. 포인트를 차감하지 않습니다. 홈택스 서류는 인증서, 체납, 신고 여부를 확인하세요. 법인등기는 법인등록번호와 법인의 종류, 상태를 확인하세요. 문제가 없으면 잠시 뒤 다시 요청하세요. 다시 요청할 때는 새 Bolta-Client-Reference-Id를 쓰세요
  • ACTION_REQUIRED: 볼타가 결과 확인 중. 같은 서류를 다시 요청하지 말고 COMPLETED 또는 FAILED로 바뀔 때까지 기다리세요
사용 가능한 옵션:
ACCEPTED,
SUBMITTED,
COMPLETED,
FAILED,
ACTION_REQUIRED
requestedAt
string<date-time>
필수

요청을 접수한 시각(UTC)

issuedOn
string<date> | null
필수

원본 PDF에 적힌 발급일. 법인등기는 열람일 또는 발급일입니다. COMPLETED에서만 채웁니다.

retentionExpiresAt
string<date-time> | null
필수

보관 만료 시각(UTC). 발급 후 30일입니다. COMPLETED에서만 채웁니다.

downloadUrl
string<uri> | null
필수

원본 PDF 주소. 홈택스 서류는 5분, 법인등기는 1분 동안 유효합니다. COMPLETED이고 보관 기간 안일 때만 채웁니다. 테스트 키는 서류 종류와 관계없이 5분 동안 유효한 샘플 PDF 주소입니다.

downloadUrlExpiresAt
string<date-time> | null
필수

downloadUrl 만료 시각(UTC)