curl -X GET https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/sip/registration/status \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const agentId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/agents/${agentId}/sip/registration/status`,
{
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
const result = await response.json();
import requests
agent_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.get(
f'https://api.telzino.com/v1/agents/{agent_id}/sip/registration/status',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
result = response.json()
{
"success": true,
"data": {
"state": "REGISTERED_STATE",
"stateCode": 3,
"enabled": "yes",
"expires": 1771788661,
"lastRegisterSent": "2026-02-22T12:00:00Z",
"registrationTimeout": "3600",
"isRegistered": true,
"errorMessage": "Successfully registered"
}
}
{
"error": "not_found",
"error_description": "No SIP registration configured for this agent"
}
Agents
Get SIP Registration Status
Check the current SIP registration status of an agent in OpenSIPS
GET
/
v1
/
agents
/
{agentId}
/
sip
/
registration
/
status
curl -X GET https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/sip/registration/status \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const agentId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/agents/${agentId}/sip/registration/status`,
{
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
const result = await response.json();
import requests
agent_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.get(
f'https://api.telzino.com/v1/agents/{agent_id}/sip/registration/status',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
result = response.json()
{
"success": true,
"data": {
"state": "REGISTERED_STATE",
"stateCode": 3,
"enabled": "yes",
"expires": 1771788661,
"lastRegisterSent": "2026-02-22T12:00:00Z",
"registrationTimeout": "3600",
"isRegistered": true,
"errorMessage": "Successfully registered"
}
}
{
"error": "not_found",
"error_description": "No SIP registration configured for this agent"
}
Path Parameters
string
required
The unique identifier of the agent (UUID format)
curl -X GET https://api.telzino.com/v1/agents/123e4567-e89b-12d3-a456-426614174000/sip/registration/status \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
const agentId = '123e4567-e89b-12d3-a456-426614174000';
const response = await fetch(
`https://api.telzino.com/v1/agents/${agentId}/sip/registration/status`,
{
headers: {
'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
}
}
);
const result = await response.json();
import requests
agent_id = '123e4567-e89b-12d3-a456-426614174000'
response = requests.get(
f'https://api.telzino.com/v1/agents/{agent_id}/sip/registration/status',
headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
)
result = response.json()
{
"success": true,
"data": {
"state": "REGISTERED_STATE",
"stateCode": 3,
"enabled": "yes",
"expires": 1771788661,
"lastRegisterSent": "2026-02-22T12:00:00Z",
"registrationTimeout": "3600",
"isRegistered": true,
"errorMessage": "Successfully registered"
}
}
{
"error": "not_found",
"error_description": "No SIP registration configured for this agent"
}
Response Fields
| Field | Type | Description |
|---|---|---|
state | string | OpenSIPS registration state name (see table below) |
stateCode | integer | Numeric state code (0-9) |
enabled | string | Whether the registration is enabled ("yes" or "no") |
expires | integer | Registration expiration timestamp |
lastRegisterSent | string | Timestamp of the last REGISTER request sent |
registrationTimeout | string | Registration timeout value in seconds |
isRegistered | boolean | true if the agent is currently registered and receiving calls |
errorMessage | string | Human-readable description of the current state |
Registration States
| State | Code | Description |
|---|---|---|
NOT_REGISTERED_STATE | 0 | No REGISTER has been sent yet |
REGISTERING_STATE | 1 | Waiting for reply (no auth) |
AUTHENTICATING_STATE | 2 | Waiting for reply (with auth) |
REGISTERED_STATE | 3 | Successfully registered |
REGISTER_TIMEOUT_STATE | 4 | No reply received (timeout) |
INTERNAL_ERROR_STATE | 5 | Error during processing |
WRONG_CREDENTIALS_STATE | 6 | Credentials rejected |
REGISTRAR_ERROR_STATE | 7 | Error reply from registrar |
NOT_FOUND | 0 | Registration not found in OpenSIPS |
A
state of REGISTERED_STATE (code 3) means the agent is successfully registered and ready to receive calls. Any other state indicates an issue that may need attention.Common Issues
| State | Likely Cause | Solution |
|---|---|---|
WRONG_CREDENTIALS_STATE | Invalid username or password | Verify SIP credentials with your provider |
REGISTER_TIMEOUT_STATE | Network or firewall issue | Check that the proxy/domain is reachable, try a different transport |
NOT_FOUND | Registration not yet synced | Wait a few seconds for the sync service to process |
INTERNAL_ERROR_STATE | Server-side error | Check SIP domain and proxy configuration |
⌘I
