Temsor API — Turkey & EU business data
Turkey & EU business data: validation, sanctions screening, parsing, FX and fuel price history
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"api": {
"url": "https://api.temsor.com/mcp"
}
}
}Remote endpoints
https://api.temsor.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (43)
⚪email_verify(email, rejectFreeProviders, rejectRoleAccounts)
Checks an e-mail address: syntax, whether the domain can actually receive mail, disposable and role-account detection, and typo correction. No SMTP probing. Most competitors connect to the target server and try RCPT TO, which sounds thorough but produces a confident-looking number you cannot trust: most servers are catch-all, the big providers refuse to answer, and doing it in bulk gets the probing IP blacklisted. We report only what is provable — whether the domain has a mail exchanger, whether it is a known disposable service, whether the mailbox belongs to a role rather than a person, and whether the domain looks like a typo of a common one (gmial.com → gmail.com). Addresses are also normalised, so Gmail dots and +tags stop creating duplicate signups.
Input Schema
{
"type": "object",
"properties": {
"email": {
"type": "string",
"minLength": 3,
"maxLength": 254,
"description": "E-mail address to check."
},
"rejectFreeProviders": {
"default": false,
"type": "boolean"
},
"rejectRoleAccounts": {
"default": false,
"type": "boolean"
}
},
"required": [
"email"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢iban_validate(iban, expectCountry)
Validates an IBAN from any of 70+ countries: checksum, country length and in-country account structure, and resolves the bank and branch codes. Most free libraries stop at the mod-97 checksum. That only says the digits are self-consistent — not that the number could exist in that country. This checks the country's BBAN structure too, so a wrong-length or wrong-shaped account is rejected before your payment file reaches the bank. When only the two check digits are wrong, the correct ones are computed and returned as a suggestion, because that is what people actually mistype. Turkish, Dutch and Belgian IBANs additionally resolve to a bank name when the national code is in our table; otherwise bankName is null. This is not a SWIFT directory.
Input Schema
{
"type": "object",
"properties": {
"iban": {
"type": "string",
"minLength": 5,
"maxLength": 42,
"description": "IBAN, with or without spaces."
},
"expectCountry": {
"description": "Expected country code (ISO 3166-1 alpha-2).",
"type": "string",
"minLength": 2,
"maxLength": 2
}
},
"required": [
"iban"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪pbx_audio_chunk(call_id, pbx_id, uri, bytes_b64, t_ms)
Notify an optional audio chunk / customer URI for a live or archived call (idle $0). Prefer customer storage URI. Temsor keeps a pointer; STT only while a call is active.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 2,
"maxLength": 64
},
"pbx_id": {
"type": "string",
"maxLength": 64
},
"uri": {
"description": "Customer-side media URI (preferred).",
"type": "string",
"format": "uri"
},
"bytes_b64": {
"description": "Optional small demo chunk; production prefers URI.",
"type": "string",
"maxLength": 200000
},
"t_ms": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_calls(limit)
List recent calls with transfer path crumbs — site + customer archive browser. GET /v1/pbx/calls?limit=20. Scoped by x-temsor-pbx-key when set. Idle $0. No DID sales.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"default": 20,
"description": "Max recent calls to return (1–100).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_calls_get(call_id)
Get one call by id with transfer graph — customer detail drawer. GET /v1/pbx/calls/get?call_id=…. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Call id (e.g. call_msp_002)."
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_calls_graph(call_id, stuck_at)
Handoff graph + transfer edges — who→whom→where the promise stuck (moat). Idle $0. GET /v1/pbx/calls/graph?call_id=…&stuck_at=310. Returns path, path_tr (plain-language summary), edges, and raw transfers. Compounding asset for search/orchestration: handoff edges, not a bot transcript. Idle $0. No DID sales / no live PSTN.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Call id whose transfer graph to return."
},
"stuck_at": {
"description": "Optional override for where the promise stuck (extension).",
"type": "string",
"maxLength": 16
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_dictionary(domain)
Managed SaaS domain dictionary (E4) — example packs thicken per pilot (tenant-scoped aliases). Boosts search + Fact extract. No invented premiums. GET /v1/pbx/dictionary?domain=hotel|pbx_provider|insurance|finance|energy|automotive|all (legacy otel|santral_firmasi|sigorta|finans|enerji|otomotiv|msp still accepted). Idle $0, no LLM. Synonyms feed archive search (match crumbs) and transcript Fact extraction. Write path: POST /v1/pbx/dictionary/add.
Input Schema
{
"type": "object",
"properties": {
"domain": {
"default": "all",
"description": "Domain slice: hotel | pbx_provider | insurance | finance | energy | automotive | all (legacy keys + msp accepted)",
"type": "string",
"enum": [
"hotel",
"pbx_provider",
"insurance",
"finance",
"energy",
"automotive",
"otel",
"santral_firmasi",
"sigorta",
"finans",
"enerji",
"otomotiv",
"msp",
"all"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_dictionary_add(term, alias, domain, kind, boost, ...)
Add a synonym/alias (tenant-scoped or global demo) — E4 compounding thickens search boost + Fact extract. ≤60/hour/key → 429. Idle $0. No invented premiums. POST /v1/pbx/dictionary/add {term, alias, domain:hotel|pbx_provider|insurance|finance|energy|automotive, scope?:pbx|global}. Managed SaaS compounding (E4): tenant-scoped aliases thicken search + fact extract. No invented premiums/prices. Idle $0, no LLM. Legacy keys (otel, santral_firmasi, msp…) still accepted.
Input Schema
{
"type": "object",
"properties": {
"term": {
"type": "string",
"minLength": 2,
"maxLength": 64,
"description": "Canonical term (e.g. AC, tariff). Plain Turkish preferred."
},
"alias": {
"type": "string",
"minLength": 2,
"maxLength": 64,
"description": "Synonym / alias to add (e.g. cooling, line package)."
},
"domain": {
"default": "hotel",
"description": "Domain: hotel | pbx_provider | insurance | finance | energy | automotive (legacy keys + msp accepted).",
"type": "string",
"enum": [
"hotel",
"pbx_provider",
"insurance",
"finance",
"energy",
"automotive",
"otel",
"santral_firmasi",
"sigorta",
"finans",
"enerji",
"otomotiv",
"msp"
]
},
"kind": {
"description": "Fact kind; inferred from seed term when omitted.",
"type": "string",
"enum": [
"imei",
"tarife",
"oda",
"oda_tipi",
"klima",
"check_out",
"iade",
"sku",
"police",
"hasar",
"yenileme",
"abone",
"kesinti",
"fatura",
"kart",
"iban",
"sube",
"other"
]
},
"boost": {
"description": "Search boost weight (default 2).",
"type": "number",
"minimum": 1,
"maximum": 5
},
"scope": {
"description": "pbx = scoped to x-temsor-pbx-key; global = demo-wide. Default: pbx if registered key, else global.",
"type": "string",
"enum": [
"pbx",
"global"
]
},
"hint_tr": {
"type": "string",
"maxLength": 160
},
"hint_en": {
"type": "string",
"maxLength": 160
}
},
"required": [
"term",
"alias"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪pbx_events(pbx_id, events)
Ingest call-ops events → open promises + transfer crumbs for search/orchestration. Optional HMAC. Idle $0 when no calls. Demo stores events in memory/file. Auth: omit, x-temsor-pbx-key, or x-temsor-signature = hex(HMAC-SHA256(api_key, body)); bad signature rejected when header present. BridgeEnter → transfer/handoff crumbs. Utterance/text → open Promise docs via heuristic (no LLM). Idle $0. Body ≤256 KiB → 429. Advanced: ARI/Stasis batch shape when customer runs own PBX — not Asterisk-first product copy.
Input Schema
{
"type": "object",
"properties": {
"pbx_id": {
"description": "PBX id that emitted the ARI batch.",
"type": "string",
"minLength": 2,
"maxLength": 64
},
"events": {
"minItems": 1,
"maxItems": 200,
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "ARI / Stasis event batch. Utterance/text fields trigger heuristic promise extract."
}
},
"required": [
"events"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_facts(call_id, kind, domain, q, limit)
List extracted facts (IMEI, room, tariff…) from the durable index — filter by call_id, kind, domain, q. GET /v1/pbx/facts?call_id=&kind=&domain=hotel|pbx_provider|insurance|finance|energy|automotive|all&q=&limit=50. Facts come from transcript extract + domain dictionary; persist in pbx-index. Scoped by x-temsor-pbx-key. Idle $0. No DID sales. Right-to-erasure ready. Advanced: own PBX/Asterisk stays on customer.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"description": "Filter by call id (e.g. call_msp_001).",
"type": "string",
"maxLength": 80
},
"kind": {
"description": "Fact kind key (imei, oda, tarife, ...) or all.",
"type": "string",
"maxLength": 32
},
"domain": {
"description": "Domain slice: hotel | pbx_provider | insurance | finance | energy | automotive | all (legacy keys + msp accepted).",
"type": "string",
"enum": [
"hotel",
"pbx_provider",
"insurance",
"finance",
"energy",
"automotive",
"otel",
"santral_firmasi",
"sigorta",
"finans",
"enerji",
"otomotiv",
"msp",
"all"
]
},
"q": {
"description": "Free-text filter over kind + value + call_id.",
"type": "string",
"maxLength": 200
},
"limit": {
"default": 50,
"description": "Max facts to return (1–200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_facts_get(id)
Get one extracted fact by id — detail drawer for site + customer. GET /v1/pbx/facts/get?id=…. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0. No DID sales.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Fact id (e.g. fact_001)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_index_partial(call_id, text, speaker, t_ms, is_final, ...)
Upsert mid-call partial index (utterances → fact/promise hints). Path to ≤400ms whisper; ≤600/hour/key → 429; idle $0. POST /v1/pbx/index/partial {call_id, text?, speaker?, t_ms?, is_final?, live?, end_call?, promote?}. Streams partial STT queue into accumulating Fact/Promise hints while the call is live. No Temsor STT/LLM — customer posts text. Managed SaaS in-call index; no DID sales. Own PBX optional footnote. Idle $0.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Live call id to upsert partial index for."
},
"text": {
"description": "Partial utterance / snippet (customer STT or demo). Empty = metadata-only.",
"type": "string",
"maxLength": 2000
},
"speaker": {
"anyOf": [
{
"type": "string",
"maxLength": 64
},
{
"type": "null"
}
]
},
"t_ms": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 86400000
},
{
"type": "null"
}
]
},
"is_final": {
"description": "Finalized utterance span (vs interim).",
"type": "boolean"
},
"live": {
"description": "Default true while call is live.",
"type": "boolean"
},
"end_call": {
"description": "Mark live=false; idle $0 for this call.",
"type": "boolean"
},
"promote": {
"description": "Promote heuristic hints into durable Promise/Fact docs.",
"type": "boolean"
},
"pbx_id": {
"type": "string",
"maxLength": 64
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_index_partial_get(call_id)
GET mid-call partial index — accumulating facts/promises/snippets while live. GET /v1/pbx/index/partial/get?call_id=…. Returns live partial state for whisper ≤400ms path. Idle $0 when no live call. Managed SaaS in-call index; no DID sales. Own PBX optional footnote.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Call id whose live partial index to read."
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_ingest_transcript(transcript, call_id, pbx_id, who, ext, ...)
Heuristic promise extractor from transcript text — creates open Promise docs (idle $0, no LLM). Detects promise-like sentences (we will, I promise, refund, cancel, call you back, tomorrow…). Optional persist_promises=false for extract without writing. Also wired via utterance text on POST /v1/pbx/events.
Input Schema
{
"type": "object",
"properties": {
"transcript": {
"type": "string",
"minLength": 1,
"maxLength": 50000,
"description": "TR utterance / transcript text to scan for promises."
},
"call_id": {
"type": "string",
"maxLength": 64
},
"pbx_id": {
"type": "string",
"maxLength": 64
},
"who": {
"type": "string",
"maxLength": 120
},
"ext": {
"type": "string",
"maxLength": 16
},
"persist_promises": {
"default": true,
"description": "When false, extract only (dry-run, no write). When true, create Promise docs status=open.",
"type": "boolean"
}
},
"required": [
"transcript"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_persons(call_id, kind, q, include_extensions, limit)
Light CRM from call graph / facts — caller phones+names and extension identities seen on transfers. GET /v1/pbx/persons?call_id=&kind=caller|extension|all&q=&limit=50. Durable Person rows from pbx-index plus derived extension identities (ext_NNN) from Transfer edges / promise.ext. Scoped by x-temsor-pbx-key. Idle $0. No DID sales. Right-to-erasure ready. Advanced: own PBX/Asterisk stays on customer.
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"description": "Filter persons seen on this call id.",
"type": "string",
"maxLength": 80
},
"kind": {
"description": "caller = durable Person; extension = derived from call-graph hops; all = both.",
"type": "string",
"enum": [
"caller",
"extension",
"all"
]
},
"q": {
"description": "Free-text over names, phones, org, extensions, facts.",
"type": "string",
"maxLength": 200
},
"include_extensions": {
"description": "Include derived extension identities (default true).",
"type": "boolean"
},
"limit": {
"default": 50,
"description": "Max persons to return (1–200).",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_persons_get(id)
Get one light-CRM identity by id — caller Person or derived extension. GET /v1/pbx/persons/get?id=per_001|ext_101. Scoped by x-temsor-pbx-key. found=false if missing. Idle $0. No DID sales.
Input Schema
{
"type": "object",
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "Person id (e.g. per_001) or extension id (e.g. ext_101)."
}
},
"required": [
"id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_promises(status)
List open/broken call promises for agent handoff tracking — hotel / MSP sales demo. Idle $0. GET /v1/pbx/promises?status=open returns open/unclosed promises with transfer/handoff path for orchestration. Scoped by x-temsor-pbx-key when set. Idle $0. No live PSTN.
Input Schema
{
"type": "object",
"properties": {
"status": {
"default": "open",
"description": "Promise status filter; closed = kept|broken. Sales demo uses open.",
"type": "string",
"enum": [
"open",
"kept",
"broken",
"unknown",
"all",
"closed"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_promises_act(promise_id, action, agent_ext, skip_forward, stasis_webhook_url, ...)
E1 moat: who→whom→promise → orchestra handoff intent (whisper/transfer/hold). Idle $0. No live PSTN. Own PBX = advanced footnote. POST /v1/pbx/promises/act {promise_id, action?}. Loads the promise + call graph, suggests whisper/transfer/hold, records orchestra intent with source_type=promise for agent handoff. Managed SaaS runtime. ≤120/hour/key (shares orchestra bucket). Idle $0. carrier/pstn always false. No cross-tenant graph merge. Advanced: not Asterisk-first glue; own PBX optional footnote.
Input Schema
{
"type": "object",
"properties": {
"promise_id": {
"type": "string",
"minLength": 2,
"maxLength": 64,
"description": "Open (or any) promise id — closed loop reads call graph then records orchestra intent."
},
"action": {
"description": "Default whisper. transfer uses graph stuck_at / promise.ext.",
"type": "string",
"enum": [
"whisper",
"hold",
"transfer",
"pci_stop",
"snoop"
]
},
"agent_ext": {
"type": "string",
"maxLength": 64
},
"skip_forward": {
"description": "Default true — record intent only.",
"type": "boolean"
},
"stasis_webhook_url": {
"type": "string",
"maxLength": 500
},
"pbx_id": {
"type": "string",
"maxLength": 64
}
},
"required": [
"promise_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_promises_close(promise_id, status, note)
Mark an open promise kept or broken with an optional privacy-safe note — makes the sales demo writable, not read-only. ≤60/hour/key → 429. POST /v1/pbx/promises/close {promise_id, status:kept|broken, note?}. Phones/emails in note are scrubbed. Scoped by x-temsor-pbx-key when set. Idle $0 — no LLM/PSTN.
Input Schema
{
"type": "object",
"properties": {
"promise_id": {
"type": "string",
"minLength": 2,
"maxLength": 64,
"description": "Promise id (prm_*). Sales demo marks open promises kept|broken."
},
"status": {
"type": "string",
"enum": [
"kept",
"broken"
],
"description": "Close outcome: kept (honoured) or broken (not kept)."
},
"note": {
"description": "Optional short operator note. Phones/emails stripped (privacy-safe).",
"type": "string",
"maxLength": 200
}
},
"required": [
"promise_id",
"status"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_promises_export(status, format)
Export open/broken promises as CSV or JSON — hotel / PBX-provider unclosed-promise sales list. GET /v1/pbx/promises/export?status=open|closed&format=csv|json. CSV/JSON include closed_at, close_note, path crumbs. Scoped by x-temsor-pbx-key when set. Idle $0.
Input Schema
{
"type": "object",
"properties": {
"status": {
"default": "open",
"description": "Promise status filter; closed = kept|broken. Sales demo uses open.",
"type": "string",
"enum": [
"open",
"kept",
"broken",
"unknown",
"all",
"closed"
]
},
"format": {
"default": "csv",
"description": "Export format.",
"type": "string",
"enum": [
"csv",
"json"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_promises_reopen(promise_id)
Undo a kept/broken close — restore an open promise so the sales demo can reverse a mis-click. ≤60/hour/key → 429. POST /v1/pbx/promises/reopen {promise_id}. Only kept|broken → open; clears closed_at/close_note. Scoped by x-temsor-pbx-key when set. Idle $0.
Input Schema
{
"type": "object",
"properties": {
"promise_id": {
"type": "string",
"minLength": 2,
"maxLength": 64,
"description": "Promise id (prm_*). Undo a kept|broken close — restore open."
}
},
"required": [
"promise_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴pbx_redact(target_type, target_id, phone, reason, mode, ...)
Privacy-first erasure (default-on SaaS): clear derived index by id/phone; durable audit who/what/when + tenant scope. ≤30/hour/key → 429. Managed pointer only — not a legal deletion SLA. E.3 Privacy-first redaction for managed SaaS. mode=anonymize|delete. Lookup by target_id or phone. Clears Person/Promise/Fact/partial index + Temsor audio pointers in your tenant only (no cross-tenant). Durable audit. Raw media stays on your side. Not a legal deletion SLA. List: GET /v1/pbx/redact/audit.
Input Schema
{
"type": "object",
"properties": {
"target_type": {
"description": "Index document type. Optional when `phone` is set.",
"type": "string",
"enum": [
"promise",
"call",
"person",
"fact",
"utterance"
]
},
"target_id": {
"description": "Document id (prm_*, per_*, call_*, fact_*).",
"type": "string",
"minLength": 2,
"maxLength": 64
},
"phone": {
"description": "Caller phone — finds Person phones (+ linked derived index).",
"type": "string",
"minLength": 7,
"maxLength": 32
},
"reason": {
"description": "Personal-data erasure reason.",
"type": "string",
"maxLength": 200
},
"mode": {
"description": "anonymize (default) scrubs fields; delete removes docs.",
"type": "string",
"enum": [
"anonymize",
"delete"
]
},
"who": {
"description": "Actor label for durable audit (defaults to pbx scope / demo-operator).",
"type": "string",
"maxLength": 80
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_redact_audit(limit)
List recent erasure actions — who/what/when + tenant scope. Managed SaaS derived-index audit; not a legal deletion SLA. GET /v1/pbx/redact/audit?limit=20. Durable audit from POST /v1/pbx/redact (E.3). Tenant-scoped. Derived index cleared; raw media not deleted by Temsor. Number→flow managed SaaS; own PBX optional. No DID sales.
Input Schema
{
"type": "object",
"properties": {
"limit": {
"description": "Max recent forget actions to return (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_register(pbx_id, label, ari_webhook_secret, name, email, ...)
Register a pilot PBX; returns pbx_id + API key once (hashed at rest). ≤5/hour/IP → 429. Idle $0. Control-plane register. API key shown once; stored hashed at rest. Send x-temsor-pbx-key to scope GET /v1/pbx/promises to this pbx_id. No speech recognition while idle.
Input Schema
{
"type": "object",
"properties": {
"pbx_id": {
"description": "Pilot PBX id; auto-minted if omitted.",
"type": "string",
"minLength": 2,
"maxLength": 64
},
"label": {
"description": "Human label, e.g. hotel or PBX/IT provider site.",
"type": "string",
"maxLength": 120
},
"ari_webhook_secret": {
"description": "ARI webhook signing secret (stored as hint only).",
"type": "string",
"maxLength": 200
},
"name": {
"description": "Pilot contact name (waitlist / register).",
"type": "string",
"maxLength": 120
},
"email": {
"description": "Pilot contact email.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"webhook_url": {
"description": "Optional outbound webhook URL — Temsor POSTs promise/fact/orchestra/redact events.",
"type": "string",
"maxLength": 500,
"format": "uri"
},
"webhook_secret": {
"description": "Optional HMAC secret for outbound webhook signatures (x-temsor-signature).",
"type": "string",
"maxLength": 200
},
"webhook_events": {
"description": "Event list or comma string: promise.opened|closed, fact.extracted, orchestra.act, redact, or *.",
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_search(q, status, ext, competitor, date_from, ...)
Agent archive search over call promises and facts — voice-Google for call-ops, not a receptionist bot. Idle $0. Demo index + domain dictionary v0. Filters: status, date, ext, competitor, stuck_after (transfer/handoff hop). Returns call-graph path + transfer edges for orchestration. Idle $0. No live PSTN.
Input Schema
{
"type": "object",
"properties": {
"q": {
"default": "",
"description": "Full-text query over promises, facts, and call summaries.",
"type": "string",
"maxLength": 200
},
"status": {
"type": "string",
"enum": [
"open",
"kept",
"broken",
"unknown"
]
},
"ext": {
"type": "string",
"maxLength": 16
},
"competitor": {
"type": "string",
"maxLength": 64
},
"date_from": {
"description": "ISO date/time lower bound (promise.when_iso / call.started_at).",
"type": "string",
"maxLength": 40
},
"date_to": {
"description": "ISO date/time upper bound.",
"type": "string",
"maxLength": 40
},
"stuck_after": {
"description": "Filter: promise stuck after transfer to this extension (to_ext hop).",
"type": "string",
"maxLength": 16
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_status
Control-plane status — promise/orchestra/search counts + idle $0. No DID sales. GET /v1/pbx/status. Scoped by x-temsor-pbx-key when set. Derived index on Temsor for agent search/orchestration. Idle $0. Advanced: own PBX/Asterisk stays on customer.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "No input — scoped by x-temsor-pbx-key when set."
}🟡pbx_webhooks(url, secret, events, ping, webhook_id, ...)
Register or list outbound webhooks — customer URL receives promise/fact/orchestra/redact events (HMAC if secret). POST write ≤30/hour/key → 429. POST /v1/pbx/webhooks {url, secret?, events?, ping?} registers. GET lists. ping:true sends a test delivery. Events: promise.opened, promise.closed, fact.extracted, orchestra.act, redact. Signed with x-temsor-signature when secret set. Idle $0. No DID sales. Erasure-aware. Advanced: own PBX/Asterisk stays on customer.
Input Schema
{
"type": "object",
"properties": {
"url": {
"description": "Outbound webhook URL (http/https). Present → register; omit on GET → list.",
"type": "string",
"maxLength": 500
},
"secret": {
"description": "Optional HMAC-SHA256 secret → x-temsor-signature: sha256=<hex>.",
"type": "string",
"maxLength": 200
},
"events": {
"description": "Events: promise.opened|closed, fact.extracted, orchestra.act, redact, or *.",
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "string"
}
]
},
"ping": {
"description": "If true with url → register then ping; if true without url → ping existing.",
"type": "boolean"
},
"webhook_id": {
"description": "For ping: target webhook id.",
"type": "string",
"maxLength": 64
},
"limit": {
"description": "List limit (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢pbx_webhooks_deliveries(webhook_id, limit)
List last N outbound webhook deliveries (stub or live) — promise/fact/orchestra/redact/ping. GET /v1/pbx/webhooks/deliveries?limit=20&webhook_id=. Durable log of Temsor→customer POSTs. HMAC when secret set. Idle $0. No DID sales. Erasure-aware. Advanced: own PBX/Asterisk stays on customer.
Input Schema
{
"type": "object",
"properties": {
"webhook_id": {
"description": "Filter by webhook id.",
"type": "string",
"maxLength": 64
},
"limit": {
"description": "Max deliveries (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡pbx_whisper_status
Capability: mode=stub|ready from TEMSOR_RTP_*. No live RTP on forge; idle $0. GET /v1/pbx/whisper/status. Reports MediaBridge config presence (TEMSOR_RTP_PATH). mode=ready means path env set — not that Asterisk RTP is flowing. live_rtp/listening always false on forge (R2–R3 IVR sidecar; R4 lab E2E harness). No ≤400ms production claim. TEMSOR_RTP_LAB=1 → optional lab_latency_ms on suggest. No DID sales.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"description": "No input — TEMSOR_RTP_* from process env."
}🟡pbx_whisper_suggest(call_id, partial_text)
Live agent handoff cards (≤3): open promises/facts from in-call index. Idle $0. Lab: TEMSOR_RTP_LAB=1 → lab_latency_ms. POST /v1/pbx/whisper/suggest {call_id, partial_text}. Returns open promises and facts as whisper cards for agent handoff. Prefers in-call partial index when present. Mock latency_ms under 400ms (compat stub). Idle $0. No Telnyx/DID/live PSTN. Advanced: optional lab_latency_ms when TEMSOR_RTP_LAB=1 (measured; not prod SLA).
Input Schema
{
"type": "object",
"properties": {
"call_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Active call id for agent UI context."
},
"partial_text": {
"default": "",
"description": "Partial transcript / utterance text (no live speech recognition).",
"type": "string",
"maxLength": 2000
}
},
"required": [
"call_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪phone_validate(phone, defaultCountry)
Validates and normalises any phone number to E.164, with structural checks for every country calling code. For signup and checkout flows that need to store one canonical form and reject typos early. Any common input (spaces, dashes, brackets, 00 or + prefix, a stray national trunk zero) comes back as E.164 plus national notation, with the country resolved from the calling code. Numbers without an international prefix use `defaultCountry` (US when omitted), so (415) 555-0134 and +1 415 555 0134 store the same. One thing this endpoint deliberately does not claim: the current mobile operator. Numbers are portable in most markets, so a prefix says where a number was first allocated, not where it lives today. Competing APIs report the prefix owner as "the operator" and customers pick SMS routes on that basis. Where we know the original allocation we return it as `originallyAllocatedTo` with the caveat attached, because a confident wrong answer costs more than an honest gap. Countries without a full numbering plan here are validated structurally and say so in `warnings`.
Input Schema
{
"type": "object",
"properties": {
"phone": {
"type": "string",
"minLength": 4,
"maxLength": 30,
"description": "Phone number in any common format."
},
"defaultCountry": {
"description": "ISO 3166-1 alpha-2 country to assume when the number has no international prefix. Defaults to US.",
"type": "string",
"minLength": 2,
"maxLength": 2
}
},
"required": [
"phone"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_address_parse(address, defaultProvince)
Splits a free-form Turkish address into neighbourhood, street, building, floor, flat, district, province and postcode. Handles the abbreviation chaos (Mah./Mh., Cd./Cad., Sk./Sok., No:12/5, K:3 D:7), cross-checks the province against the postcode, repairs misspelled district names against a dictionary, and returns a confidence score. Anything it could not place is listed in `unparsed` — nothing is dropped silently. Built for shipping, checkout and CRM systems that receive Turkish addresses typed by humans.
Input Schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"minLength": 3,
"maxLength": 500,
"description": "Free-text address."
},
"defaultProvince": {
"description": "Province to assume when the address has none.",
"type": "string"
}
},
"required": [
"address"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_business_days(start, addDays, end, countHalfDaysAsWork)
Adds business days or counts them between two dates, accounting for Turkish public and religious holidays including half-day eves. Ramadan and Sacrifice feasts follow the Hijri calendar and cannot be derived reliably by formula, so announced dates are read from a table; years without an official announcement are returned with `confirmed:false` rather than guessed silently. For delivery promises, SLA clocks, payment terms and shipping estimates.
Input Schema
{
"type": "object",
"properties": {
"start": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Start date (YYYY-MM-DD)."
},
"addDays": {
"description": "Add/subtract this many business days (not calendar days).",
"type": "integer",
"minimum": -3650,
"maximum": 3650
},
"end": {
"description": "If set, count business days between start and this date.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"countHalfDaysAsWork": {
"default": true,
"description": "Count Arife half-days as working days?",
"type": "boolean"
}
},
"required": [
"start"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_iban_olustur(bankCode, accountNumber, reserved)
Builds a Turkish IBAN from a 5-digit bank code and account number, computing ISO 7064 check digits. A Turkish IBAN is TR + 2 check digits + 5-digit bank code + 1 reserved digit + 16-character account. This pads the account on the left, defaults the reserved digit to 0, computes the mod-97 check digits, and resolves the bank name from the same national table used by IBAN validation when the code is known. Unknown bank codes still produce a structurally valid IBAN with bankName null — existence at the bank is not claimed.
Input Schema
{
"type": "object",
"properties": {
"bankCode": {
"type": "string",
"description": "5-digit Turkish national bank / EFT code (e.g. 00062)."
},
"accountNumber": {
"type": "string",
"description": "Account number, up to 16 alphanumeric characters (padded left with zeros)."
},
"reserved": {
"description": "Reserved BBAN digit after the bank code. Defaults to 0.",
"type": "string"
}
},
"required": [
"bankCode",
"accountNumber"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡tr_invoice_build(profile, invoiceTypeCode, id, series, sequence, ...)
Builds a UBL-TR e-Invoice or e-Archive XML document from plain JSON, computing every total and validating the parties. Selling into Türkiye means issuing a UBL-TR document whose element order is fixed by schema and whose totals must agree to the kuruş, or the integrator rejects it. This endpoint takes the invoice as ordinary JSON and returns the XML. Totals you send are ignored on purpose — line amounts, per-rate VAT subtotals and the payable amount are all recomputed here, because a rounding difference of one kuruş is the most common rejection. VKN and TCKN checksums are verified, and the amount is written out in Turkish words as invoices require. It does not sign the document and does not transmit it: the financial seal and the submission to the tax authority belong to your certificate and your integrator. What comes back is a document ready to enter that step.
Input Schema
{
"type": "object",
"properties": {
"profile": {
"default": "TEMELFATURA",
"description": "TEMELFATURA: no formal objection flow. TICARIFATURA: buyer may accept/reject. EARSIVFATURA: buyer is not an e-Invoice user.",
"type": "string",
"enum": [
"TEMELFATURA",
"TICARIFATURA",
"EARSIVFATURA"
]
},
"invoiceTypeCode": {
"default": "SATIS",
"type": "string",
"enum": [
"SATIS",
"IADE"
]
},
"id": {
"description": "Invoice number. Omit and supply `series` to have it built from the series and sequence.",
"type": "string",
"pattern": "^[A-Z]{3}[0-9]{13}$"
},
"series": {
"description": "Three-letter series code, used with `sequence`.",
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"sequence": {
"description": "Sequence number within the series and year.",
"type": "integer",
"minimum": 1,
"maximum": 999999999
},
"uuid": {
"description": "Document UUID (ETTN). Generated when omitted.",
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"issueDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"issueTime": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}:\\d{2}$"
},
"currency": {
"default": "TRY",
"description": "ISO 4217. Anything other than TRY requires `exchangeRate`.",
"type": "string",
"minLength": 3,
"maxLength": 3
},
"exchangeRate": {
"description": "Units of TRY per one unit of `currency`.",
"type": "number",
"exclusiveMinimum": 0
},
"supplier": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 2,
"maxLength": 300,
"description": "Registered trade name, or the person’s full name."
},
"taxNumber": {
"type": "string",
"minLength": 10,
"maxLength": 11,
"description": "VKN (10 digits) or, for an individual, TCKN (11 digits)."
},
"taxOffice": {
"description": "Tax office (\"vergi dairesi\"). Required for VKN holders.",
"type": "string",
"maxLength": 100
},
"street": {
"type": "string",
"maxLength": 200
},
"buildingNumber": {
"type": "string",
"maxLength": 30
},
"district": {
"description": "District.",
"type": "string",
"maxLength": 100
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 100
},
"postalCode": {
"type": "string",
"maxLength": 10
},
"country": {
"default": "Türkiye",
"type": "string",
"maxLength": 60
},
"email": {
"type": "string",
"maxLength": 120
},
"phone": {
"type": "string",
"maxLength": 40
}
},
"required": [
"name",
"taxNumber"
]
},
"customer": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 2,
"maxLength": 300,
"description": "Registered trade name, or the person’s full name."
},
"taxNumber": {
"type": "string",
"minLength": 10,
"maxLength": 11,
"description": "VKN (10 digits) or, for an individual, TCKN (11 digits)."
},
"taxOffice": {
"description": "Tax office (\"vergi dairesi\"). Required for VKN holders.",
"type": "string",
"maxLength": 100
},
"street": {
"type": "string",
"maxLength": 200
},
"buildingNumber": {
"type": "string",
"maxLength": 30
},
"district": {
"description": "District.",
"type": "string",
"maxLength": 100
},
"city": {
"description": "City.",
"type": "string",
"maxLength": 100
},
"postalCode": {
"type": "string",
"maxLength": 10
},
"country": {
"default": "Türkiye",
"type": "string",
"maxLength": 60
},
"email": {
"type": "string",
"maxLength": 120
},
"phone": {
"type": "string",
"maxLength": 40
}
},
"required": [
"name",
"taxNumber"
]
},
"lines": {
"minItems": 1,
"maxItems": 500,
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "Item or service description as it must appear on the invoice."
},
"quantity": {
"default": 1,
"type": "number",
"exclusiveMinimum": 0,
"maximum": 1000000000
},
"unitCode": {
"default": "C62",
"description": "UN/ECE unit code. C62 = piece, KGM = kg, MTR = metre, HUR = hour.",
"type": "string",
"minLength": 1,
"maxLength": 10
},
"unitPrice": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000,
"description": "Net unit price, before VAT and before the discount."
},
"vatRate": {
"default": 20,
"description": "VAT percentage, e.g. 20, 10, 1 or 0.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"discountRate": {
"default": 0,
"description": "Line discount percentage applied to the net amount.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"note": {
"type": "string",
"maxLength": 500
},
"sellerItemCode": {
"type": "string",
"maxLength": 60
},
"vatExemptionReasonCode": {
"description": "Required by the tax authority when vatRate is 0.",
"type": "string",
"maxLength": 10
}
},
"required": [
"name",
"unitPrice"
]
}
},
"notes": {
"default": [],
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"maxLength": 1000
}
},
"amountInWords": {
"default": true,
"description": "Adds the payable amount written out in Turkish words as a note, the way invoices require.",
"type": "boolean"
},
"despatchDocumentId": {
"description": "Delivery note number, if the goods shipped separately.",
"type": "string",
"maxLength": 50
},
"orderReferenceId": {
"type": "string",
"maxLength": 50
}
},
"required": [
"issueDate",
"supplier",
"customer",
"lines"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_invoice_parse(xml)
Turns a UBL-TR e-Invoice or e-Archive XML document into clean JSON: parties, line items, taxes and totals. Works regardless of the namespace prefix the sender used (cbc:, cac:, ns0:), normalises single-line documents into arrays, and reports amount mismatches in `warnings` instead of returning quietly wrong totals. The job that costs accounting and expense software the most engineering time.
Input Schema
{
"type": "object",
"properties": {
"xml": {
"type": "string",
"minLength": 20,
"maxLength": 4000000,
"description": "UBL-TR e-Invoice / e-Archive (e-Arsiv) XML body."
}
},
"required": [
"xml"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪tr_labor(startDate, endDate, monthlyGross, asOf, age, ...)
Computes Turkish severance (kıdem), notice (ihbar) and annual-leave entitlement from service dates and the gross wage, using the official ceiling and minimum-wage tables for the given day. Payroll and HR tools in Turkey chase a parameter that changes every January and July: the severance ceiling, the SGK cap, the minimum wage. This endpoint applies the statutory formulae (Labour Law 4857 arts. 17 and 53, former 1475 art. 14) to those tables. The ceiling is applied to the monthly wage, not the total. Stamp tax (0.759%) is deducted from severance; income tax is not — kıdem is exempt. Notice pay IS taxable; we return the gross and say so, because the actual withholding depends on the employee's cumulative tax base. What this will not tell you: whether the employee is entitled to severance at all. That depends on the reason for termination (retirement, just cause, marriage, military service…). Treating the number as "what is owed" is how you lose at trial.
Input Schema
{
"type": "object",
"properties": {
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Employment start date (YYYY-MM-DD)."
},
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Termination date (YYYY-MM-DD). Inclusive of this day."
},
"monthlyGross": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10000000,
"description": "Gross monthly wage the severance is based on (giydirilmiş brüt)."
},
"asOf": {
"description": "Rate table date. Defaults to endDate.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"age": {
"description": "Employee age at termination — affects annual-leave entitlement (under 18 or 50+).",
"type": "integer",
"minimum": 15,
"maximum": 90
},
"unusedLeaveDays": {
"description": "Unused annual-leave days, if you also want the unused-leave gross.",
"type": "number",
"minimum": 0,
"maximum": 400
}
},
"required": [
"startDate",
"endDate",
"monthlyGross"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_money_to_words(amount, currency, style, wrapHash)
Writes a monetary amount out in Turkish words, the way invoices, cheques and promissory notes require. Applies the rules that trip up generic libraries: Turkish says "bin", never "bir bin"; the kuruş part is read separately; and both "1.234,56" and "1,234.56" are accepted and told apart automatically. A mandatory field on Turkish e-invoices, cheques and notes — with no off-the-shelf API until now.
Input Schema
{
"type": "object",
"properties": {
"amount": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
],
"description": "Amount. Accepts both \"1.234,56\" and 1234.56."
},
"currency": {
"default": "TRY",
"type": "string",
"enum": [
"TRY",
"USD",
"EUR",
"GBP"
]
},
"style": {
"default": "lower",
"description": "Output letter case.",
"type": "string",
"enum": [
"lower",
"title",
"upper"
]
},
"wrapHash": {
"default": false,
"type": "boolean"
}
},
"required": [
"amount"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪tr_posta_kodu(postalCode)
Validates a 5-digit Turkish postal code and resolves the province from the first two digits (plate map). PTT postal codes are five digits; the leading pair matches the province plate code for the 81 provinces. This endpoint checks the shape, maps 01–81 to the province name, and returns null with confidence none when the prefix is outside that range — it does not invent a district. District-level resolution needs the full PTT directory and is out of scope here.
Input Schema
{
"type": "object",
"properties": {
"postalCode": {
"type": "string",
"minLength": 3,
"maxLength": 10,
"description": "Turkish 5-digit postal code, with or without spaces."
}
},
"required": [
"postalCode"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟡tr_qr_odeme(iban, name, amount, explanation, currency, ...)
Builds a person-to-person TR Karekod (FAST) payment payload from IBAN, name and optional TRY amount. Text only — no PNG. Turkish instant payments (FAST) can start from a TR Karekod that encodes the payee IBAN and name in EMV-style TLV. This builds the person-to-person organisation (payload format indicator 750210): application template with IBAN, payee name, optional 12-digit kuruş amount, optional free-text explanation, and a CRC-16/CCITT-FALSE trailer. The Turkish IBAN is normalised and checked with ISO 7064 mod-97; non-TR IBANs and non-TRY currencies are rejected. This does not send money and does not render a QR image.
Input Schema
{
"type": "object",
"properties": {
"iban": {
"type": "string",
"description": "Beneficiary Turkish IBAN (with or without spaces)."
},
"name": {
"type": "string",
"description": "Payee name shown to the payer (2–26 chars after trim)."
},
"amount": {
"description": "TRY amount; omitted → static QR (payer enters amount).",
"type": "number"
},
"explanation": {
"description": "Optional remittance note (application free field 10).",
"type": "string"
},
"currency": {
"description": "Must be TRY if provided.",
"type": "string"
},
"generatorCode": {
"description": "QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code.",
"type": "string"
}
},
"required": [
"iban",
"name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_tebligat_clock(type, lawFamily, basisDate, periodDays, periodType, ...)
Computes the deemed-received date and the HMK deadline (with holiday shifting) for a Turkish notification, from the date the underlying event actually happened. Turkish notification law (7201) ties the deadline clock to an event that is not "the date on the letter" — for electronic notification the UETS platform reports send, read AND reached dates, and only the reached date starts the clock (art. 7/a: deemed received 5 calendar days after reaching the address, whether or not it was opened). HMK adds two more rules on top: the day of notification itself does not count (art. 92 — the period starts the next day) and if the computed last day lands on a weekend or a full public/religious holiday, it moves to the next business day (art. 93); a half-day eve (arife) does not shift it. What this will not tell you: whether the notification was itself valid, or what a specific `periodType` (itiraz, temyiz, cevap…) is in days for your case — that number differs by statute and we do not guess it; supply `periodDays` yourself. Only the "hmk" law family is covered so far.
Input Schema
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"electronic",
"physical",
"vekil",
"ilanen",
"last_known_address"
],
"description": "Notification method. Determines which event `basisDate` refers to and whether the deemed-received date is same-day or shifted."
},
"lawFamily": {
"type": "string",
"enum": [
"hmk"
],
"description": "Body of procedural law the period is computed under. Only \"hmk\" (Code of Civil Procedure) is supported so far."
},
"basisDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date `basisLabel` describes for this type — for \"electronic\" this is the date UETS reports the message as reached, not sent or read."
},
"periodDays": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 3650,
"description": "Length of the statutory or judicial period, in days, counted from `periodStart`."
},
"periodType": {
"description": "Free-text label for the period (e.g. \"itiraz\", \"temyiz\"), echoed back only — not mapped to a day count.",
"type": "string",
"maxLength": 120
},
"ilanenDeemedDays": {
"description": "Only valid with type \"ilanen\": number of days the competent authority set for the notice to become deemed received (TK 31), 7-15, default 7. Not the number of days for the underlying period.",
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"hasAttorney": {
"description": "Whether the addressee has a registered attorney of record. When true and `type` is not \"vekil\", a TK 11 warning is added noting that service should have gone to the attorney.",
"type": "boolean"
},
"subjectToJudicialRecess": {
"description": "Whether this matter is subject to the judicial recess (adli tatil, HMK 104) instead of being exempt. Only affects the result when `lawFamily` is \"hmk\" and the computed last day falls in the 20 July - 31 August window.",
"type": "boolean"
}
},
"required": [
"type",
"lawFamily",
"basisDate",
"periodDays"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}⚪tr_validate(value, type)
Validates Turkish national ID, tax number, IBAN, licence plate, IMEI, barcodes, KEP, MERSİS, postal code and ISBN from one endpoint, with type auto-detection. Goes past a yes/no: resolves the bank behind an IBAN, the province behind a licence plate and the GS1 country prefix behind a barcode. Pure local computation — no upstream service is called, so latency is microseconds and the answer never changes for the same input.
Input Schema
{
"type": "object",
"properties": {
"value": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"description": "Value to validate."
},
"type": {
"default": "auto",
"description": "Omitted → inferred from the format.",
"type": "string",
"enum": [
"auto",
"tckn",
"vkn",
"iban",
"plate",
"imei",
"gtin",
"kep",
"mersis",
"postal",
"isbn"
]
}
},
"required": [
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢tr_vat(amount, amountIncludesVat, rate, withholding)
Splits a Turkish amount into net, VAT and (optionally) withholding: who pays the seller, who remits the withheld VAT. For invoice lines and checkout totals that have to show KDV dahil / hariç and, when the parties are in a withholding (tevkifat) situation, the split between what the buyer pays the seller and what the buyer remits to the tax office. Rates are 0, 1, 10 and 20 percent. Withholding is a fraction of the VAT (2/10 through 10/10), or a named code from the GİB partial-withholding list. The 2026 threshold (TRY 12,000 gross) is reported and compared with the amount, but `applies` is always null: whether withholding actually applies depends on the taxpayer status of both parties, which this endpoint does not know. Feeding it a fraction is not a legal opinion.
Input Schema
{
"type": "object",
"properties": {
"amount": {
"type": "number",
"minimum": 0,
"maximum": 1000000000000,
"description": "The amount to tax. See amountIncludesVat."
},
"amountIncludesVat": {
"default": false,
"description": "If true, `amount` is the gross (KDV dahil); if false, it is the net/matrah.",
"type": "boolean"
},
"rate": {
"default": 20,
"description": "VAT rate in percent. 0, 1, 10 or 20.",
"anyOf": [
{
"type": "number",
"const": 0
},
{
"type": "number",
"const": 1
},
{
"type": "number",
"const": 10
},
{
"type": "number",
"const": 20
}
]
},
"withholding": {
"description": "Withholding fraction such as \"5/10\", or a code from the list (reklam, tasima, hurda, isgucu…).",
"type": "string"
}
},
"required": [
"amount"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence