See exactly how the TAC database API request works
This page shows the required headers, a live request tester, and example JSON responses for both success and not-found cases.
API key required
Use the X-API-Key header with the key emailed after approval.
TAC lookup only
The public API exposes TAC model lookup and health only. Nothing else.
Free for approved users
Access is free of cost after review and approval.
TAC lookup guide
Built for TAC database lookup
The TAC database API is TAC-only and approval based. Approved users can send either an 8-digit TAC or a full 14/15-digit IMEI, and the service derives the TAC automatically before returning brand and model data.
Send a TAC lookup request
Solve the captcha to mint a 5-use temporary key, then send TAC or IMEI lookups from the demo.
Temporary demo key
Valid for 5 TAC/IMEI checks, expires after 30 minutes, and is tied to this demo session.
Enter an 8-digit TAC or a 14/15-digit IMEI. The demo will derive the TAC automatically.
The key goes in the X-API-Key header.
POST /api/tac-demo/lookup
Content-Type: application/json
X-API-Key: tac_live_xxxxxxxxxxxxxxxxxxxx
{
"imeiOrTac": "35693803"
}What to send
The TAC lookup endpoint is a simple authenticated POST request through the demo gate.
Method
POST
Endpoint
/api/tac-demo/lookup
Header
X-API-Key: your key
Body
JSON with one field: imeiOrTac
Accepted input
8-digit TAC or 14/15-digit IMEI, for example 35693803 or 356938031234567
Live response
The panel below shows the real API result, headers, and any error message.
{
"success": true,
"status": "success",
"result": "Brand: Apple<br>Model: iPhone 14 Pro<br>Model Name: iPhone15,2<br>",
"count_free_checks_today": 209000,
"readPerformance": "0.0001 seconds",
"object": {
"brand": "Apple",
"name": "iPhone15,2",
"model": "iPhone 14 Pro"
}
}content-type: application/json
What users need to send
Method: GET
Endpoint: /api/tac/:tac
Headers: X-API-Key and Accept: application/json
TAC: 8 digits, for example 35693803
IMEI input: Full IMEI values are also accepted and the TAC is derived automatically.
Rate limits: Approved keys start at 5 checks per minute and can be increased by admin on request.
{
"method": "GET",
"url": "/api/tac/35693803",
"headers": {
"X-API-Key": "tac_live_xxxxxxxxxxxxxxxxxxxx",
"Accept": "application/json"
}
}What the API returns
Successful lookups return the device object, the rendered result string, and usage metadata. Not-found lookups return the same friendly fallback message used elsewhere on the site.
Success
{
"success": true,
"status": "success",
"result": "Brand: Apple<br>Model: iPhone 14 Pro<br>Model Name: iPhone14,2<br>",
"count_free_checks_today": 209000,
"readPerformance": "0.0001 seconds",
"object": {
"brand": "Apple",
"name": "iPhone14,2",
"model": "iPhone 14 Pro"
}
}Not found
{
"success": false,
"error": {
"code": "TAC_NOT_FOUND",
"message": "Unable to check device at the moment. Please try your free check again in 24–48 hours—our device database is updated regularly."
}
}Postman available
Prefer importing the collection?
You can also download the Postman collection from the GitHub TAC database repo and start testing immediately.
This gives you a clear request format, a predictable response shape, and a simple path from approval to testing.