Skip to main content
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"

{
  "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"
  }
}

​
Path Parameters

​
agentId
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"

{
  "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"
  }
}

​
Response Fields

FieldTypeDescription
statestringOpenSIPS registration state name (see table below)
stateCodeintegerNumeric state code (0-9)
enabledstringWhether the registration is enabled ("yes" or "no")
expiresintegerRegistration expiration timestamp
lastRegisterSentstringTimestamp of the last REGISTER request sent
registrationTimeoutstringRegistration timeout value in seconds
isRegisteredbooleantrue if the agent is currently registered and receiving calls
errorMessagestringHuman-readable description of the current state

​
Registration States

StateCodeDescription
NOT_REGISTERED_STATE0No REGISTER has been sent yet
REGISTERING_STATE1Waiting for reply (no auth)
AUTHENTICATING_STATE2Waiting for reply (with auth)
REGISTERED_STATE3Successfully registered
REGISTER_TIMEOUT_STATE4No reply received (timeout)
INTERNAL_ERROR_STATE5Error during processing
WRONG_CREDENTIALS_STATE6Credentials rejected
REGISTRAR_ERROR_STATE7Error reply from registrar
NOT_FOUND0Registration 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

StateLikely CauseSolution
WRONG_CREDENTIALS_STATEInvalid username or passwordVerify SIP credentials with your provider
REGISTER_TIMEOUT_STATENetwork or firewall issueCheck that the proxy/domain is reachable, try a different transport
NOT_FOUNDRegistration not yet syncedWait a few seconds for the sync service to process
INTERNAL_ERROR_STATEServer-side errorCheck SIP domain and proxy configuration