> ## Documentation Index > Fetch the complete documentation index at: https://docs.bolta.io/llms.txt > Use this file to discover all available pages before exploring further. # 입출금 계좌 목록 조회 > API 키가 속한 사업자에 연결된 입출금 계좌와 계좌별 동기화 상태를 조회합니다. 다른 사업자의 계좌는 조회할 수 없습니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 계좌는 API로 연결하지 않으니 볼타 대시보드에서 먼저 연결하세요. 테스트 키는 구독과 관계없이 고정 샘플 계좌 2개를 반환합니다. [입출금내역 조회 가이드](/docs/api-introduction/bank-account-transactions) ## OpenAPI ````yaml /openapi.yaml get /v1/bankAccounts openapi: 3.1.0 info: title: 볼타 API description: > 볼타 전자세금계산서 API입니다. [API 소개](/docs/api-introduction/overview) | [인증 가이드](/docs/api-introduction/authentication) | [사용 사례](/docs/api-introduction/usecase-b2b) version: 1.0.0 servers: - url: https://xapi.bolta.io description: 볼타 API 서버 security: - basicAuth: [] tags: - name: 세금계산서 발행 description: > 전자(세금)계산서를 정발행하거나 수정발행합니다. [발행 금액 계산](/docs/api-introduction/issuance-guide) | [수정발행 유형](/docs/api-introduction/amendment-guide) - name: 세금계산서 조회 description: 전자(세금)계산서의 발행 결과와 요청 처리 상태를 조회합니다. - name: 세금계산서 역발행 description: > 전자(세금)계산서 역발행 요청 및 관리. [이메일 승인 역발행](/docs/api-introduction/usecase-reverse-email) | [간편 승인 역발행](/docs/api-introduction/usecase-reverse-simple) - name: 현금영수증 description: > 현금영수증을 발행·취소하고 처리 상태를 조회합니다. 최종 결과는 웹훅이나 상태 조회 API로 확인하세요. LIVE 요청 중 처리 중이거나 발행 결과 확인이 필요한 건은 요청일 다음 날 17:00(KST) 이후에 확정될 수 있습니다. [현금영수증 발행 가이드](/docs/api-introduction/cash-receipt-guide) | [현금영수증 웹훅](/docs/api-introduction/webhook-cash-receipt) - name: 사업자등록 상태 조회 description: > 사업자등록번호의 등록 상태와 과세유형을 단건 또는 최대 100건 일괄로 조회합니다. 발급자 등록과 공동인증서가 필요 없습니다. [사업자등록 상태 조회 가이드](/docs/api-introduction/business-registration-status) - name: 입출금내역 조회 description: > 볼타에 연결한 내 사업자의 입출금 계좌와 입출금내역을 조회하고 동기화를 요청합니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 계좌는 볼타 대시보드에서 먼저 연결하세요. [입출금내역 조회 가이드](/docs/api-introduction/bank-account-transactions) - name: 발급자 description: > 세금계산서 발행 주체인 발급자를 등록·관리합니다. 발행 방식에 따라 공동인증서 필요 여부가 다릅니다. [용어 정리](/docs/api-introduction/glossary) | [대리 정발행](/docs/api-introduction/usecase-delegated) | [위수탁 발행](/docs/api-introduction/usecase-brokered) - name: 인증서 description: > 발급자 공동인증서 등록 및 관리. [인증서 등록](/docs/api-introduction/certificate-registration) paths: /v1/bankAccounts: get: tags: - 입출금내역 조회 summary: 입출금 계좌 목록 조회 description: > API 키가 속한 사업자에 연결된 입출금 계좌와 계좌별 동기화 상태를 조회합니다. 다른 사업자의 계좌는 조회할 수 없습니다. 스탠다드 플랜 이상을 구독해야 하며 포인트는 차감하지 않습니다. 계좌는 API로 연결하지 않으니 볼타 대시보드에서 먼저 연결하세요. 테스트 키는 구독과 관계없이 고정 샘플 계좌 2개를 반환합니다. [입출금내역 조회 가이드](/docs/api-introduction/bank-account-transactions) responses: '200': description: 조회 성공 content: application/json: schema: $ref: '#/components/schemas/BankAccountListResponse' examples: 테스트 키 샘플 계좌: x-parity-id: test-accounts summary: 테스트 키가 반환하는 고정 샘플 value: items: - id: '1' bank: KB_STAR bankName: 국민은행 accountNumber: 123456-01-234567 name: 운영자금 currencyCode: KRW lastSyncedAt: null syncStatus: IDLE - id: '2' bank: SHINHAN bankName: 신한은행 accountNumber: 110-123-456789 name: 매출입금 currencyCode: KRW lastSyncedAt: null syncStatus: IDLE 동기화 진행 중: x-parity-id: in-progress summary: 동기화를 요청한 직후의 계좌 value: items: - id: '1' bank: KB_STAR bankName: 국민은행 accountNumber: 123456-01-234567 name: 운영자금 currencyCode: KRW lastSyncedAt: '2026-09-18T00:00:12Z' syncStatus: IN_PROGRESS headers: {} '401': description: API 키 인증 실패. 응답 본문이 없습니다. '402': description: >- 스탠다드 플랜 미만을 구독 중입니다. 응답의 `code`는 `PLAN_UPGRADE_REQUIRED`입니다. 볼타 대시보드의 결제 메뉴에서 플랜을 업그레이드한 뒤 다시 호출하세요. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: 서버 내부 오류. 응답의 `code`는 `INTERNAL_SERVER_ERROR`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: 일시적인 내부 API 통신 오류. 응답의 `code`는 `SERVICE_UNAVAILABLE`입니다. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' deprecated: false components: schemas: BankAccountListResponse: type: object description: 입출금 계좌 목록 조회 결과 properties: items: type: array description: 연결된 입출금 계좌. 연결된 계좌가 없으면 빈 배열입니다. items: $ref: '#/components/schemas/BankAccount' required: - items ErrorResponse: type: object description: API 요청 실패 시 반환되는 에러 응답 properties: code: type: string description: 에러 타입 식별자 message: type: string description: 에러 설명 traceId: type: string description: 요청 추적 식별자 required: - code - message - traceId BankAccount: type: object description: 볼타에 연결된 입출금 계좌 properties: id: type: string description: 계좌 식별자. 숫자처럼 보여도 문자열로 다루세요. 형식은 바뀔 수 있습니다. bank: type: string description: >- 은행 코드. 예를 들어 `KB_STAR`, `SHINHAN`입니다. 새 은행이 추가될 수 있으니 화면에는 `bankName`을 쓰세요. examples: - KB_STAR bankName: type: string description: 은행 이름 accountNumber: type: string description: 하이픈을 포함한 계좌번호 name: type: string description: 대시보드에서 붙인 별칭. 별칭이 없으면 은행 계좌명입니다. currencyCode: type: string description: 통화 코드 examples: - KRW lastSyncedAt: type: - string - 'null' format: date-time description: 마지막으로 완료한 동기화 시각(UTC). 아직 완료한 동기화가 없으면 `null`입니다. syncStatus: $ref: '#/components/schemas/BankAccountSyncStatus' required: - id - bank - bankName - accountNumber - name - currencyCode - lastSyncedAt - syncStatus BankAccountSyncStatus: type: string enum: - IDLE - IN_PROGRESS - FAILED description: > 계좌의 동기화 상태. `IDLE`: 진행 중인 동기화 없음. `IN_PROGRESS`: 은행 조회 진행 중. `FAILED`: 마지막 동기화 실패. securitySchemes: basicAuth: type: http scheme: basic description: API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요. ````