Skip to content

Retrieve a Member

Retrieve a specific member by their external ID.

The get member endpoint allows you to retrieve a specific member from your workspace by their external ID.

Endpoint

MethodUrl
GET/v1.0/members/external-id:{external_id}

Path Parameters

external_id
string
required

The unique identifier from your system to retrieve the member.

Sample Request

Copied
1curl -X GET 'https://api.worklayer.com/v1.0/members/external-id:2ee90898-6b84-4139-8560-d76b40c914ec' \
2-H 'Authorization: Bearer {token}'

Response

An instance of member resource.

Sample Response

Copied
1{
2 "email": "tony@stark.com",
3 "user_id": "a6e5ea2f-7d96-4852-9f46-2383dfd572f7",
4 "external_id": "2ee90898-6b84-4139-8560-d76b40c914ec",
5 "create_time": "2022-04-11T15:18:00.701Z",
6 "update_time": "2022-04-11T15:18:00.701Z"
7}

Errors

  1. Forbidden: API client does not have permission to view workspace members.
  2. Unauthorized: API client does not have valid credentials.
  3. NotFound: The specified member was not found in the workspace.
  4. BadRequest: The external ID provided is not in a valid format.

Last updated on December 18, 2025