- Verify any Turkish taxpayer by VKN (10 digits) or TCKN (11 digits) against the GİB record
- Title, company type, tax office and taxpayer status in one card
- Registered addresses and NACE activity codes where available
- Invalid or unknown numbers are never charged
- Self-service prepaid billing — repeat queries served from cache free of charge
Türmob Taxpayer Card (GİB) API
Official Turkish taxpayer (GİB¹) record by tax number as a prepaid, per-query priced REST API: title, tax office, status, addresses and NACE activities via TÜRMOB.
¹ GİB: Turkish Revenue Administration
What you can do
Use cases
- Taxpayer verification at invoice time — Confirm that the VKN or TCKN on an incoming or outgoing invoice belongs to an active GİB taxpayer with the exact registered title and tax office before the document is booked.
- Customer master-data hygiene — Normalise the legal title, company type and tax office of every Turkish account in your CRM or ERP from the official record instead of free-text entry.
- Supplier onboarding for accounting firms — Accountants and SMMM offices check new clients and their counterparties in one call — registered addresses and NACE activity codes included where available.
Apivom Atlas resells the official TÜRMOB taxpayer lookup as a modern REST API. Query any Turkish tax number or citizen ID and receive the GİB taxpayer record — title, company type, tax office, status, registered addresses and NACE activities — in a single card at a single price. Responses are cached server-side (repeat queries are free), invalid or unknown numbers are not charged, and every query is logged with full request/response payloads in the customer portal.
Code sample
Replace YOUR_KEY with the API key issued in Apivom Atlas and run it from your backend.
curl -X POST https://atlas.apivom.com/one/api/ext/turmob/v1/query/taxpayer-card \
-H "x-api-key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"vknTckn":"1234567890"}'Per-tenant API key (x-api-key header) issued in the Apivom Atlas portal. Prepaid balance; only data-returning queries are charged.
Frequently asked questions
Does the card work for individuals as well as companies?
Yes. Pass a 10-digit tax number (VKN) for legal entities or an 11-digit citizen ID (TCKN) for sole traders and individuals; the GİB record is returned in the same card structure.
What happens with an invalid or unknown number?
Invalid or unregistered numbers return no record and are not charged. Repeat queries for the same number are served from the cache free of charge.
How is the API billed?
Prepaid and per query: you top up a balance in Apivom Atlas and each successful query debits the route price shown there. Identical repeat queries are served from the server-side cache free of charge ("cached": true in the response); add ?force=true to refresh at the route price. HTTP 402 means the balance needs a top-up.
How do I authenticate and where do I see my usage?
Every request carries your tenant API key in the x-api-key header; keys are issued and rotated in Apivom Atlas. The portal logs every query with the full request and response payload, so finance and engineering share one audit trail.
More Atlas integrations
AI integration guide (llms.txt)
Machine-readable markdown — feed it to your AI assistant as integration instructions.