List Access Profile Members

View all members of a specific access profile version

Endpoint

GET /api/private/lifecycle_management/access_profiles/{id}/versions/{version}/members

Description

Lists all identities that are currently members of a specific Access Profile version. Members are identities that will receive (or have received) the entitlements defined in the Access Profile.

This endpoint returns details about each member, including:

• Which identity is a member

• How the membership was created (manually added, from birthright policy, etc.)

• Associated workflow information

API Reference

get

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

access_profile_idstringRequired

version_numberinteger · int32Required

Responses

200

OK

application/json

default

Default error response

application/json

get

/api/private/lifecycle_management/access_profiles/{access_profile_id}/versions/{version_number}/members

HTTPcURLJavaScriptPython

GET /api/private/lifecycle_management/access_profiles/{access_profile_id}/versions/{version_number}/members HTTP/1.1
Host: your-tenant.cookiecloud.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "values": [
    {
      "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-15T22:44:16.025Z",
      "last_changed_policy_version": 1,
      "last_changed_at": "2025-12-15T22:44:16.025Z",
      "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-15T22:44:16.025Z",
            "updated_at": "2025-12-15T22:44:16.025Z",
            "created_at": "2025-12-15T22:44:16.025Z",
            "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-15T22:44:16.025Z",
            "updated_at": "2025-12-15T22:44:16.025Z",
            "created_at": "2025-12-15T22:44:16.025Z",
            "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-15T22:44:16.025Z",
      "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-15T22:44:16.025Z",
          "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-15T22:44:16.025Z",
          "last_used_with_events_for": [
            {
              "name": "text",
              "last_used": "2025-12-15T22:44:16.025Z"
            }
          ]
        },
        "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-15T22:44:16.025Z",
              "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,
            "permissions": "[Circular Reference]",
            "engagement_access_stats": {
              "engagement_score": 1,
              "over_provisioned_score": 1,
              "total_count": "text",
              "accessed_count": "text"
            },
            "access_stats": {
              "last_used": "2025-12-15T22:44:16.025Z",
              "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-15T22:44:16.025Z",
              "last_used_with_events_for": [
                {
                  "name": "text",
                  "last_used": "2025-12-15T22:44:16.025Z"
                }
              ]
            },
            "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-15T22:44:16.025Z",
                  "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": "[Circular Reference]"
          }
        }
      },
      "secondary_nodes": {
        "node_map": {
          "ANY_ADDITIONAL_PROPERTY": {
            "id": "text",
            "type": "text",
            "properties": {},
            "destination_node_count": 1,
            "permissions": "[Circular Reference]",
            "engagement_access_stats": {
              "engagement_score": 1,
              "over_provisioned_score": 1,
              "total_count": "text",
              "accessed_count": "text"
            },
            "access_stats": {
              "last_used": "2025-12-15T22:44:16.025Z",
              "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-15T22:44:16.025Z",
              "last_used_with_events_for": [
                {
                  "name": "text",
                  "last_used": "2025-12-15T22:44:16.025Z"
                }
              ]
            },
            "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-15T22:44:16.025Z",
                  "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,
                "permissions": "[Circular Reference]",
                "engagement_access_stats": {
                  "engagement_score": 1,
                  "over_provisioned_score": 1,
                  "total_count": "text",
                  "accessed_count": "text"
                },
                "access_stats": {
                  "last_used": "2025-12-15T22:44:16.025Z",
                  "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-15T22:44:16.025Z",
                  "last_used_with_events_for": [
                    {
                      "name": "text",
                      "last_used": "2025-12-15T22:44:16.025Z"
                    }
                  ]
                },
                "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-15T22:44:16.025Z",
                      "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": "[Circular Reference]"
              }
            }
          }
        }
      },
      "identity_action_runs": {
        "action_run_info_map": {
          "ANY_ADDITIONAL_PROPERTY": {
            "state": 1,
            "last_run_at": "2025-12-15T22:44:16.025Z"
          }
        }
      },
      "last_processed_at": "2025-12-15T22:44:16.025Z",
      "workflow_failures": {
        "workflow_failures": {
          "ANY_ADDITIONAL_PROPERTY": {
            "first_failed_at": "2025-12-15T22:44:16.025Z",
            "last_failed_at": "2025-12-15T22:44:16.025Z",
            "consecutive_failures": 1,
            "workflow_last_updated": "2025-12-15T22:44:16.025Z",
            "is_mover": true
          }
        }
      }
    }
  ],
  "member_details": [
    {
      "access_profile_id": "text",
      "access_profile_name": "text",
      "identity_id": "text",
      "identity_name": "text",
      "created_from": 1,
      "workflow": "text"
    }
  ]
}

Request schema

Path parameters

Path parameter	Type	Required?	Description
access_profile_id	string	Required	Unique identifier of the access profile
version_number	integer	Required	Version number of the access profile

Request Examples

curl -X GET "$BASE_URL/api/private/lifecycle_management/access_profiles/01964a45-6146-75ca-8fb7-6c4d01fc53f2/versions/1/members" \
  -H "authorization: Bearer $VEZA_TOKEN"

Response Examples

{
  "member_details": [
    {
      "access_profile_id": "01964a45-6146-75ca-8fb7-6c4d01fc53f2",
      "access_profile_name": "Salesforce Developer",
      "created_from": "ACCESS_PROFILE_MEMBERSHIP",
      "identity_id": "01964514-3fa9-7d76-be82-ef9732de637d",
      "identity_name": "john_doe",
      "workflow": ""
    },
    {
      "access_profile_id": "01964a45-6146-75ca-8fb7-6c4d01fc53f2",
      "access_profile_name": "Salesforce Developer",
      "created_from": "ACCESS_PROFILE_MEMBERSHIP",
      "identity_id": "01964514-3fa9-7d76-be82-ef9732de638e",
      "identity_name": "jane_smith",
      "workflow": ""
    }
  ]
}

Response Fields

Field	Type	Description
access_profile_id	string	ID of the access profile
access_profile_name	string	Name of the access profile
created_from	string	How the membership was created (typically "ACCESS_PROFILE_MEMBERSHIP")
identity_id	string	Unique identifier of the identity/user
identity_name	string	Display name of the identity/user
workflow	string	Associated workflow information (if any)

Member Sources: The created_from field indicates how the identity became a member of the access profile. Most manual additions show "ACCESS_PROFILE_MEMBERSHIP".

Response Structure: The complete API response also includes a values array containing full PolicyIdentity objects. This documentation focuses on the member_details array as it provides the most relevant information for managing access profile membership.

Related Operations

• Update Access Profile Members - Add or remove members from an access profile

• List Access Profiles - Get access profile details including version numbers