Servers Playground How we check Add a server Log in

Temsor API — Turkey & EU business data

Working · 2.8 s

com.temsor/apiv1.0.0 Domain verified

Turkey & EU business data: validation, sanctions screening, parsing, FX and fuel price history

Communication Sales & CRM

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.temsor.com/mcp

Authorization (optional)

Bearer <API key>. Optional: without it, calls run on a narrow per-IP demo quota so the tools can be evaluated immediately.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

email_verify

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.

emailstring, required

E-mail address to check.

rejectRoleAccountsboolean

rejectFreeProvidersboolean

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Temsor API — Turkey & EU business data MCP server | mcptry

Temsor API — Turkey & EU business data

Working · 2.8 s

com.temsor/apiv1.0.0 Domain verified

Turkey & EU business data: validation, sanctions screening, parsing, FX and fuel price history

Communication Sales & CRM

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.temsor.com/mcp

Authorization (optional)

Bearer <API key>. Optional: without it, calls run on a narrow per-IP demo quota so the tools can be evaluated immediately.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

email_verify

emailstring, required

E-mail address to check.

rejectRoleAccountsboolean

rejectFreeProvidersboolean

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (43)

email_verify

Argument	Type	Description
email*	string	E-mail address to check.
rejectRoleAccounts	boolean
rejectFreeProviders	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "maxLength": 254,
      "minLength": 3,
      "description": "E-mail address to check."
    },
    "rejectRoleAccounts": {
      "type": "boolean",
      "default": false
    },
    "rejectFreeProviders": {
      "type": "boolean",
      "default": false
    }
  }
}

iban_validate

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.

Argument	Type	Description
iban*	string	IBAN, with or without spaces.
expectCountry	string	Expected country code (ISO 3166-1 alpha-2).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "iban"
  ],
  "properties": {
    "iban": {
      "type": "string",
      "maxLength": 42,
      "minLength": 5,
      "description": "IBAN, with or without spaces."
    },
    "expectCountry": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Expected country code (ISO 3166-1 alpha-2)."
    }
  }
}

pbx_audio_chunk

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.

Argument	Type	Description
uri	string	Customer-side media URI (preferred).
t_ms	integer
pbx_id	string
call_id*	string
bytes_b64	string	Optional small demo chunk; production prefers URI.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "call_id"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "Customer-side media URI (preferred)."
    },
    "t_ms": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 0
    },
    "pbx_id": {
      "type": "string",
      "maxLength": 64
    },
    "call_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2
    },
    "bytes_b64": {
      "type": "string",
      "maxLength": 200000,
      "description": "Optional small demo chunk; production prefers URI."
    }
  }
}

pbx_calls

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.

Argument	Type	Description
limit	integer	Max recent calls to return (1–100).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Max recent calls to return (1–100)."
    }
  }
}

pbx_calls_get

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.

Argument	Type	Description
call_id*	string	Call id (e.g. call_msp_002).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "call_id"
  ],
  "properties": {
    "call_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Call id (e.g. call_msp_002)."
    }
  }
}

pbx_calls_graph

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.

Argument	Type	Description
call_id*	string	Call id whose transfer graph to return.
stuck_at	string	Optional override for where the promise stuck (extension).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "call_id"
  ],
  "properties": {
    "call_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Call id whose transfer graph to return."
    },
    "stuck_at": {
      "type": "string",
      "maxLength": 16,
      "description": "Optional override for where the promise stuck (extension)."
    }
  }
}

pbx_dictionary

Argument	Type	Description
domain	string	Domain slice: hotel \| pbx_provider \| insurance \| finance \| energy \| automotive \| all (legacy keys + msp accepted)

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "domain": {
      "enum": [
        "hotel",
        "pbx_provider",
        "insurance",
        "finance",
        "energy",
        "automotive",
        "otel",
        "santral_firmasi",
        "sigorta",
        "finans",
        "enerji",
        "otomotiv",
        "msp",
        "all"
      ],
      "type": "string",
      "default": "all",
      "description": "Domain slice: hotel | pbx_provider | insurance | finance | energy | automotive | all (legacy keys + msp accepted)"
    }
  }
}

pbx_dictionary_add

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.

