Skip to main content
Retrieves the details of an existing endpoint.
API Endpoint
GET
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"
}