GET user/…/third-party-ids

Retrieves the collection of third-party IDs of a user account.

Users are always permitted to retrieve the details of their own user account. Retrieving the details of another user account is only permitted if the calling user is an administrator (staff user) of the same organization that manages the requested user account.

Resource URL

https://www.drillster.com/api/2.1.1/user/{user_id}/third-party-ids

Response

A list of 2.1.1 ThirdPartyId objects.

Parameters

Field	Description
`user_id` required	The user ID of the user to retrieve details for. The following types can be used: The account ID `self` for the user performing the request An email address registered for the user A third-party ID registered for the user, using `$` as separator. The value must be URL-encoded: `<third-party>%24<ID>`

Example request

GET https://www.drillster.com/api/2.1.1/user/self/third-party-ids

Response

[
  {
    "thirdParty": "ACME",
    "id": "2058392"
  }
]

Error responses

The following error situations are possible:

ID	Response code	Description
`nonexistent_user`	404 (Not found)	Requested user not found
`no_access`	403 (Forbidden)	Caller does not have access to requested user
`multiple_accounts`	400 (Bad request)	The e-mail address is used by multiple accounts

Last updated on 2025-04-18