Graph API Resource | Viadeo API

GET /<contactrequest_id>
PUT /<contactrequest_id>
DELETE /<contactrequest_id>
List of connections

GET /<contactrequest_id>

Authenticated resource

Retrieve a pending contact request.

Example

https://api.viadeo.com/<contactrequest_id>?language=fr&user_detail=NONE&user_pending_request=false&access_token=...

Query parameters

Parameter name	Description	Type	Default value
language=	Language in which the profile will be displayed. Default value is the navigation language of the user on the website.	ISO-639
user_detail=	Retrieve more information about a member's profile (location, headline, ...). Refer to our advanced API usesection for more information.	NONE \| PARTIAL \| FULL	NONE
user_pending_request=	Retrieve the id with the related user if there is any pending request. DEPRECATED, removed 2013-08-31. Reason: More ...complete information available by using /user/pending_requests connection - returns pending connection requests between you and given user. Replaced by: pending_requests connection. Deprecated since: 2013-01-31.	BOOLEAN	FALSE
user_watermark=	Provide pictures with a watermark.	BOOLEAN	TRUE

Response [JSON] [XML]

Field name	Description	Type
from	Request origin (member).	STRUCT
birth_year	Year of birth of the member.	INTEGER
birthdate	Full date of birth of the member.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
contact_count	Member's number of contacts.	INTEGER
distance	Distance between the authenticated member and the viewed profile.	INTEGER
first_name	Member's first name.	STRING
gender	Gender of the member.	M\|F
has_picture	Indicates if the user has set a profile picture.	BOOLEAN
headline	Member's profile headline.	STRING
id	Graph resource's ID.	STRING
interests	List of the interests / hobbies of a member.	STRING
introduction	Member's profile introduction.	STRING
is_premium	Premium state of the member.	BOOLEAN
language	Language of this member's profile.	ISO-639
last_name	Member's last name.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
location	Member's location.	STRUCT
address	Location's address.	STRING
address_2	Location's address.	STRING
area	Location's area. DEPRECATED, removed 2013-11-21. Replaced by: ...county field. Deprecated since: 2012-11-21.	STRING
city	Location's city.	STRING
country	Location's country.	STRING
country_code	Location's country code.	STRING
county	Location's county.	STRUCT
id	Entity's identifier.	STRING
name	Entity's name.	STRING
type	Entity's type.	STRING
description	Location's description.	STRING
latitude	Location's latitude.	STRING
longitude	Location's longitude.	STRING
timezone	Location's timezone.	STRING
zipcode	Location's zipcode.	STRING
name	Graph resource's name.	STRING
nickname	Viadeo nickname of the member. Can be used to replace the in the call. Usually [firstname].[lastname].	STRING
pending_request_id	Indicates the pending request id between the caller and this member.	STRING
picture_large	Link to the member's large picture.	STRING
picture_medium	Link to the member's medium picture.	STRING
picture_modification_date	Last modification date of the member's picture.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
picture_small	Indicates if the user has set a profile picture.	STRING
premium_since	Date the member is premium since.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
premium_until	User premium expiration date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
profile_completion_score	Profil completion score.	INTEGER
twitter_accounts	The Twitter account names of the member.	[LIST] STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
webid	Member's id on the Viadeo website.	STRING
id	Graph resource's ID.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
message	Message of the request.	STRING
mutual_contact_count	Number of common contacts.	INTEGER
name	Graph resource's name.	STRING
subject	Subject of the request.	STRING
to	Request target (member).	STRUCT
birth_year	Year of birth of the member.	INTEGER
birthdate	Full date of birth of the member.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
contact_count	Member's number of contacts.	INTEGER
distance	Distance between the authenticated member and the viewed profile.	INTEGER
first_name	Member's first name.	STRING
gender	Gender of the member.	M\|F
has_picture	Indicates if the user has set a profile picture.	BOOLEAN
headline	Member's profile headline.	STRING
id	Graph resource's ID.	STRING
interests	List of the interests / hobbies of a member.	STRING
introduction	Member's profile introduction.	STRING
is_premium	Premium state of the member.	BOOLEAN
language	Language of this member's profile.	ISO-639
last_name	Member's last name.	STRING
link	Link to the current Graph resource on Viadeo website.	STRING
location	Member's location.	STRUCT
address	Location's address.	STRING
address_2	Location's address.	STRING
area	Location's area. DEPRECATED, removed 2013-11-21. Replaced by: ...county field. Deprecated since: 2012-11-21.	STRING
city	Location's city.	STRING
country	Location's country.	STRING
country_code	Location's country code.	STRING
county	Location's county.	STRUCT
id	Entity's identifier.	STRING
name	Entity's name.	STRING
type	Entity's type.	STRING
description	Location's description.	STRING
latitude	Location's latitude.	STRING
longitude	Location's longitude.	STRING
timezone	Location's timezone.	STRING
zipcode	Location's zipcode.	STRING
name	Graph resource's name.	STRING
nickname	Viadeo nickname of the member. Can be used to replace the in the call. Usually [firstname].[lastname].	STRING
pending_request_id	Indicates the pending request id between the caller and this member.	STRING
picture_large	Link to the member's large picture.	STRING
picture_medium	Link to the member's medium picture.	STRING
picture_modification_date	Last modification date of the member's picture.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
picture_small	Indicates if the user has set a profile picture.	STRING
premium_since	Date the member is premium since.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
premium_until	User premium expiration date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
profile_completion_score	Profil completion score.	INTEGER
twitter_accounts	The Twitter account names of the member.	[LIST] STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]
webid	Member's id on the Viadeo website.	STRING
type	Graph resource's type.	STRING
updated_time	Graph resource's Last update date.	ISO-8601 [YYYY-MM-DD'T'HH:MM:SSZZ]

PUT /<contactrequest_id>

Authenticated resource

Allows user accept or decline pending contact request.

Example

curl --data-urlencode -X PUT -d 'contact_card=BUSINESS&message=XxXxX&value=accept' https://api.viadeo.com/<contactrequest_id>?access_token=...

Query parameters

Parameter name	Description	Type	Default value
contact_card=	Type of contact card sent to the requesting user.	BUSINESS \| PERSO \| NONE \| ALL	BUSINESS
message=	Message that will be sent to the requesting user, empty by default.	STRING
value=	Type of the operation.	ACCEPT \| DECLINE

Response

Field name	Description	Type
updated	Always true if resource is updated.	TRUE

DELETE /<contactrequest_id>

Authenticated resource

Allows user to delete one of their pending requests.

Example

curl --data-urlencode -X DELETE https://api.viadeo.com/<contactrequest_id>?access_token=...

Response

Field name	Description	Type
deleted	Always true if resource is deleted.	TRUE

List of connections

Connection path	Description

Resource: /contactrequest

GET /<contactrequest_id>

Example

Query parameters

Response [JSON] [XML]

PUT /<contactrequest_id>

Example

Query parameters

Response

DELETE /<contactrequest_id>

Example

Response

List of connections