Get a contact channel | Stack Auth Documentation

Retrieves a specific contact channel by the user ID and the contact channel ID.

Path parameters

user_idstringRequired

the user that the contact channel belongs to

contact_channel_idstringRequired

the target contact channel

Query parameters

user_idstringOptional

The ID of the user, or the special value me for the currently authenticated user

contact_channel_idstringOptional

Response

Successful response

user_idstring

The unique identifier of the user

idstring

The unique identifier of the contact channel

valuestring

The value of the contact channel. For email, this should be a valid email address.

typestring

The type of the contact channel. Currently only "email" is supported.

used_for_authboolean

Whether the contact channel is used for authentication. If this is set to true, the user will be able to sign in with the contact channel with password or OTP.

is_verifiedboolean

Whether the contact channel has been verified. If this is set to true, the contact channel has been verified to belong to the user.

is_primaryboolean

Whether the contact channel is the primary contact channel. If this is set to true, it will be used for authentication and notifications by default.

1	import requests
2
3	url = "https://api.stack-auth.com/api/v1/contact-channels/me/b3d396b8-c574-4c80-97b3-50031675ceb2"
4
5	querystring = {"user_id":"3241a285-8329-4d69-8f3d-316e08cf140c"}
6
7	response = requests.get(url, params=querystring)
8
9	print(response.json())

1	{
2	"user_id": "3241a285-8329-4d69-8f3d-316e08cf140c",
3	"id": "b3d396b8-c574-4c80-97b3-50031675ceb2",
4	"value": "johndoe@example.com",
5	"type": "email",
6	"used_for_auth": true,
7	"is_verified": true,
8	"is_primary": true
9	}