Get Identity

Retrieve detailed information for a specific identity managed by Lifecycle Management

Endpoint

GET /api/private/lifecycle_management/identities/{id}

Description

Retrieves identity information for a user managed by a Lifecycle Management policy. The response includes identity attributes (email, title, department), assigned access profiles, and the primary Access Graph node with all discovered properties.

Example Response

{
  "value": {
    "id": "c278b4cc-0a86-4082-ab25-9ba3d163c805",
    "policy_id": "7fbc3710-602d-46d3-adc0-96fe66bd3c86",
    "entity_type": "OktaUser",
    "entity_id": "00u2clxic15YZbO9R0h8",
    "entity_name": "Jane Smith",
    "email": "[email protected]",
    "title": "Solutions Architect",
    "department": "R&D",
    "active": true,
    "access_profiles": [
      "01972d7b-1e2a-7081-b343-b01db30a508a",
      "be6dd1f5-9753-4896-8d80-cb9d7640f139"
    ],
    "access_profile_details": [
      {
        "access_profile_id": "01972d7b-1e2a-7081-b343-b01db30a508a",
        "access_profile_name": "Evergreen Production",
        "created_from": "BIRTHRIGHT"
      }
    ],
    "workflows_triggered": ["Workflow 2"],
    "last_checked_at": "2025-10-03T16:52:57.200184111Z"
  }
}

API Reference

Get Identity

get

Retrieve full identity details for a user managed by a Lifecycle Management policy, including access profiles, attributes, and lifecycle state

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer token authentication using a Veza Personal API key.

Header Format: Authorization: Bearer <your-api-key>

Creating an API Key:

1. Log into your Veza tenant
2. Navigate to Administration → API Keys
3. Generate a new API key and save the value securely

Path parameters

idstringRequired

UUID of the identity (within the LCM policy)

Responses

200

OK

application/json

default

Default error response

application/json

get

/api/private/lifecycle_management/identities/{id}

HTTPcURLJavaScriptPython

