Get a home member

GET/homes/{homeId}/members/{userId}

Base URL: https://api.tinkermode.com

Get the home member with the specified user ID.

Authentication

Send an Authorization header of the form ModeCloud <AUTH_CODE>.

Must contain a user, service account, or project API key.

Path parameters

NameTypeRequiredConstraintsDescription
homeIdintegerYesThe unique ID for a specified home.
userIdintegerYesThe unique ID for a specified user.

Responses

200 Successfully retrieved home member from the specified home ID and user ID.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
creationTimestringNoread-only (server-generated); format: date-timeTimestamp when member was added to home.
emailstringNoread-only (server-generated)Email address of member.
namestringNoread-only (server-generated)Display name of member.
phoneNumberstringNoread-only (server-generated); pattern: ^(\+)([0-9]{5,})$Phone number used by member. Must begin with country code (beginning with the '+' symbol).
roleunknownNoone of: owner, memberIf the role is OWNER, this member can add or remove other members.
userIdintegerYesread-only (server-generated)User ID of home member.
verifiedbooleanYesread-only (server-generated)True if member is a verified user.

Response example

{
  "creationTime": "2019-12-18T19:00:26.521Z",
  "name": "Jane Doe",
  "phoneNumber": "+1719999999",
  "role": "owner",
  "userId": 2081,
  "verified": true
}

401 Authorization is required to access this resource.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

403 Request failed because of denied permission.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

404 The requested member does not exist or is not accessible.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

429 Request failed because of rate limit.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

500 An unexpected error has occurred.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.

503 The service is temporarily unavailable.

Content type: application/json

PropertyTypeRequiredConstraintsDescription
dataobjectNoread-only (server-generated)Any relevant data related to error.
reasonstringYesread-only (server-generated)Reason of error.