Argument	Type	Description
kind	string	Fact kind; inferred from seed term when omitted.
term*	string	Canonical term (e.g. AC, tariff). Plain Turkish preferred.
alias*	string	Synonym / alias to add (e.g. cooling, line package).
boost	number	Search boost weight (default 2).
scope	string	pbx = scoped to x-temsor-pbx-key; global = demo-wide. Default: pbx if registered key, else global.
domain	string	Domain: hotel \| pbx_provider \| insurance \| finance \| energy \| automotive (legacy keys + msp accepted).
hint_en	string
hint_tr	string

pbx_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.

Argument	Type	Description
events*	array	ARI / Stasis event batch. Utterance/text fields trigger heuristic promise extract.
pbx_id	string	PBX id that emitted the ARI batch.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "events"
  ],
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      },
      "maxItems": 200,
      "minItems": 1,
      "description": "ARI / Stasis event batch. Utterance/text fields trigger heuristic promise extract."
    },
    "pbx_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "PBX id that emitted the ARI batch."
    }
  }
}

pbx_facts

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.

Argument	Type	Description
q	string	Free-text filter over kind + value + call_id.
kind	string	Fact kind key (imei, oda, tarife, ...) or all.
limit	integer	Max facts to return (1–200).
domain	string	Domain slice: hotel \| pbx_provider \| insurance \| finance \| energy \| automotive \| all (legacy keys + msp accepted).
call_id	string	Filter by call id (e.g. call_msp_001).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "description": "Free-text filter over kind + value + call_id."
    },
    "kind": {
      "type": "string",
      "maxLength": 32,
      "description": "Fact kind key (imei, oda, tarife, ...) or all."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Max facts to return (1–200)."
    },
    "domain": {
      "enum": [
        "hotel",
        "pbx_provider",
        "insurance",
        "finance",
        "energy",
        "automotive",
        "otel",
        "santral_firmasi",
        "sigorta",
        "finans",
        "enerji",
        "otomotiv",
        "msp",
        "all"
      ],
      "type": "string",
      "description": "Domain slice: hotel | pbx_provider | insurance | finance | energy | automotive | all (legacy keys + msp accepted)."
    },
    "call_id": {
      "type": "string",
      "maxLength": 80,
      "description": "Filter by call id (e.g. call_msp_001)."
    }
  }
}

pbx_facts_get

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.

Argument	Type	Description
id*	string	Fact id (e.g. fact_001).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Fact id (e.g. fact_001)."
    }
  }
}

pbx_index_partial

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.

Argument	Type	Description
live	boolean	Default true while call is live.
t_ms	any
text	string	Partial utterance / snippet (customer STT or demo). Empty = metadata-only.
pbx_id	string
call_id*	string	Live call id to upsert partial index for.
promote	boolean	Promote heuristic hints into durable Promise/Fact docs.
speaker	any
end_call	boolean	Mark live=false; idle $0 for this call.
is_final	boolean	Finalized utterance span (vs interim).

pbx_index_partial_get

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.

Argument	Type	Description
call_id*	string	Call id whose live partial index to read.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "call_id"
  ],
  "properties": {
    "call_id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Call id whose live partial index to read."
    }
  }
}

pbx_ingest_transcript

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.

Argument	Type	Description
ext	string
who	string
pbx_id	string
call_id	string
transcript*	string	TR utterance / transcript text to scan for promises.
persist_promises	boolean	When false, extract only (dry-run, no write). When true, create Promise docs status=open.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "transcript"
  ],
  "properties": {
    "ext": {
      "type": "string",
      "maxLength": 16
    },
    "who": {
      "type": "string",
      "maxLength": 120
    },
    "pbx_id": {
      "type": "string",
      "maxLength": 64
    },
    "call_id": {
      "type": "string",
      "maxLength": 64
    },
    "transcript": {
      "type": "string",
      "maxLength": 50000,
      "minLength": 1,
      "description": "TR utterance / transcript text to scan for promises."
    },
    "persist_promises": {
      "type": "boolean",
      "default": true,
      "description": "When false, extract only (dry-run, no write). When true, create Promise docs status=open."
    }
  }
}

pbx_persons

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.