GET /api/private/lifecycle_management/identities/{id} HTTP/1.1
Host: your-tenant.cookiecloud.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "value": {
    "policy_id": "text",
    "entity_type": "text",
    "entity_id": "text",
    "provider_id": "text",
    "provider_external_id": "text",
    "workflows_triggered": [
      "text"
    ],
    "last_checked_policy_version": 1,
    "last_checked_at": "2025-12-11T17:34:19.418Z",
    "last_changed_policy_version": 1,
    "last_changed_at": "2025-12-11T17:34:19.418Z",
    "last_changed_policy_task": "text",
    "entity_name": "text",
    "access_profiles": [
      "text"
    ],
    "secondary_identities": [
      {
        "entity_type": "text",
        "entity_id": "text",
        "provider_id": "text",
        "provider_external_id": "text",
        "entity_name": "text"
      }
    ],
    "id": "text",
    "synced_entities": {
      "values": [
        {
          "synced_entity": {
            "table": "text",
            "primary_key": [
              "text"
            ],
            "constraints": [
              {
                "type": 1,
                "field_names": [
                  "text"
                ]
              }
            ]
          },
          "datasource_id": "text",
          "action_name": "text",
          "synced_at": "2025-12-11T17:34:19.418Z",
          "updated_at": "2025-12-11T17:34:19.418Z",
          "created_at": "2025-12-11T17:34:19.418Z",
          "created_from": 1,
          "workflow": "text",
          "is_idp_user": true
        }
      ]
    },
    "title": "text",
    "email": "text",
    "synced_entity_types": [
      "text"
    ],
    "active": true,
    "employee_id": "text",
    "manager_entity_ids": [
      "text"
    ],
    "department": "text",
    "synced_relationships": {
      "values": [
        {
          "synced_relationship": {
            "table": "text",
            "primary_key": [
              "text"
            ],
            "constraints": [
              {
                "type": 1,
                "field_names": [
                  "text"
                ]
              }
            ]
          },
          "synced_identity_entity": {
            "table": "text",
            "primary_key": [
              "text"
            ],
            "constraints": [
              {
                "type": 1,
                "field_names": [
                  "text"
                ]
              }
            ]
          },
          "datasource_id": "text",
          "action_name": "text",
          "synced_at": "2025-12-11T17:34:19.418Z",
          "updated_at": "2025-12-11T17:34:19.418Z",
          "created_at": "2025-12-11T17:34:19.418Z",
          "created_from": 1,
          "workflow": "text"
        }
      ]
    },
    "access_profile_details": [
      {
        "access_profile_id": "text",
        "access_profile_name": "text",
        "identity_id": "text",
        "identity_name": "text",
        "created_from": 1,
        "workflow": "text"
      }
    ],
    "has_property_overrides": true,
    "last_mover_detected_at": "2025-12-11T17:34:19.418Z",
    "requestable_access_profiles": [
      {
        "access_profile_id": "text",
        "access_profile_name": "text",
        "policy_id": "text",
        "workflow_id": "text"
      }
    ],
    "primary_node": {
      "id": "text",
      "type": "text",
      "properties": {},
      "destination_node_count": 1,
      "engagement_access_stats": {
        "engagement_score": 1,
        "over_provisioned_score": 1,
        "total_count": "text",
        "accessed_count": "text"
      },
      "access_stats": {
        "last_used": "2025-12-11T17:34:19.418Z",
        "count": 1,
        "concrete_permissions": [
          "text"
        ],
        "canonical_permissions": [
          "text"
        ]
      },
      "risk_level": 1,
      "raw_permissions": [
        "text"
      ],
      "effective_permissions": [
        "text"
      ],
      "unsupported_conditions": {
        "ANY_ADDITIONAL_PROPERTY": {
          "conditions": [
            "text"
          ]
        }
      },
      "destination_node_percentage_of_total": 1,
      "tags": [
        {
          "type": "text",
          "key": "text",
          "value": "text",
          "properties": {
            "ANY_ADDITIONAL_PROPERTY": null
          }
        }
      ],
      "specified_tags": [
        {
          "type": "text",
          "key": "text",
          "value": "text",
          "properties": {
            "ANY_ADDITIONAL_PROPERTY": null
          }
        }
      ],
      "filtered_raw_permissions": [
        "text"
      ],
      "corresponding_effective_permissions": [
        "text"
      ],
      "single_entity_access_stats": {
        "last_used": "2025-12-11T17:34:19.418Z",
        "last_used_with_events_for": [
          {
            "name": "text",
            "last_used": "2025-12-11T17:34:19.418Z"
          }
        ]
      },
      "additional_node_properties": {
        "role_substitution_recommended_role": "text",
        "role_substitution_reason_for_high_priv_role": "text",
        "role_substitution_error": "text",
        "default_cohort_role_users_in_cohort": [
          "text"
        ],
        "default_cohort_role": "text",
        "default_cohort_role_all_common_roles": [
          "text"
        ],
        "default_cohort_role_error": "text",
        "login_anomaly_detection_stats": [
          {
            "time": "2025-12-11T17:34:19.418Z",
            "login_count": "text",
            "median_login_count": 1,
            "outlier_prediction": 1
          }
        ],
        "outlier_prediction": {
          "prediction": 1,
          "score": 1,
          "contributing_features": [
            {
              "name": "text",
              "value": 1,
              "explanation": "text"
            }
          ]
        },
        "associated_risks": [
          {
            "query_id": "text",
            "suppressed": true,
            "risk_level": 1
          }
        ]
      },
      "integration_type": "text",
      "joined_nodes": {
        "ANY_ADDITIONAL_PROPERTY": {
          "id": "text",
          "type": "text",
          "properties": {},
          "destination_node_count": 1,
          "engagement_access_stats": {
            "engagement_score": 1,
            "over_provisioned_score": 1,
            "total_count": "text",
            "accessed_count": "text"
          },
          "access_stats": {
            "last_used": "2025-12-11T17:34:19.418Z",
            "count": 1,
            "concrete_permissions": [
              "text"
            ],
            "canonical_permissions": [
              "text"
            ]
          },
          "risk_level": 1,
          "raw_permissions": [
            "text"
          ],
          "effective_permissions": [
            "text"
          ],
          "unsupported_conditions": {
            "ANY_ADDITIONAL_PROPERTY": {
              "conditions": [
                "text"
              ]
            }
          },
          "destination_node_percentage_of_total": 1,
          "tags": [
            {
              "type": "text",
              "key": "text",
              "value": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              }
            }
          ],
          "specified_tags": [
            {
              "type": "text",
              "key": "text",
              "value": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              }
            }
          ],
          "filtered_raw_permissions": [
            "text"
          ],
          "corresponding_effective_permissions": [
            "text"
          ],
          "single_entity_access_stats": {
            "last_used": "2025-12-11T17:34:19.418Z",
            "last_used_with_events_for": [
              {
                "name": "text",
                "last_used": "2025-12-11T17:34:19.418Z"
              }
            ]
          },
          "additional_node_properties": {
            "role_substitution_recommended_role": "text",
            "role_substitution_reason_for_high_priv_role": "text",
            "role_substitution_error": "text",
            "default_cohort_role_users_in_cohort": [
              "text"
            ],
            "default_cohort_role": "text",
            "default_cohort_role_all_common_roles": [
              "text"
            ],
            "default_cohort_role_error": "text",
            "login_anomaly_detection_stats": [
              {
                "time": "2025-12-11T17:34:19.418Z",
                "login_count": "text",
                "median_login_count": 1,
                "outlier_prediction": 1
              }
            ],
            "outlier_prediction": {
              "prediction": 1,
              "score": 1,
              "contributing_features": [
                {
                  "name": "text",
                  "value": 1,
                  "explanation": "text"
                }
              ]
            },
            "associated_risks": [
              {
                "query_id": "text",
                "suppressed": true,
                "risk_level": 1
              }
            ]
          },
          "integration_type": "text",
          "joined_nodes": {
            "ANY_ADDITIONAL_PROPERTY": "[Circular Reference]"
          }
        }
      }
    },
    "secondary_nodes": {
      "node_map": {
        "ANY_ADDITIONAL_PROPERTY": {
          "id": "text",
          "type": "text",
          "properties": {},
          "destination_node_count": 1,
          "engagement_access_stats": {
            "engagement_score": 1,
            "over_provisioned_score": 1,
            "total_count": "text",
            "accessed_count": "text"
          },
          "access_stats": {
            "last_used": "2025-12-11T17:34:19.418Z",
            "count": 1,
            "concrete_permissions": [
              "text"
            ],
            "canonical_permissions": [
              "text"
            ]
          },
          "risk_level": 1,
          "raw_permissions": [
            "text"
          ],
          "effective_permissions": [
            "text"
          ],
          "unsupported_conditions": {
            "ANY_ADDITIONAL_PROPERTY": {
              "conditions": [
                "text"
              ]
            }
          },
          "destination_node_percentage_of_total": 1,
          "tags": [
            {
              "type": "text",
              "key": "text",
              "value": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              }
            }
          ],
          "specified_tags": [
            {
              "type": "text",
              "key": "text",
              "value": "text",
              "properties": {
                "ANY_ADDITIONAL_PROPERTY": null
              }
            }
          ],
          "filtered_raw_permissions": [
            "text"
          ],
          "corresponding_effective_permissions": [
            "text"
          ],
          "single_entity_access_stats": {
            "last_used": "2025-12-11T17:34:19.418Z",
            "last_used_with_events_for": [
              {
                "name": "text",
                "last_used": "2025-12-11T17:34:19.418Z"
              }
            ]
          },
          "additional_node_properties": {
            "role_substitution_recommended_role": "text",
            "role_substitution_reason_for_high_priv_role": "text",
            "role_substitution_error": "text",
            "default_cohort_role_users_in_cohort": [
              "text"
            ],
            "default_cohort_role": "text",
            "default_cohort_role_all_common_roles": [
              "text"
            ],
            "default_cohort_role_error": "text",
            "login_anomaly_detection_stats": [
              {
                "time": "2025-12-11T17:34:19.418Z",
                "login_count": "text",
                "median_login_count": 1,
                "outlier_prediction": 1
              }
            ],
            "outlier_prediction": {
              "prediction": 1,
              "score": 1,
              "contributing_features": [
                {
                  "name": "text",
                  "value": 1,
                  "explanation": "text"
                }
              ]
            },
            "associated_risks": [
              {
                "query_id": "text",
                "suppressed": true,
                "risk_level": 1
              }
            ]
          },
          "integration_type": "text",
          "joined_nodes": {
            "ANY_ADDITIONAL_PROPERTY": {
              "id": "text",
              "type": "text",
              "properties": {},
              "destination_node_count": 1,
              "engagement_access_stats": {
                "engagement_score": 1,
                "over_provisioned_score": 1,
                "total_count": "text",
                "accessed_count": "text"
              },
              "access_stats": {
                "last_used": "2025-12-11T17:34:19.418Z",
                "count": 1,
                "concrete_permissions": [
                  "text"
                ],
                "canonical_permissions": [
                  "text"
                ]
              },
              "risk_level": 1,
              "raw_permissions": [
                "text"
              ],
              "effective_permissions": [
                "text"
              ],
              "unsupported_conditions": {
                "ANY_ADDITIONAL_PROPERTY": {
                  "conditions": [
                    "text"
                  ]
                }
              },
              "destination_node_percentage_of_total": 1,
              "tags": [
                {
                  "type": "text",
                  "key": "text",
                  "value": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  }
                }
              ],
              "specified_tags": [
                {
                  "type": "text",
                  "key": "text",
                  "value": "text",
                  "properties": {
                    "ANY_ADDITIONAL_PROPERTY": null
                  }
                }
              ],
              "filtered_raw_permissions": [
                "text"
              ],
              "corresponding_effective_permissions": [
                "text"
              ],
              "single_entity_access_stats": {
                "last_used": "2025-12-11T17:34:19.418Z",
                "last_used_with_events_for": [
                  {
                    "name": "text",
                    "last_used": "2025-12-11T17:34:19.418Z"
                  }
                ]
              },
              "additional_node_properties": {
                "role_substitution_recommended_role": "text",
                "role_substitution_reason_for_high_priv_role": "text",
                "role_substitution_error": "text",
                "default_cohort_role_users_in_cohort": [
                  "text"
                ],
                "default_cohort_role": "text",
                "default_cohort_role_all_common_roles": [
                  "text"
                ],
                "default_cohort_role_error": "text",
                "login_anomaly_detection_stats": [
                  {
                    "time": "2025-12-11T17:34:19.418Z",
                    "login_count": "text",
                    "median_login_count": 1,
                    "outlier_prediction": 1
                  }
                ],
                "outlier_prediction": {
                  "prediction": 1,
                  "score": 1,
                  "contributing_features": [
                    {
                      "name": "text",
                      "value": 1,
                      "explanation": "text"
                    }
                  ]
                },
                "associated_risks": [
                  {
                    "query_id": "text",
                    "suppressed": true,
                    "risk_level": 1
                  }
                ]
              },
              "integration_type": "text",
              "joined_nodes": {
                "ANY_ADDITIONAL_PROPERTY": "[Circular Reference]"
              }
            }
          }
        }
      }
    },
    "identity_action_runs": {
      "action_run_info_map": {
        "ANY_ADDITIONAL_PROPERTY": {
          "state": 1,
          "last_run_at": "2025-12-11T17:34:19.418Z"
        }
      }
    },
    "last_processed_at": "2025-12-11T17:34:19.418Z",
    "workflow_failures": {
      "workflow_failures": {
        "ANY_ADDITIONAL_PROPERTY": {
          "first_failed_at": "2025-12-11T17:34:19.418Z",
          "last_failed_at": "2025-12-11T17:34:19.418Z",
          "consecutive_failures": 1,
          "workflow_last_updated": "2025-12-11T17:34:19.418Z",
          "is_mover": true
        }
      }
    }
  }
}