For Developers

Build COSAPinto your stack

One authenticated REST API for Korean tax, banking, payroll and AI classification. Issue NTS tax invoices, sync 6 banks and 8 card issuers, and auto-classify transactions — straight from your own system.

# Issue an electronic tax invoice → NTS
curl -X POST https://api.cosap.io/v1/tax-invoices \
  -H "Authorization: Bearer sk_live_x9f2…" \
  -H "Content-Type: application/json" \
  -d '{
    "buyer_biz_no": "120-86-00000",
    "supply_amount": 1500000,
    "items": [{ "name": "License" }]
  }'
# Issue an electronic tax invoice → NTS
import cosap

client = cosap.Client("sk_live_x9f2…")

invoice = client.tax_invoices.create(
    buyer_biz_no="120-86-00000",
    supply_amount=1500000,
    items=[{"name": "License"}],
)
print(invoice.status)  # "transmitted"
// Issue an electronic tax invoice → NTS
import Cosap from "cosap";

const client = new Cosap("sk_live_x9f2…");

const invoice = await client.taxInvoices.create({
  buyerBizNo: "120-86-00000",
  supplyAmount: 1500000,
  items: [{ name: "License" }],
});
# → 201 Created — transmitted to NTS ✓
Banking & Cards
Tax & Compliance
AI & Intelligence
Platform & Data
Why build on COSAP

An operations platform you can call from code

COSAP already runs finance, HR and accounting for real businesses. The same engine is exposed as a clean API so your product can read, write and automate against it.

One unified API

Banking, cards, tax, HR and accounting behind a single authenticated REST surface — no per-source logins or separate vendors to stitch together.

AI classification

Send bank and card transactions and get them auto-categorized into 20+ accounting categories, trained on Korean business spending patterns.

Real-time webhooks

Subscribe to sync, classification and risk events. COSAP pushes updates to your endpoint the moment new data lands — no polling required.

The API catalog

Nine APIs across four families

Everything COSAP connects to or learns from is available as an endpoint. Grouped by what it does — explore the shape here, then dive into the full reference (coming soon).

Banking & Cards
GET/v1/bank/transactions
Deposits & withdrawals across 6 Korean banks in one authenticated call.
GET/v1/cards/transactions
Corporate & personal card usage from 8 issuers, normalized to one schema.
Tax & Compliance
GET/v1/tax-invoices/sync
Pull issued & received tax invoices and cash receipts directly from NTS.
POST/v1/tax-invoices
Issue electronic tax invoices and transmit to NTS via Barobill.
POST/v1/compliance/check
Validate work records against Korean Labour Law and return violations.
AI & Intelligence
POST/v1/classify
Auto-categorize bank & card transactions into 20+ accounting categories.
POST/v1/risk/scan
Anomaly, fraud and liquidity signals with per-alert AI analysis.
POST/v1/documents/extract
OCR, entity extraction and tax-code mapping for any document.
Platform & Data
GET/v1/query
One query API across GL, inventory, HR and CRM — cross-module answers.
POST/v1/workflows
Create, route and approve requests programmatically from any system.
Paths are illustrative of the planned REST API. View the full API reference →
See it in action

Predictable JSON, every call

One consistent response shape across every endpoint — typed fields, explicit errors and confidence scores your code can rely on in production.

Classify a transaction

Send a raw bank or card line and get back a category, confidence score and a ready-to-post journal entry. The same response shape across every endpoint.

  • Stable, versioned JSON responses
  • Confidence scores on AI outputs
  • Maps straight to accounting journals
POST /v1/classify
{
  "description": "스타벅스 강남R점",
  "amount": 8500,
  "source": "card"
}
{
  "category": "meals_entertainment",
  "confidence": 0.97,
  "journal": {
    "debit": "811 복리후생비",
    "credit": "103 보통예금"
  }
}
# 200 OK · ~120ms
SDKs & tools

Built for your stack

Call the API with plain HTTPS today, or reach for an official client library. Testing tools are on the way as we open up early access.

cURL / REST Python Node.js Java
Developer tooling
Sandbox & test keysSoon Postman collectionSoon Webhook consoleSoon Full API reference
Quickstart

From zero to first call in three steps

A simple path from credentials to live data. During early access, our team provisions your keys and helps you go live.

01

Request your API key

Tell us what you're building and which APIs you need. We provision credentials for your account.

02

Authenticate

Send your key as a Bearer token over HTTPS. Try everything safely in the sandbox before going live.

03

Make your first call

Hit any endpoint and handle the JSON response — or subscribe to a webhook and let COSAP push events to you.

Trust & security

Built for financial data

You're handling tax and banking data, so the API is designed around isolation, verified sources and revocable access from day one.

Tenant-isolated

Every request is scoped to your organization. Complete data isolation, enforced at every layer.

NTS & Barobill-verified

Tax data is sourced from official channels for zero-omission, audit-ready accuracy.

Encrypted credentials

Financial logins are encrypted at rest and API keys are scoped and revocable at any time.

Built on COSAP

The same platform running real finance, HR and accounting operations every day.

Build with the COSAP API

Browse the full API reference, then request early access — tell us what you're building and we'll get your credentials set up.

Public SDKs and a sandbox are coming soon.