Argument	Type	Description
q	string	Free-text over names, phones, org, extensions, facts.
kind	string	caller = durable Person; extension = derived from call-graph hops; all = both.
limit	integer	Max persons to return (1–200).
call_id	string	Filter persons seen on this call id.
include_extensions	boolean	Include derived extension identities (default true).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "description": "Free-text over names, phones, org, extensions, facts."
    },
    "kind": {
      "enum": [
        "caller",
        "extension",
        "all"
      ],
      "type": "string",
      "description": "caller = durable Person; extension = derived from call-graph hops; all = both."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Max persons to return (1–200)."
    },
    "call_id": {
      "type": "string",
      "maxLength": 80,
      "description": "Filter persons seen on this call id."
    },
    "include_extensions": {
      "type": "boolean",
      "description": "Include derived extension identities (default true)."
    }
  }
}

pbx_persons_get

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.

Argument	Type	Description
id*	string	Person id (e.g. per_001) or extension id (e.g. ext_101).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1,
      "description": "Person id (e.g. per_001) or extension id (e.g. ext_101)."
    }
  }
}

pbx_promises

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.

Argument	Type	Description
status	string	Promise status filter; closed = kept\|broken. Sales demo uses open.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "status": {
      "enum": [
        "open",
        "kept",
        "broken",
        "unknown",
        "all",
        "closed"
      ],
      "type": "string",
      "default": "open",
      "description": "Promise status filter; closed = kept|broken. Sales demo uses open."
    }
  }
}

pbx_promises_act

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.

Argument	Type	Description
action	string	Default whisper. transfer uses graph stuck_at / promise.ext.
pbx_id	string
agent_ext	string
promise_id*	string	Open (or any) promise id — closed loop reads call graph then records orchestra intent.
skip_forward	boolean	Default true — record intent only.
stasis_webhook_url	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "promise_id"
  ],
  "properties": {
    "action": {
      "enum": [
        "whisper",
        "hold",
        "transfer",
        "pci_stop",
        "snoop"
      ],
      "type": "string",
      "description": "Default whisper. transfer uses graph stuck_at / promise.ext."
    },
    "pbx_id": {
      "type": "string",
      "maxLength": 64
    },
    "agent_ext": {
      "type": "string",
      "maxLength": 64
    },
    "promise_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Open (or any) promise id — closed loop reads call graph then records orchestra intent."
    },
    "skip_forward": {
      "type": "boolean",
      "description": "Default true — record intent only."
    },
    "stasis_webhook_url": {
      "type": "string",
      "maxLength": 500
    }
  }
}

pbx_promises_close

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.

Argument	Type	Description
note	string	Optional short operator note. Phones/emails stripped (privacy-safe).
status*	string	Close outcome: kept (honoured) or broken (not kept).
promise_id*	string	Promise id (prm_*). Sales demo marks open promises kept\|broken.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "promise_id",
    "status"
  ],
  "properties": {
    "note": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional short operator note. Phones/emails stripped (privacy-safe)."
    },
    "status": {
      "enum": [
        "kept",
        "broken"
      ],
      "type": "string",
      "description": "Close outcome: kept (honoured) or broken (not kept)."
    },
    "promise_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Promise id (prm_*). Sales demo marks open promises kept|broken."
    }
  }
}

pbx_promises_export

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.

Argument	Type	Description
format	string	Export format.
status	string	Promise status filter; closed = kept\|broken. Sales demo uses open.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "format": {
      "enum": [
        "csv",
        "json"
      ],
      "type": "string",
      "default": "csv",
      "description": "Export format."
    },
    "status": {
      "enum": [
        "open",
        "kept",
        "broken",
        "unknown",
        "all",
        "closed"
      ],
      "type": "string",
      "default": "open",
      "description": "Promise status filter; closed = kept|broken. Sales demo uses open."
    }
  }
}

pbx_promises_reopen

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.

Argument	Type	Description
promise_id*	string	Promise id (prm_*). Undo a kept\|broken close — restore open.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "promise_id"
  ],
  "properties": {
    "promise_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Promise id (prm_*). Undo a kept|broken close — restore open."
    }
  }
}

pbx_redact

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.

