Retrieves the details of an existing endpoint.
API Endpoint
https://api.plivo.com/v1/Account/{auth_id}/Endpoint/{endpoint_id}/
Arguments
No arguments need to be passed.
Returns
Returns an Endpoint object if valid parameters were provided. Returns an error otherwise.
The password
returned is an MD5 hash value of the actual password.
import plivo
client = plivo.RestClient('<auth_id>','<auth_token>')
response = client.endpoints.get(
endpoint_id='1465909595140', )
print(response)
Response
HTTP Status Code: 200
Plivo returns this JSON response when the endpoint is not registered on a SIP client.
{
"alias": "zumba",
"api_id": "39015de8-4fb3-11e4-a2d1-22000ac5040c",
"application": "/v1/Account/MA2025RK4E639VJFZAGV/Application/379619814477342321/",
"endpoint_id": "39452475478853",
"password": "8bc0002a467b8276aaaf47e92bc46b9f",
"resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Endpoint/39452475478853/",
"sip_registered": "false",
"sip_uri": "sip:zumba141009125224@phone.plivo.com",
"sub_account": null,
"username": "zumba141009125224"
}
When the endpoint is registered with a SIP client, Plivo returns this JSON response.
{
"alias": "callme",
"application": "/v1/Account/MA2025RK4E639VJFZAGV/Application/33406267401237901/",
"endpoint_id": "32866729519064",
"resource_uri": "/v1/Account/MA2025RK4E639VJFZAGV/Endpoint/32866729519064/",
"sip_contact": "sip:callme140703093224@122.172.71.207:57563;ob",
"sip_expires": "2022-07-21 19:26:08", // Format: YYYY-MM-DD HH:mm:ss Timezone: UTC
"sip_registered": "true",
"sip_uri": "sip:callme140703093944@phone.plivo.com",
"sip_user_agent": "Telephone 1.1.4",
"sub_account": null,
"username": "callme140703093944"
}