List entity personnel

GET

https://api.sureshake.com/v2/entities/{id}/personnel

Path parameters

id
string
required
format: uuid

Query parameters

includeInactive
optional
boolean
default: false

Returns

200

Default Response

JSON

id
string
required
format: uuid
entityId
string
required
format: uuid
userId
string
or null
required
externalName
string
or null
required
externalEmail
string
or null
required
externalPhone
string
or null
required
title
string
required
role
string
required
department
string
or null
required
status
string
required
isKeyPerson
boolean
required
startDate
string
required
endDate
string
or null
required
notes
string
or null
required
invitationSent
boolean
required
invitationSentAt
string
or null
required
createdBy
string
required
createdAt
string
required
updatedAt
string
required
deletedAt
string
or null
required
deletedBy
string
or null
required
displayName
string
required
displayEmail
string
or null
required
isActive
boolean
required
isExternal
boolean
required
hasInvitation
boolean
required
hasAccount
boolean
required

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

503

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

[ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "entityId": "156e622c-6cdf-4c27-9bc9-2f2db69919f5", "userId": "string", "externalName": "string", "externalEmail": "string", "externalPhone": "string", "title": "string", "role": "string", "department": "string", "status": "string", "isKeyPerson": true, "startDate": "string", "endDate": "string", "notes": "string", "invitationSent": true, "invitationSentAt": "string", "createdBy": "string", "createdAt": "string", "updatedAt": "string", "deletedAt": "string", "deletedBy": "string", "displayName": "string", "displayEmail": "string", "isActive": true, "isExternal": true, "hasInvitation": true, "hasAccount": true } ]