Here you’ll find a list of the main changes and improvements to the XING API. Advance information about key updates will be announced in the developer group or on Twitter.

A convenient way to stay informed is our Atom feed.

2015-02-23

Url Description
News

Added calls to create, access and interact with news pages and articles.

2015-02-16

Url Description
GET /v1/users/:user_id/contacts

The optional parameter 'changed since' was added to the contacts call.

2015-02-09

Url Description
GET /v1/users/:user_id/visits

The profile visits call will always contain a 'job_title' field.

2015-01-30

Url Description
Applications dashboard

We have enhanced our permission system: You can now select the user data you actually require from the users of your app. If you apply for a production key you will be asked to enter this information. For existing applications you do not need to change anything.

PUT /v1/groups/:group_id/read

Added a call to mark a group as read.

2015-01-19

Url Description
POST /v1/groups/forums/posts/:post_...

“Add a comment to a post” call now has a per call throttling

POST /v1/groups/forums/:forum_id/posts

“Create a post in a group” call now has a per call throttling

GET /v1/users/find

“Find users by keywords” call now has a per call throttling

2014-12-19

Url Description
GET /v1/users/:user_id/visits

The profile visits call will always contain a 'gender' field.

GET /v1/users/:user_id/contact_requ...

The optional parameter 'recipient id' was added to the sent contact requests call.

GET /v1/groups/find

Added group search to find groups matching a list of keywords.

2014-12-12

Url Description
Message calls

Message attachment calls changed from “experimental” to “production” state.

GET /v1/users/me/conversations/vali...

“Validate recipient” call changed from “experimental” to “production” state.

Profile Editing

“Profile editing” calls changed from “experimental” to “production” state.

POST /v1/users/invite

“Send invitations via email to contacts who do not have a XING profile” call changed from “experimental” to “production” state.

GET /v1/users/:user_id/legal_inform...

“Fetch legal information of a user” call changed from “experimental” to “production” state.

GET /v1/users/me/contact_ids

“Get the current user's contact IDs” call changed from “experimental” to “production” state.

2014-12-11

Url Description
GET /v1/groups/forums/posts/:post_id

Show a post

DELETE /v1/groups/forums/posts/comm...

Added a call to remove a like from a comment

PUT /v1/groups/forums/posts/comment...

Added a call to like a comment

DELETE /v1/groups/forums/posts/:pos...

Added a call to remove a like from a forum post

PUT /v1/groups/forums/posts/:post_i...

Added a call to like a forum post

DELETE /v1/groups/forums/posts/comm...

Added call to delete a comment to a post

POST /v1/groups/forums/posts/:post_...

Added call to create a comment to a post

2014-12-10

Url Description
POST /v1/users/me/share/link

Added the optional field 'text'. The text provided will be displayed above the link starting in March 2015. Until then the text will be displayed as a comment.

Network Feed

Added a new field 'message' to all activities in the network feed. This field will be empty in all cases for now. In the future this field will contain the message that was provided with the activity

2014-11-28

Url Description
GET /v1/groups/forums/posts/comment...

Added call to get the list of likes for a specific comment

GET /v1/groups/forums/posts/:post_i...

Added call to get the list of likes for a specific post

2014-11-26

Url Description
DELETE /v1/groups/:group_id/members...

Leave a group

POST /v1/groups/:group_id/memberships

Join an open group or request membership to a closed group

DELETE /v1/groups/forums/posts/:pos...

Delete a post from a group

GET /v1/groups/:group_id/posts

Added call to get a list of all forum posts for a specific group

POST /v1/groups/forums/:forum_id/posts

Added call to create a post on a forum

2014-11-07

Url Description
GET /v1/groups/forums/posts/:post_i...

Added call to get the list of comments for a specific post

GET /v1/groups/forums/:forum_id/posts

Added call to get the list of posts for a specific forum

GET /v1/groups/:group_id/forums

Added call to get the list of forums for a specific group

GET /v1/users/:user_id/groups

Added call to list all groups of a user

2014-11-03

Url Description
GET /v1/users/find

Added user profile search. This call is only available to certain consumers. Please e-mail "api-support@xing.com" for more information.

2014-10-16

Url Description
GET /v1/users/:user_id/visits

Response parameter user_id is set to null for visits made by blacklisted users

2014-10-14

Url Description
GET /v1/users/:id

Square photo sizes are added to the users response. The old formats are deprecated. When the new format will be available will be announced. From November 2014 on please use the new ones.

2014-08-25

Url Description
PUT /v1/users/me/photo

