bldinit Nts Rest API

The nts-rest API from bldinit — 3 operation(s) for nts-rest.

GitHub OpenAPI

Operations 3

POST /api/v1/nts/status 사업자등록 상태조회 (단건) #
POST /api/v1/nts/status/batch 사업자등록 상태조회 (최대 100건 일괄) #
POST /api/v1/nts/validate 사업자등록 진위확인 (사업자번호 + 개업일 + 대표자명) #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-nts-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mcpweave-com-nts-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Nts Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: nts-rest
paths:
  /api/v1/nts/status:
    post:
      tags:
      - nts-rest
      summary: 사업자등록 상태조회 (단건)
      description: '입력 사업자번호 (10자리) 의 운영 상태 (계속 / 휴업 / 폐업) 와

        과세유형을 조회. 거래 전 휴폐업 검증 핵심 use case.


        ✅ Read-only (ADR-028 Cat A). 일 100만건 한도, 자동승인.

        ⚠️ NOTE: 입력 b_no 가 list 라 batch 와 동일 endpoint 사용 —

        Phase 1 단건 op 는 list 길이 1 강제. 일괄 호출은

        `nts_check_business_status_batch` 사용 권장.'
      operationId: nts_check_business_status
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/nts/status/batch:
    post:
      tags:
      - nts-rest
      summary: 사업자등록 상태조회 (최대 100건 일괄)
      description: '입력 사업자번호 list (max 100건) 의 운영 상태 일괄 조회. 거래처

        마스터 동기화 / B2B 회원가입 검증 batch.


        ✅ Read-only (Cat A). 단일 호출당 100건 제한이지만 1일 100만건

        한도이므로 사실상 무제한 batch.


        ⚠️ **logical path** — 실제 NTS endpoint 는 `/status` 1개 (body 의

        `b_no` array 길이로 단건/일괄 구분). mcpweave 는 사용자/agent UX

        를 위해 batch 를 별도 operationId 로 노출. client.py 는 동일

        endpoint 호출. 자세한 비교: `docs/research/gov-provider-audit/nts.md`.'
      operationId: nts_check_business_status_batch
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/nts/validate:
    post:
      tags:
      - nts-rest
      summary: 사업자등록 진위확인 (사업자번호 + 개업일 + 대표자명)
      description: '입력 3 필수 필드 (사업자번호 + 개업일자 + 대표자명) 가 모두 NTS

        DB 와 일치하는지 검증. KYC / 거래 신뢰 검증 핵심.


        ✅ Read-only (Cat A). 결과 `valid="01"` 유효 / `valid="02"` 무효.

        무효 시 `valid_msg` 에 한국어 사유.'
      operationId: nts_validate_business
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
              - type: object
                additionalProperties: true
              - type: 'null'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)