Get a line's connection status
Reads what the network reports about one line: its status there (active, suspended or inactive), when it last saw activity on the line, the country and operator the line is attached to, the network type, and the IP address, APN and device IMEI in use.
A line is read at most once per 5-minute window. The windows are fixed, starting on the clock's 5-minute marks rather than at a request. A request inside a window gets the answer the network gave at checkedAt, whoever asked first, without the network being asked again — so polling more often returns the same answer. The first request in the next window reads the line again, however recent the last read. A failed read is answered again the same way until its window ends. Reads of many lines are answered a few at a time per network, so a loop over a large roster takes a while.
Some lines cannot be read: those in a market whose network does not report connection status, those with no phone number or eSIM yet, and those still being ported in or already ended. They answer 200 with available: false and every other field null.
A line in another organization answers exactly as one that does not exist.
Request
- Base URLhttps://api.telgea.com
- AuthAPI key in header x-api-key
Path parameters
UUID of the line.
Response
The line's connection status, or available: false for a line that cannot be read.
Example response
{
"available": true,
"status": "active",
"lastSeenAt": "2026-10-19T11:58:00.000Z",
"countryCode": "DK",
"servingNetwork": "TDC",
"accessTechnology": "4G",
"ipAddress": "10.20.30.40",
"apn": "internet",
"imei": "356938035643809",
"checkedAt": "2026-10-19T12:00:00.000Z"
}Changes
No recorded changes to this operation across all 1 revision of this API.