Allows user to update users photo with data in JSON format

2014-08-19

Url Description
PUT /v1/users/me/birth_date

Changed experimental call to update the birthdate in the users profile to expect year, month and day instead of birth_date parameter

2014-08-18

Url Description
PUT /v1/users/me/web_profiles/:profile

Added call to update the list of web profiles in the users profile

DELETE /v1/users/me/web_profiles/:p...

Added call to delete web profiles in the users profile

2014-08-07

Url Description
PUT /v1/users/me/birth_date

Added calls to update the date of birth in the users profile

2014-08-04

Url Description
All job related calls

All job calls changed from “experimental” to “production” state.

2014-07-29

Url Description
GET /v1/users/:user_id/network/reco...

The parameter 'similar user id' to find recommendations based on the given user was removed. Sending the parameter won't cause an error but has no effect anymore.

2014-07-28

Url Description
PUT /v1/users/me/languages/:language

Added calls to update a language in the users profile

DELETE /v1/users/me/languages/:lang...

Added calls to delete a language in the users profile

2014-07-24

Url Description
PUT /v1/users/me

Added call to update your profile with wants, haves and interests.

2014-06-27

Url Description
DELETE /v1/users/:user_id/contact_r...

Add explanation of limitations for revoking contact requests.

2014-06-26

Url Description
All calls which return user data

The users educational background got the 'degree' field. The field contains the users academic degree.

2014-06-09

Url Description
Group post about square images

Profile pictures will change from rectangular to square formats. New square formats will be available within the next weeks. The current rectangular images will be available for 6 more months (until January 2015). They will show a square image plus a white bar to stick to the original format (see group post for details). Changes will not go live before mid-July 2014.

2014-05-16

Url Description
POST /v1/users/me/professional_expe...

Added call to create a company in the users professional experience

PUT /v1/users/me/professional_exper...

Added call to update a company in the users professional experience

DELETE /v1/users/me/professional_ex...

Added call to delete a company in the users professional experience

PUT /v1/users/me/professional_exper...

Added call to set a primary company in the users professional experience

2014-05-08

Url Description
All calls which return user data

The 'schools' in the users educational background got a new field 'primary school'. The field 'primary school id' that was introduced on 2014-04-22 got removed.

All calls which return user data

The 'companies' list and the 'primary_company' field in the users professional experience got the new fields 'id', 'form of employment', and 'until now'.

All calls which return user data

The users professional experience got a new field 'companies'. The field 'non primary companies' is now deprecated.

2014-04-24

Url Description
GET /v1/users/:user_id/visits

Added the field 'visit count' to visits.

2014-04-22

Url Description
GET /v1/users/:id

The schools in the users educational background got a new field 'primary school id'.

DELETE /v1/users/me/educational_bac...

Added call to delete a school in the users educational background

2014-04-17

Url Description
PUT /v1/users/me/educational_backgr...

Added call to set a primary school in the users educational background

PUT /v1/users/me/educational_backgr...

Added call to update users educational background

POST /v1/users/me/educational_backg...

Added call to create users educational background

2014-04-02

Url Description
PUT /v1/users/me/photo

Added call to upload a users profile photo.

DELETE /v1/users/me/photo

Added call to delete a users profile photo.

2014-03-28

Url Description
GET /v1/users/:id

The schools in the users educational background got a new field 'id'.

2014-03-26

Url Description
PUT /v1/users/me/private_address

Added call to update users private address.

PUT /v1/users/me/business_address

Added call to update users business address.

2014-03-25

Url Description
Message calls

We have to change all private messages and conversation ids. This is caused by a change on a XING internal system. After this change all of the message ids you store will become invalid. This change is only relevant for you, if you cache message id's locally. To dump this incompatibility, you have to invalidate your cache after we did the change and re-request all messages you want to store. Changes will go live on April 22, 2014

Error Responses

The error response can contain an additional field 'errors' with more specific error details.

2014-02-03

Url Description
GET /v1/users/find_by_emails

The search for non-hashed email addresses is now also case sensitive and the additional rate limits have been removed

2014-01-06

Url Description
GET /v1/users/:user_id/legal_inform...

Added call to retrieve user legal information.

2013-10-28

Url Description
User profile

Incompatible change: The empty user profile is returned for blacklisted, deleted and not existing users.

2013-10-16

Url Description
User profile

User profile behavior will experience an incompatible change. The empty profile is introduced. This change will go live on October 28, 2013

2013-07-16

Url Description
Network feed calls