Argument	Type	Description
who	string	Actor label for durable audit (defaults to pbx scope / demo-operator).
mode	string	anonymize (default) scrubs fields; delete removes docs.
phone	string	Caller phone — finds Person phones (+ linked derived index).
reason	string	Personal-data erasure reason.
target_id	string	Document id (prm_, per_, call_, fact_).
target_type	string	Index document type. Optional when `phone` is set.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "who": {
      "type": "string",
      "maxLength": 80,
      "description": "Actor label for durable audit (defaults to pbx scope / demo-operator)."
    },
    "mode": {
      "enum": [
        "anonymize",
        "delete"
      ],
      "type": "string",
      "description": "anonymize (default) scrubs fields; delete removes docs."
    },
    "phone": {
      "type": "string",
      "maxLength": 32,
      "minLength": 7,
      "description": "Caller phone — finds Person phones (+ linked derived index)."
    },
    "reason": {
      "type": "string",
      "maxLength": 200,
      "description": "Personal-data erasure reason."
    },
    "target_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Document id (prm_*, per_*, call_*, fact_*)."
    },
    "target_type": {
      "enum": [
        "promise",
        "call",
        "person",
        "fact",
        "utterance"
      ],
      "type": "string",
      "description": "Index document type. Optional when `phone` is set."
    }
  }
}

pbx_redact_audit

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.

Argument	Type	Description
limit	integer	Max recent forget actions to return (default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max recent forget actions to return (default 20)."
    }
  }
}

pbx_register

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.

Argument	Type	Description
name	string	Pilot contact name (waitlist / register).
email	string	Pilot contact email.
label	string	Human label, e.g. hotel or PBX/IT provider site.
pbx_id	string	Pilot PBX id; auto-minted if omitted.
webhook_url	string	Optional outbound webhook URL — Temsor POSTs promise/fact/orchestra/redact events.
webhook_events	any	Event list or comma string: promise.opened\|closed, fact.extracted, orchestra.act, redact, or *.
webhook_secret	string	Optional HMAC secret for outbound webhook signatures (x-temsor-signature).
ari_webhook_secret	string	ARI webhook signing secret (stored as hint only).

Input schema (JSON)

pbx_search

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.

Argument	Type	Description
q	string	Full-text query over promises, facts, and call summaries.
ext	string
status	string
date_to	string	ISO date/time upper bound.
date_from	string	ISO date/time lower bound (promise.when_iso / call.started_at).
competitor	string
stuck_after	string	Filter: promise stuck after transfer to this extension (to_ext hop).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "default": "",
      "maxLength": 200,
      "description": "Full-text query over promises, facts, and call summaries."
    },
    "ext": {
      "type": "string",
      "maxLength": 16
    },
    "status": {
      "enum": [
        "open",
        "kept",
        "broken",
        "unknown"
      ],
      "type": "string"
    },
    "date_to": {
      "type": "string",
      "maxLength": 40,
      "description": "ISO date/time upper bound."
    },
    "date_from": {
      "type": "string",
      "maxLength": 40,
      "description": "ISO date/time lower bound (promise.when_iso / call.started_at)."
    },
    "competitor": {
      "type": "string",
      "maxLength": 64
    },
    "stuck_after": {
      "type": "string",
      "maxLength": 16,
      "description": "Filter: promise stuck after transfer to this extension (to_ext hop)."
    }
  }
}

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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "description": "No input — scoped by x-temsor-pbx-key when set."
}

pbx_webhooks

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.

Argument	Type	Description
url	string	Outbound webhook URL (http/https). Present → register; omit on GET → list.
ping	boolean	If true with url → register then ping; if true without url → ping existing.
limit	integer	List limit (default 50).
events	any	Events: promise.opened\|closed, fact.extracted, orchestra.act, redact, or *.
secret	string	Optional HMAC-SHA256 secret → x-temsor-signature: sha256=<hex>.
webhook_id	string	For ping: target webhook id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "url": {
      "type": "string",
      "maxLength": 500,
      "description": "Outbound webhook URL (http/https). Present → register; omit on GET → list."
    },
    "ping": {
      "type": "boolean",
      "description": "If true with url → register then ping; if true without url → ping existing."
    },
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "List limit (default 50)."
    },
    "events": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "string"
        }
      ],
      "description": "Events: promise.opened|closed, fact.extracted, orchestra.act, redact, or *."
    },
    "secret": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional HMAC-SHA256 secret → x-temsor-signature: sha256=<hex>."
    },
    "webhook_id": {
      "type": "string",
      "maxLength": 64,
      "description": "For ping: target webhook id."
    }
  }
}

