bolta-open-api
  1. 고객
bolta-open-api
  • 볼타 전자(세금)계산서 API 문서
  • 가이드
    • API 키
    • 요청·응답 본문
    • 방화벽 및 보안 프로토콜
    • 웹훅(Webhook) 연결하기
    • 공동인증서 등록 Redirect 정책
    • 전자(세금)계산서 발행마감일 정책
  • 전자(세금)계산서 발행 API 연동 사례
    • 연동 사례 1: 플랫폼 고객이 전자(세금)계산서를 발행하는 경우
    • 연동 사례 2: 우리 회사의 전자(세금)계산서만 발행하는 경우
  • API 문서
    • 전자(세금)계산서 정발행
      • 전자(세금)계산서 정발행
      • 전자(세금)계산서 수정발행 - 계약의 해제
      • 전자(세금)계산서 수정발행 - 공급가액 변동
    • 전자(세금)계산서 역발행
      • 전자(세금)계산서 역발행
    • 전자(세금)계산서 조회
      • 전자(세금)계산서 국세청승인번호 조회
    • 고객
      • 고객 생성
        POST
      • 고객 공동인증서 등록 URL 조회
        GET
      • 고객 조회
        GET
  • SDK
    • SDK: Zapier
    • SDK: Make
  • 에러 코드
    • 전자(세금)계산서 발행 API
    • 전자(세금)계산서 발행 웹훅
    • 고객 생성 API
    • 공통 에러
  1. 고객

고객 조회

GET
https://xapi.bolta.io/v1/customers/{customerKey}

Request

Path Params
customerKey
string 
required
Example:
customer_bf8paz
Header Params
Content-Type
string 
required
Example:
application/json
Authorization
string 
required
Example:
Basic {Base64_Encoded_API_KEY}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://xapi.bolta.io/v1/customers/customer_bf8paz' \
--header 'Authorization: Basic {Base64_Encoded_API_KEY}' \
--header 'Content-Type: application/json'

Responses

🟢200Success
application/json
Body
customerKey
string 
required
identificationNumber
string 
required
Example:
1234567890
Match pattern:
^\d{3}\d{2}\d{5}$
taxRegistrationId
string 
optional
>= 4 characters<= 4 characters
Examples:
00010002
Match pattern:
^(?!0{4})\d{4}$
organizationName
string 
required
>= 1 characters<= 100 characters
representativeName
string 
required
>= 1 characters<= 50 characters
certificate
object 
optional
issuedAt
string 
required
인증서 발행일시 (ISO 8601)
expiresAt
string 
required
인증서 만료일시 (ISO 8601)
Example
{
  "customerKey": "string",
  "identificationNumber": "1234567890",
  "taxRegistrationId": "0001",
  "organizationName": "string",
  "representativeName": "string",
  "certificate": {
    "issuedAt": "string",
    "expiresAt": "string"
  }
}
Previous
고객 공동인증서 등록 URL 조회
Next
SDK: Zapier
Built with