The limitiation of requestable user fields in calls regarding the network feed are removed. From now on it is possible to request all user fields in the network feed calls as well.

GET /v1/users/:id

The user got a new field 'employment status'. This field can be requested in every user-profile call and everywhere, where you can supply a user fields-parameter.

2013-07-09

Url Description
The call structure for the API

Structured request bodies containing XML or JSON can be used for all POST and PUT calls.

2013-06-28

Url Description
POST /v1/users/me/share/link

Added call to share a link in the activity stream.

2013-06-17

Url Description
GET /v1/users/find_by_emails

Bugfix for "find_by_emails" call. When searching for the current users email address in combination with other email addresses, the current users email address could not be resolved.

2013-06-11

Url Description
GET /v1/users/me/contact_ids

New call to retrieve the current users contact IDs.

2013-05-06

Url Description
User profile

User profile behavior will experience an incompatible change. The empty profile is introduced. Changes will not go live before June 1, 2013

2013-04-26

Url Description
GET /v1/users/me/id_card

“Id card” call changed from “experimental” to “production” state.

2013-04-18

Url Description
OAuth process

For test consumers, a warning message will remind the user that the consumer is not meant to be used in production. This is only a UI change and shouldn’t affect any consumer.

2013-04-03

Url Description
GET /v1/users/find_by_emails

The find by emails call can now find users by their hashed email address.

2013-03-19

Url Description
DELETE /v1/users/:user_id/contact_r...

Bugfix for handling the case when trying to delete a contact request to yourself. We now return with an error response.

2013-03-07

Url Description
Conversation calls

Each message can contain attachments. There are new calls to aggregate attachments and request download URLs.

Conversation calls

The latest_messages field is now always included in conversation responses, even if the with_latest_messages parameter is not requested. It contains an empty list, when with_latest_messages was not requested.

2013-02-26

Url Description
Share Button Plugin

Share Button Plugin is now hosted in the Developer Portal.

2013-01-30

Url Description
GET /v1/users/me/conversations/vali...

Added call to check if a message recipient is valid.

2013-01-09

Url Description
POST /v1/users/:user_id/conversations

Bugfix limiting the number of recipients for new conversations to 10. If limit is exceeded we return a new 403 error response. This is a necessary INCOMPATIBLE change.

2012-12-12

Url Description
Feed

The changelog is now also available as an Atom feed

2012-12-05

Url Description
All calls which return user data

Data scrambling for test consumers honors the requested user fields, it will only contain the fields you requested. Additionaly, scrambled data will contain more empty fields: if a field of a requested user is empty, it will stay empty after scrambling and won't get overridden. This way scrambled data should be a little more suitable for testing.

2012-11-28

Url Description
GET /v1/users/me

Added specific call & permission for retrieving only the app user details

POST /v1/users/:user_id/conversations

Bugfix for creating a conversation with multiple recipients.

GET /v1/users/me/id_card

New call “Id Card”. It shows only minimal information about the user that authorized the consumer.

GET /v1/users/:user_id/conversation...

removed parameters limit and offset

2012-11-21

Url Description
OAuth process

Added hint “Privacy information” in the OAuth dialog

POST /v1/users/:id/status_message

New access right "status_message" for writing status messages. Right “users” is not used for this call anymore. This right has been added to all consumers with the “users” right.

PUT /v1/users/:user_id/profile_message

New access right "profile_message" for writing profile messages. Right “users” is not used for this call anymore. This right has been added to all consumers with the “users” right.

2012-11-16

Url Description
Conversation calls

Bugfix for wrong message ordering in conversation calls. Messages are always sorted in descending order by "created_at" again.

2012-11-14

Url Description
Access rights

We introduced two new access rights: “Profile message” and “Status message”. In the future the right “Users” will not include posting status/profile messages anymore. All existing consumers with the right “Users” will get the new rights automatically.

All calls that delete resources

Calls returning a 204 HTTP status code won’t contain a response body anymore.

DELETE /v1/users/:user_id/network/r...

“Block recommendation” call changed from “experimental” to “production” state.

GET /v1/activities/:id

The “changes” field of an activity have been changed and can now be mapped directly to user fields. Call state has been changed to “production”.

GET /v1/users/:id/feed

The “changes” field of an activity have been changed and can now be mapped directly to user fields. Call state has been changed to “production”.

GET /v1/users/:user_id/network_feed

The “changes” field of an activity have been changed and can now be mapped directly to user fields. Call state has been changed to “production”.

2012-11-07

Url Description
GET /v1/users/:user_id/contacts/:co...

