# Get org person

**GET /orgs/people/{personId}**




## Servers
- https://open.api.missionx.ai/v2: https://open.api.missionx.ai/v2 ()


## Authentication methods
- O auth2


## Parameters

#### Path parameters
- **personId** (string)
  The organization's person unique document ID, i.e. `people[].person._id`.

#### Query parameters
- **withArchived** (string)
  If set to true, the response will include people removed from the organization.


## Responses
### 200: Successful response

#### Body Parameters: application/json (object)
- **_id** (string(ObjectId))
  The unique document ID.
- **permission** (string)
  Determines the person's permissions within the organization. The `member` and `projectManager` do not have access to the organization space, they are just employees. A `manager` has limited access to the organization space, like managing basic organizational settings, invoice information, leave requests, etc. An `admin` has full control over the organization. The `observer` can view everything, but not change anything.
- **startDate** (string(date-time))
  The start date in ISOString format. See [.toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **endDate** (string(date-time))
  The end date in ISOString format. See [.toISOString()](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString).
- **archived** (boolean)
  If true, the person has been removed from the organization.
- **person** (object)
  
- **role** (string)
  Reference to an org role, i.e. `org.roles[]._id`
- **roleTitle** (string)
  The title of the role. E.g. Director of Sales
- **email** (string(email))
  The person's email in the organization.
- **departments** (array[string(ObjectId)])
  Departments this person belongs to. References the organization's departments, i.e. `org.departments[]._id`.
- **office** (string(ObjectId))
  The person's office location. References the organization's offices, i.e. `org.offices[]._id`.
- **invitePendingSince** (number(integer))
  The timestamp the person was invited to the organization. If this field is defined, it means that the invitation is still pending.
- **canCreateProjects** (boolean)
  If true, this person can create projects for this organization.
- **canApproveRoles** (boolean)
  If true, this person can approve project roles.
- **canApproveLeaves** (boolean)
  If true, this person can approve leave requests.
- **customProperties** (array[object])
  Display custom properties on the organization's person information page that are not supported by missionX out of the box.

### 400: Bad Request

#### Body Parameters: application/json (object)
- **message** (string)
  An error message.
- **code** (string)
  An error code to handle specific error responses.
- **data** (object)
  Optionally, additional data to help handle the error.

### 404: Not Found

### 500: Internal Server Error

#### Body Parameters: application/json (object)
- **message** (string)
  An error message.
- **code** (string)
  An error code to handle specific error responses.
- **data** (object)
  Optionally, additional data to help handle the error.


[Powered by Bump.sh](https://bump.sh)