Transity API

Transity exposes a company-search experience, JSON APIs, operational endpoints, and interactive API documentation.

Product surfaces

Surface	Endpoint	Purpose
Company search	`/`	Searchable web interface
Company search API	`/api/companies/search?q=...`	Search by legal name, register ID, or locality
Company details	`/api/companies/{public_id}`	Return enriched company information
Transaction enrichment	`POST /v1/enrichments:resolve`	Normalize and resolve a raw transaction descriptor
Corrections	`POST /v1/suggestions`	Submit brand, category, location, recurring, or asset feedback
API documentation	`/docs`	OpenAPI user interface
Liveness	`/health`	Confirm that the process is running
Readiness	`/ready`	Return the current application readiness status

Search companies

curl --get 'http://localhost:8000/api/companies/search' \
  --data-urlencode 'q=Migros' \
  --data-urlencode 'limit=10'

Search accepts a legal name, register ID, or locality. Results include public identifiers and available company enrichment such as address, domain, and verified logo URL.

Enrich a transaction

curl --request POST 'http://localhost:8000/v1/enrichments:resolve' \
  --header 'Content-Type: application/json' \
  --data '{
    "source_type": "iso8583",
    "source_payload": {"merchant": "MIGROS 1234 ZURICH"},
    "raw_descriptor": "MIGROS 1234 ZURICH",
    "mcc": "5411",
    "amount_minor": 4290,
    "currency": "CHF"
  }'

The response contains a generated transaction ID, enrichment version, state, normalized brand candidate, confidence, ruleset version, and reasons for any partial result.

Help Instance Help

Transity API

Product surfaces

Search companies

Enrich a transaction

See Also