Skip to main content

Get a Member

This article provides an example of calling the Get a Member API.

tip
  • This API is only available for spaces on the enterprise plan.(Learn more).
  • Only the primary admin and sub-admins who can manage members can use this API.

Example: Get a member's information

Suppose you have a space and you want to get the information of member "John".

Follow these steps:

  1. Get your API Token. (How to get it)

  2. Get your Space ID. (How to get it)

  3. Get the unitId of the member "John". (How to get it)

    What is unitId?

  4. Open the terminal on your computer and execute the following code to send a query request to the server (assuming the spaceId is spcjXzqVrjaP3 and the unitId of member "John" is kD8tPcZ3fYxSjV9qWvL5X2TmQbN1nR6):

    Note: The member's email and mobile number are considered as sensitive data. To get them, you need to pass the Query parameter: sensitiveData=true.

    curl -X GET \
    "https://aitable.ai/fusion/v1/spaces/spcjXzqVrjaP3/members/kD8tPcZ3fYxSjV9qWvL5X2TmQbN1nR6?sensitiveData=true" \
    -H "Authorization: Bearer {Your API Token}"
  5. The server will return the following JSON data. The data under "data" is the information of the member:

    For the meaning of each parameter in the response, please check the API Reference.

    {
    "code": 200,
    "message": "SUCCESS",
    "success": true,
    "data":{
    "member":
    {
    "unitId": "kD8tPcZ3fYxSjV9qWvL5X2TmQbN1nR6",
    "name": "John",
    "mobile": {
    "number": "13000111000",
    "areaCode": "+86"
    },
    "email":"John@aitable.ai",
    "avatar": "https://s1.aitable.ai/public/2023/05/16/00a91wbb47fd0594fbc975d2d764a45q",
    "status": 1,
    "type": "Member",
    "teams": [
    {
    "unitId": "VS1SejiywaMWbiGMEHAohh62T9EPmmlh",
    "name": "team A",
    "sequence": 1,
    "parentUnitId": "0",
    "roles": [
    {
    "unitId": "zJ6TuQvH2RtNfSx9eY7XKgD1oWcE5pV",
    "name": "role A",
    "sequence": 1
    }
    ]
    }
    ],
    "roles": [
    {
    "unitId": "c9EQqwN1pOEgjXqKJznPF6xF8t5TYTf0",
    "name": "role B",
    "sequence": 2
    }
    ]
    }
    }
    }