T-CODE Your Smart Address
in Tunisia.
One API call converts any GPS coordinate into a short, memorable T-Code. Power logistics, deliveries, and emergency services without relying on unreliable street addresses.
Trusted by logistics, delivery & emergency teams across Tunisia
Request
curl -X POST \
https://api.t-code.tn/v1/tcode/create \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"lat": 36.8065,
"lng": 10.1815
}'Response
{
"success": true,
"data": {
"tCode": "TT10-D329",
"plusCode": "8F8GR54J+HJV",
"postalCode": "1002",
"locality": "Hedi Chaker"
}
}Try Address Finder
Rooftop Geocodes & Plus Codes included with every Tunisia Address Lookup
Try the address finder
Search by address or T-Code — Plus Code & location details included.
Start typing an address here to try it out
Simple to Install
Drop our SDK into your stack with a single API call — or use the address finder API directly. No heavy config, no proprietary maps tile.
Address Autofill
Quickly corrects common mistakes in addresses as you type, thanks to fuzzy matching across Tunisia's locality and postal-code data.
Accessible
Built with combobox semantics and keyboard navigation so screen reader users can complete their address easily and independently.
Tunisia & T-Code Data
Search by street, locality, postal code — or any T-Code. Rooftop geocodes and Plus Codes returned with every lookup.
Platform
Everything you need
to integrate.
A single REST API with predictable responses, comprehensive error codes, and clear documentation.
Fast by default
Sub-50ms median response time. Redis-cached grid lookups. No cold starts.
Secure access
JWT bearer tokens with per-key scopes, IP whitelisting, and rate limiting built in.
RESTful API
Standard JSON responses, predictable errors, and Zod-validated inputs on every route.
Grid precision
10-meter resolution grid codes derived from Open Location Codes (Plus Codes).
SDK-ready
Clean cURL, JavaScript, and Python examples in the interactive sandbox.
Invite-only access
All developer accounts are manually reviewed. API is geo-restricted to Tunisia.
Getting started
Up and running in minutes.
Apply
Submit your organization and intended use case. We review every application within 1–3 business days.
Create an API key
Once approved, generate a key with the scopes and rate limits your integration needs.
Make your first call
Pass a GPS coordinate. Get back a T-Code, Plus Code, and postal code — in one request.
Story
Visualizing the T-Code story.
Here is another glimpse of the product experience, showing how routes, location data, and smart address conversion work together in a polished interface.
API Reference
Simple, consistent
responses.
Every endpoint returns the same envelope: success, data, and message. Predictable errors. Standard HTTP codes.
- Zod-validated request bodies
- Standardised JSON error envelopes
- HTTP 429 on rate-limit with Retry-After header
- Bearer token authentication on every endpoint
{
"success": true,
"statusCode": 200,
"message": "T-Code created successfully",
"data": {
"tCode": "TT10-D329",
"plusCode": "8F8GR54J+HJV",
"postalCode": "1002",
"locality": "Hedi Chaker",
"governorate": "Tunis"
}
}Pricing
Start free.
Scale as you grow.
Free tier for prototyping, annual subscriptions for production. Government and emergency services get custom pricing.
Start building with T-Code.
Apply for API access. Applications are reviewed within 1–3 business days. No credit card required for the free tier.