Get Identity¶

Endpoint: GET /api/identities/{id}

Description: Returns a single identity by its unique identifier.

Path Parameters¶

Parameter	Type	Required	Description
`id`	string (GUID)	Yes	The unique identifier of the identity.

Response Attributes¶

Field	Type	Description
`id`	string (GUID)	Unique identifier of the identity.
`kind`	string	Resource type. Always `Identity`.
`firstName`	string	First name.
`lastName`	string	Last name.
`emailAddress`	string	Email address.
`type`	string	Identity type. Values: `Employee`, `Service Account`, `Vendor`, `Shared`, `Mailbox`, `Client`, `Temporary`, `Administrator`, `Auditor`, `Unknown`.
`title`	string	Job title.
`company`	string	Company name.
`division`	string	Division name.
`department`	string	Department name.
`office`	string	Office location.
`supervisorName`	string	Display name of the supervisor.
`createdDate`	string (ISO 8601)	Date the identity record was originally created in the source system.
`updatedDate`	string (ISO 8601)	Date the identity record was last updated in the source system.
`firstSeenDate`	string (ISO 8601)	Date the identity was first imported into Permission Assist.
`inactivatedDate`	string (ISO 8601)	Date the identity was deactivated. `null` if active.
`status`	string	Current status. Values: `Active`, `Disabled`, `Removed`.

Sample Response¶

{
  "id": "d4a7e2b1-3f5c-4a8d-9e6b-1c2d3e4f5a6b",
  "kind": "Identity",
  "firstName": "Sarah",
  "lastName": "Chen",
  "emailAddress": "schen@firstbankofvalkyrie.com",
  "type": "Employee",
  "title": "Senior Loan Officer",
  "company": "First Bank of Valkyrie",
  "division": "Commercial Lending",
  "department": "Business Loans",
  "office": "Fargo Main",
  "supervisorName": "Martinez, Robert",
  "createdDate": "2023-03-15T14:30:00Z",
  "updatedDate": "2025-11-20T09:15:00Z",
  "firstSeenDate": "2023-03-16T02:00:00Z",
  "inactivatedDate": null,
  "status": "Active"
}

Error Response (404)¶

{
  "error": "not_found",
  "message": "Identity with id d4a7e2b1-3f5c-4a8d-9e6b-1c2d3e4f5a6b not found",
  "correlationId": "a1b2c3d4e5f6789012345678abcdef01"
}