pbx_webhooks_deliveries

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.

Argument	Type	Description
limit	integer	Max deliveries (default 20).
webhook_id	string	Filter by webhook id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "limit": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Max deliveries (default 20)."
    },
    "webhook_id": {
      "type": "string",
      "maxLength": 64,
      "description": "Filter by webhook id."
    }
  }
}

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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {},
  "description": "No input — TEMSOR_RTP_* from process env."
}

pbx_whisper_suggest

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).

Argument	Type	Description
call_id*	string	Active call id for agent UI context.
partial_text	string	Partial transcript / utterance text (no live speech recognition).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "call_id"
  ],
  "properties": {
    "call_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Active call id for agent UI context."
    },
    "partial_text": {
      "type": "string",
      "default": "",
      "maxLength": 2000,
      "description": "Partial transcript / utterance text (no live speech recognition)."
    }
  }
}

phone_validate

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`.

Argument	Type	Description
phone*	string	Phone number in any common format.
defaultCountry	string	ISO 3166-1 alpha-2 country to assume when the number has no international prefix. Defaults to US.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "phone"
  ],
  "properties": {
    "phone": {
      "type": "string",
      "maxLength": 30,
      "minLength": 4,
      "description": "Phone number in any common format."
    },
    "defaultCountry": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "ISO 3166-1 alpha-2 country to assume when the number has no international prefix. Defaults to US."
    }
  }
}

tr_address_parse

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.

Argument	Type	Description
address*	string	Free-text address.
defaultProvince	string	Province to assume when the address has none.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "maxLength": 500,
      "minLength": 3,
      "description": "Free-text address."
    },
    "defaultProvince": {
      "type": "string",
      "description": "Province to assume when the address has none."
    }
  }
}

tr_business_days

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.

Argument	Type	Description
end	string	If set, count business days between start and this date.
start*	string	Start date (YYYY-MM-DD).
addDays	integer	Add/subtract this many business days (not calendar days).
countHalfDaysAsWork	boolean	Count Arife half-days as working days?

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "start"
  ],
  "properties": {
    "end": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "If set, count business days between start and this date."
    },
    "start": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Start date (YYYY-MM-DD)."
    },
    "addDays": {
      "type": "integer",
      "maximum": 3650,
      "minimum": -3650,
      "description": "Add/subtract this many business days (not calendar days)."
    },
    "countHalfDaysAsWork": {
      "type": "boolean",
      "default": true,
      "description": "Count Arife half-days as working days?"
    }
  }
}

tr_iban_olustur

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.

Argument	Type	Description
bankCode*	string	5-digit Turkish national bank / EFT code (e.g. 00062).
reserved	string	Reserved BBAN digit after the bank code. Defaults to 0.
accountNumber*	string	Account number, up to 16 alphanumeric characters (padded left with zeros).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "bankCode",
    "accountNumber"
  ],
  "properties": {
    "bankCode": {
      "type": "string",
      "description": "5-digit Turkish national bank / EFT code (e.g. 00062)."
    },
    "reserved": {
      "type": "string",
      "description": "Reserved BBAN digit after the bank code. Defaults to 0."
    },
    "accountNumber": {
      "type": "string",
      "description": "Account number, up to 16 alphanumeric characters (padded left with zeros)."
    }
  }
}

tr_invoice_build

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.

Argument	Type	Description
id	string	Invoice number. Omit and supply `series` to have it built from the series and sequence.
uuid	string	Document UUID (ETTN). Generated when omitted.
lines*	array
notes	array
series	string	Three-letter series code, used with `sequence`.
profile	string	TEMELFATURA: no formal objection flow. TICARIFATURA: buyer may accept/reject. EARSIVFATURA: buyer is not an e-Invoice user.
currency

tr_invoice_parse

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.

Argument	Type	Description
xml*	string	UBL-TR e-Invoice / e-Archive (e-Arsiv) XML body.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "xml"
  ],
  "properties": {
    "xml": {
      "type": "string",
      "maxLength": 4000000,
      "minLength": 20,
      "description": "UBL-TR e-Invoice / e-Archive (e-Arsiv) XML body."
    }
  }
}

tr_labor

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.

Argument	Type	Description
age	integer	Employee age at termination — affects annual-leave entitlement (under 18 or 50+).
asOf	string	Rate table date. Defaults to endDate.
endDate*	string	Termination date (YYYY-MM-DD). Inclusive of this day.
startDate*	string	Employment start date (YYYY-MM-DD).
monthlyGross*	number	Gross monthly wage the severance is based on (giydirilmiş brüt).
unusedLeaveDays

tr_money_to_words

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.

Argument	Type	Description
style	string	Output letter case.
amount*	any	Amount. Accepts both "1.234,56" and 1234.56.
currency	string
wrapHash	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "amount"
  ],
  "properties": {
    "style": {
      "enum": [
        "lower",
        "title",
        "upper"
      ],
      "type": "string",
      "default": "lower",
      "description": "Output letter case."
    },
    "amount": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "number"
        }
      ],
      "description": "Amount. Accepts both \"1.234,56\" and 1234.56."
    },
    "currency": {
      "enum": [
        "TRY",
        "USD",
        "EUR",
        "GBP"
      ],
      "type": "string",
      "default": "TRY"
    },
    "wrapHash": {
      "type": "boolean",
      "default": false
    }
  }
}

tr_posta_kodu

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.

Argument	Type	Description
postalCode*	string	Turkish 5-digit postal code, with or without spaces.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "postalCode"
  ],
  "properties": {
    "postalCode": {
      "type": "string",
      "maxLength": 10,
      "minLength": 3,
      "description": "Turkish 5-digit postal code, with or without spaces."
    }
  }
}

tr_qr_odeme

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.

Argument	Type	Description
iban*	string	Beneficiary Turkish IBAN (with or without spaces).
name*	string	Payee name shown to the payer (2–26 chars after trim).
amount	number	TRY amount; omitted → static QR (payer enters amount).
currency	string	Must be TRY if provided.
explanation	string	Optional remittance note (application free field 10).
generatorCode	string	QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "iban",
    "name"
  ],
  "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": {
      "type": "number",
      "description": "TRY amount; omitted → static QR (payer enters amount)."
    },
    "currency": {
      "type": "string",
      "description": "Must be TRY if provided."
    },
    "explanation": {
      "type": "string",
      "description": "Optional remittance note (application free field 10)."
    },
    "generatorCode": {
      "type": "string",
      "description": "QR generator / EFT code (4 digits). Defaults to last 4 of the IBAN bank code."
    }
  }
}

tr_tebligat_clock

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.

Argument	Type	Description
type*	string	Notification method. Determines which event `basisDate` refers to and whether the deemed-received date is same-day or shifted.
basisDate*	string	The date `basisLabel` describes for this type — for "electronic" this is the date UETS reports the message as reached, not sent or read.
lawFamily*	string	Body of procedural law the period is computed under. Only "hmk" (Code of Civil Procedure) is supported so far.
periodDays*	integer	Length of the statutory or judicial period, in days, counted from `periodStart`.

tr_validate

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.

Argument	Type	Description
type	string	Omitted → inferred from the format.
value*	string	Value to validate.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "value"
  ],
  "properties": {
    "type": {
      "enum": [
        "auto",
        "tckn",
        "vkn",
        "iban",
        "plate",
        "imei",
        "gtin",
        "kep",
        "mersis",
        "postal",
        "isbn"
      ],
      "type": "string",
      "default": "auto",
      "description": "Omitted → inferred from the format."
    },
    "value": {
      "type": "string",
      "maxLength": 64,
      "minLength": 1,
      "description": "Value to validate."
    }
  }
}

tr_vat

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.

Argument	Type	Description
rate	any	VAT rate in percent. 0, 1, 10 or 20.
amount*	number	The amount to tax. See amountIncludesVat.
withholding	string	Withholding fraction such as "5/10", or a code from the list (reklam, tasima, hurda, isgucu…).
amountIncludesVat	boolean	If true, `amount` is the gross (KDV dahil); if false, it is the net/matrah.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "amount"
  ],
  "properties": {
    "rate": {
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 1
        },
        {
          "type": "number",
          "const": 10
        },
        {
          "type": "number",
          "const": 20
        }
      ],
      "default": 20,
      "description": "VAT rate in percent. 0, 1, 10 or 20."
    },
    "amount": {
      "type": "number",
      "maximum": 1000000000000,
      "minimum": 0,
      "description": "The amount to tax. See amountIncludesVat."
    },
    "withholding": {
      "type": "string",
      "description": "Withholding fraction such as \"5/10\", or a code from the list (reklam, tasima, hurda, isgucu…)."
    },
    "amountIncludesVat": {
      "type": "boolean",
      "default": false,
      "description": "If true, `amount` is the gross (KDV dahil); if false, it is the net/matrah."
    }
  }
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 120,
      "description": "Pilot contact name (waitlist / register)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "maxLength": 254,
      "description": "Pilot contact email."
    },
    "label": {
      "type": "string",
      "maxLength": 120,
      "description": "Human label, e.g. hotel or PBX/IT provider site."
    },
    "pbx_id": {
      "type": "string",
      "maxLength": 64,
      "minLength": 2,
      "description": "Pilot PBX id; auto-minted if omitted."
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 500,
      "description": "Optional outbound webhook URL — Temsor POSTs promise/fact/orchestra/redact events."
    },
    "webhook_events": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "string"
        }
      ],
      "description": "Event list or comma string: promise.opened|closed, fact.extracted, orchestra.act, redact, or *."
    },
    "webhook_secret": {
      "type": "string",
      "maxLength": 200,
      "description": "Optional HMAC secret for outbound webhook signatures (x-temsor-signature)."
    },
    "ari_webhook_secret": {
      "type": "string",
      "maxLength": 200,
      "description": "ARI webhook signing secret (stored as hint only)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "issueDate",
    "supplier",
    "customer",
    "lines"
  ],
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[A-Z]{3}[0-9]{13}$",
      "description": "Invoice number. Omit and supply `series` to have it built from the series and sequence."
    },
    "uuid": {
      "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)$",
      "description": "Document UUID (ETTN). Generated when omitted."
    },
    "lines": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "unitPrice"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 300,
            "minLength": 1,
            "description": "Item or service description as it must appear on the invoice."
          },
          "note": {
            "type": "string",
            "maxLength": 500
          },
          "vatRate": {
            "type": "number",
            "default": 20,
            "maximum": 100,
            "minimum": 0,
            "description": "VAT percentage, e.g. 20, 10, 1 or 0."
          },
          "quantity": {
            "type": "number",
            "default": 1,
            "maximum": 1000000000,
            "exclusiveMinimum": 0
          },
          "unitCode": {
            "type": "string",
            "default": "C62",
            "maxLength": 10,
            "minLength": 1,
            "description": "UN/ECE unit code. C62 = piece, KGM = kg, MTR = metre, HUR = hour."
          },
          "unitPrice": {
            "type": "number",
            "maximum": 1000000000000,
            "minimum": 0,
            "description": "Net unit price, before VAT and before the discount."
          },
          "discountRate": {
            "type": "number",
            "default": 0,
            "maximum": 100,
            "minimum": 0,
            "description": "Line discount percentage applied to the net amount."
          },
          "sellerItemCode": {
            "type": "string",
            "maxLength": 60
          },
          "vatExemptionReasonCode": {
            "type": "string",
            "maxLength": 10,
            "description": "Required by the tax authority when vatRate is 0."
          }
        }
      },
      "maxItems": 500,
      "minItems": 1
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 1000
      },
      "default": [],
      "maxItems": 20
    },
    "series": {
      "type": "string",
      "pattern": "^[A-Z]{3}$",
      "description": "Three-letter series code, used with `sequence`."
    },
    "profile": {
      "enum": [
        "TEMELFATURA",
        "TICARIFATURA",
        "EARSIVFATURA"
      ],
      "type": "string",
      "default": "TEMELFATURA",
      "description": "TEMELFATURA: no formal objection flow. TICARIFATURA: buyer may accept/reject. EARSIVFATURA: buyer is not an e-Invoice user."
    },
    "currency": {
      "type": "string",
      "default": "TRY",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO 4217. Anything other than TRY requires `exchangeRate`."
    },
    "customer": {
      "type": "object",
      "required": [
        "name",
        "taxNumber"
      ],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 100,
          "description": "City."
        },
        "name": {
          "type": "string",
          "maxLength": 300,
          "minLength": 2,
          "description": "Registered trade name, or the person’s full name."
        },
        "email": {
          "type": "string",
          "maxLength": 120
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "street": {
          "type": "string",
          "maxLength": 200
        },
        "country": {
          "type": "string",
          "default": "Türkiye",
          "maxLength": 60
        },
        "district": {
          "type": "string",
          "maxLength": 100,
          "description": "District."
        },
        "taxNumber": {
          "type": "string",
          "maxLength": 11,
          "minLength": 10,
          "description": "VKN (10 digits) or, for an individual, TCKN (11 digits)."
        },
        "taxOffice": {
          "type": "string",
          "maxLength": 100,
          "description": "Tax office (\"vergi dairesi\"). Required for VKN holders."
        },
        "postalCode": {
          "type": "string",
          "maxLength": 10
        },
        "buildingNumber": {
          "type": "string",
          "maxLength": 30
        }
      }
    },
    "sequence": {
      "type": "integer",
      "maximum": 999999999,
      "minimum": 1,
      "description": "Sequence number within the series and year."
    },
    "supplier": {
      "type": "object",
      "required": [
        "name",
        "taxNumber"
      ],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 100,
          "description": "City."
        },
        "name": {
          "type": "string",
          "maxLength": 300,
          "minLength": 2,
          "description": "Registered trade name, or the person’s full name."
        },
        "email": {
          "type": "string",
          "maxLength": 120
        },
        "phone": {
          "type": "string",
          "maxLength": 40
        },
        "street": {
          "type": "string",
          "maxLength": 200
        },
        "country": {
          "type": "string",
          "default": "Türkiye",
          "maxLength": 60
        },
        "district": {
          "type": "string",
          "maxLength": 100,
          "description": "District."
        },
        "taxNumber": {
          "type": "string",
          "maxLength": 11,
          "minLength": 10,
          "description": "VKN (10 digits) or, for an individual, TCKN (11 digits)."
        },
        "taxOffice": {
          "type": "string",
          "maxLength": 100,
          "description": "Tax office (\"vergi dairesi\"). Required for VKN holders."
        },
        "postalCode": {
          "type": "string",
          "maxLength": 10
        },
        "buildingNumber": {
          "type": "string",
          "maxLength": 30
        }
      }
    },
    "issueDate": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "issueTime": {
      "type": "string",
      "pattern": "^\\d{2}:\\d{2}:\\d{2}$"
    },
    "exchangeRate": {
      "type": "number",
      "description": "Units of TRY per one unit of `currency`.",
      "exclusiveMinimum": 0
    },
    "amountInWords": {
      "type": "boolean",
      "default": true,
      "description": "Adds the payable amount written out in Turkish words as a note, the way invoices require."
    },
    "invoiceTypeCode": {
      "enum": [
        "SATIS",
        "IADE"
      ],
      "type": "string",
      "default": "SATIS"
    },
    "orderReferenceId": {
      "type": "string",
      "maxLength": 50
    },
    "despatchDocumentId": {
      "type": "string",
      "maxLength": 50,
      "description": "Delivery note number, if the goods shipped separately."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "type",
    "lawFamily",
    "basisDate",
    "periodDays"
  ],
  "properties": {
    "type": {
      "enum": [
        "electronic",
        "physical",
        "vekil",
        "ilanen",
        "last_known_address"
      ],
      "type": "string",
      "description": "Notification method. Determines which event `basisDate` refers to and whether the deemed-received date is same-day or shifted."
    },
    "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."
    },
    "lawFamily": {
      "enum": [
        "hmk"
      ],
      "type": "string",
      "description": "Body of procedural law the period is computed under. Only \"hmk\" (Code of Civil Procedure) is supported so far."
    },
    "periodDays": {
      "type": "integer",
      "maximum": 3650,
      "description": "Length of the statutory or judicial period, in days, counted from `periodStart`.",
      "exclusiveMinimum": 0
    },
    "periodType": {
      "type": "string",
      "maxLength": 120,
      "description": "Free-text label for the period (e.g. \"itiraz\", \"temyiz\"), echoed back only — not mapped to a day count."
    },
    "hasAttorney": {
      "type": "boolean",
      "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."
    },
    "ilanenDeemedDays": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "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."
    },
    "subjectToJudicialRecess": {
      "type": "boolean",
      "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."
    }
  }
}