Moved call to retrieve contact tags from “experimental” to “production” state.

Conversation calls

Moved all conversations calls from state “experimental” to “production”

GET /v1/users/:user_id/network/:oth...

Moved contact path call from status “experimental” to “production”. Added total field.

2012-10-31

Url Description
OAuth process

Oauth process will not display “register” or “forgot password” links for iOS systems. This is needed to approve applications in the Apple App Store.

Application dashboard

In the Developer Portal, now developers have the possibility to add multiple application descriptions for English and German. This is possible in the production key request form and on the production application detail page. These descriptions will be shown on the OAuth handshake dialog.

GET /v1/users/find_by_emails

Call for finding users by email moved from “experimental” to “production” state. Added total field to ensure consistency across the API.

2012-10-24

Url Description
GET /v1/users/:user_id/network/:oth...

All user fields can be used in “Get contact paths(s)” call

POST /v1/users/invite

All user fields can be used in 'Send invitations' call

2012-10-17

Url Description
Application dashboard

In the Developer Portal it’s now possible to upload a logo for your applications. This is possible in the production key request form and on the production application detail page. These logos will be shown on the OAuth handshake dialog.

2012-10-10

Url Description
OAuth process

The OAuth handshake limitation for test consumer is removed. Every user (e.g. other developers or testers in your team) can authorize a test consumer.

All experimental resources

Enabled access to experimental calls for all test consumers.

OAuth process

The OAuth handshake process has changed slightly. The authentication domain has changed from www.xing.com to login.xing.com. This change should not affect any clients.

2012-09-26

Url Description
GET /v1/users/:user_id/profile_message

From now on, it’s always possible to see your own profile message.

POST /v1/users/:user_id/conversations

The limits for sending messages to non-contacts have changed. The limits for premium members are now 20 messages per month (before it was 20 per day).

2012-09-12

Url Description
Application dashboard

In Developer Portal, now the developers have the possibility to view the details of the production applications.

GET /v1/users/:user_id/contacts/:co...

Added call to retrieve contact tags.

2012-09-05

Url Description
GET /v1/users/:user_id/jobs/recomme...

Added call that returns the job recommendations for a user

GET /v1/jobs/:id

Added view a job posting

GET /v1/jobs/find

Added job posting search

2012-08-08

Url Description
OAuth process

Revised the layout of the whole OAuth dialogue. The permissions have detailed descriptions now.

OAuth process

Allow all protocols for "oauth_callback" parameter in OAuth handshake process.

POST /v1/users/:user_id/conversations

Changed response to always include "latest_messages".

2012-07-25

Url Description
OAuth process

Allow GET as http method for retrieving a request token and for exchanging a request token for an access token.

OAuth process

During OAuth process we don’t ask for rights approval again, if an active access token already exists for the consumer.

PUT /v1/users/:user_id/conversation...

Added call to mark a message as read

POST /v1/users/:user_id/conversations

Added call to create a conversation

POST /v1/users/:user_id/conversatio...

Added call to create a message inside a conversation

2012-07-04

Url Description
GET /v1/users/:user_id/conversations

Added call to retrieve all conversations of a user.

GET /v1/users/:user_id/conversation...

Added call to retrieve a single conversation.

GET /v1/users/:user_id/conversation...

Added call to retrieve all messages belonging to a conversation.

GET /v1/users/:user_id/conversation...

Added call to retrieve a single message belonging to a conversation

OAuth process

When a user denies the authorization request of an application, we display a cancellation page to show the user additional information.

GET /v1/users/:user_id/network_feed

Field "aggregated_by" now contains null-values instead of empty strings (only for "aggregated" = false).

2012-06-20

Url Description
GET /v1/request_token

Custom url schemes are accepted via oauth_callback in the OAuth handshake.

2012-06-01

Url Description
GET /v1/users/:user_id/network_feed
  • New field "aggregated_by" in each activity.

  • An “Article” is now represented with the “Thread” type.

  • The new “targets” field shows the targets of the activity. This is used when “Thread” are present.

2012-04-24

Url Description
GET /v1/authorize

Redirect requests to api.xing.com/v1/authorize to www.xing.com/v1/authorize. If the user is logged in on www.xing.com, no further login is needed, otherwise a temporary login is created that is invalidated after granting or dening access.

2012-03-28

Url Description
DELETE /v1/users/:user_id/network/r...

Added call to block a user recommendation.

2012-03-20

Url Description
GET /v1/users/:user_id/network/reco...

Removed user field limitation.