서류 발급 요청
서류 발급을 접수합니다. API가 202 Accepted와 issuanceKey를 반환하고 발급은 비동기로 진행합니다. issuanceKey로 결과를 조회하세요.
테스트 키는 기관에 신청하지 않고 포인트도 차감하지 않습니다. 홈택스 서류는 항상 바로 COMPLETED로 끝납니다. 법인등기는 corporationNumber 1100000000014가 COMPLETED, 1100000000071이 FAILED로 바로 끝나고, 다른 번호는 400 INVALID_REQUEST를 반환합니다. COMPLETED 조회 응답에는 샘플 PDF 주소가 담깁니다. 서류 발급 가이드
curl --request POST \
--url https://xapi.bolta.io/v1/documentIssuances \
--header 'Authorization: Basic <encoded-value>' \
--header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
--header 'Content-Type: application/json' \
--data '
{
"document": {
"type": "BUSINESS_REGISTRATION_PROOF",
"language": "KO"
}
}
'{
"issuanceKey": "00000000-0000-4000-8000-000000000001",
"clientReferenceId": "order-20260919-001",
"type": "BUSINESS_REGISTRATION_PROOF",
"language": "KO",
"status": "ACCEPTED",
"requestedAt": "2026-09-19T03:00:00Z",
"issuedOn": null,
"retentionExpiresAt": null,
"downloadUrl": null,
"downloadUrlExpiresAt": null
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}인증
API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.
헤더
1~255자의 요청자 관리번호를 입력하세요. 같은 값과 같은 본문으로 다시 보내면 API가 기존 요청을 반환합니다. 같은 값에 다른 본문을 보내면 409 Conflict와 IDEMPOTENCY_CONFLICT를 반환합니다.
1 - 255\S본문
서류 발급 요청
발급할 서류. type에 맞춰 입력을 채우세요.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
Show child attributes
Show child attributes
응답
접수 완료
서류 발급 요청과 결과
발급 요청 식별자
요청에 사용한 Bolta-Client-Reference-Id
서류 종류
BUSINESS_REGISTRATION_PROOF, BUSINESS_REGISTRATION_CERTIFICATE, TAX_PAYMENT_CERTIFICATE, VAT_TAX_BASE_PROOF, STANDARD_FINANCIAL_STATEMENT_PROOF, CORPORATE_REGISTRY_VIEW, CORPORATE_REGISTRY_ISSUANCE 발급한 서류의 언어. 사업자등록증명이 아닌 서류는 항상 KO입니다.
KO, EN 발급 상태
ACCEPTED: 접수, 기관 신청 전SUBMITTED: 기관 신청 완료, 결과 대기COMPLETED: 발급 완료FAILED: 발급 실패. 포인트를 차감하지 않습니다. 홈택스 서류는 인증서, 체납, 신고 여부를 확인하세요. 법인등기는 법인등록번호와 법인의 종류, 상태를 확인하세요. 문제가 없으면 잠시 뒤 다시 요청하세요. 다시 요청할 때는 새Bolta-Client-Reference-Id를 쓰세요ACTION_REQUIRED: 볼타가 결과 확인 중. 같은 서류를 다시 요청하지 말고COMPLETED또는FAILED로 바뀔 때까지 기다리세요
ACCEPTED, SUBMITTED, COMPLETED, FAILED, ACTION_REQUIRED 요청을 접수한 시각(UTC)
원본 PDF에 적힌 발급일. 법인등기는 열람일 또는 발급일입니다. COMPLETED에서만 채웁니다.
보관 만료 시각(UTC). 발급 후 30일입니다. COMPLETED에서만 채웁니다.
원본 PDF 주소. 홈택스 서류는 5분, 법인등기는 1분 동안 유효합니다. COMPLETED이고 보관 기간 안일 때만 채웁니다. 테스트 키는 서류 종류와 관계없이 5분 동안 유효한 샘플 PDF 주소입니다.
downloadUrl 만료 시각(UTC)
curl --request POST \
--url https://xapi.bolta.io/v1/documentIssuances \
--header 'Authorization: Basic <encoded-value>' \
--header 'Bolta-Client-Reference-Id: <bolta-client-reference-id>' \
--header 'Content-Type: application/json' \
--data '
{
"document": {
"type": "BUSINESS_REGISTRATION_PROOF",
"language": "KO"
}
}
'{
"issuanceKey": "00000000-0000-4000-8000-000000000001",
"clientReferenceId": "order-20260919-001",
"type": "BUSINESS_REGISTRATION_PROOF",
"language": "KO",
"status": "ACCEPTED",
"requestedAt": "2026-09-19T03:00:00Z",
"issuedOn": null,
"retentionExpiresAt": null,
"downloadUrl": null,
"downloadUrlExpiresAt": null
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}{
"code": "<string>",
"message": "<string>",
"traceId": "<string>"
}