List verified contact delegations

2 minute read

GET https://www.digicert.com/services/v2/user/delegation

Use this endpoint to list delegations in which a verified contact grants a CertCentral user authority to approve certificate orders on the verified contact’s behalf.

Authenticate as a CertCentral administrator or manager with the Delegate Verified Contacts permission. Without the user_id query parameter in the API request, the response includes all delegations for verified contacts in the authenticated user’s account. Supply the user_id to list delegations for one delegated-to user.

Example request and response

curl -X GET \
  'https://www.digicert.com/services/v2/user/delegation?user_id=123456' \
  -H 'X-DC-DEVKEY: {{api_key}}'

200 OK

{
  "delegations": [
    {
      "id": 987654,
      "user_id": 123456,
      "delegated_verified_contact_id": 456789,
      "verified_contact_first_name": "Jane",
      "verified_contact_last_name": "Smith",
      "verified_contact_email": "jane.smith@example.com",
      "organization_id": 654321,
      "status": "pending",
      "email_last_sent": "2026-09-30 12:00:00",
      "date_created": "2026-09-30 12:00:00",
      "requested_by_user_id": 111222,
      "delegation_group_id": "<group identifier>"
    }
  ]
}

URL query parameters

Name	Req/Opt	Type	Description
user_id	optional	int	Returns the delegations for the specified delegated-to `user_id`. Omit the `user_id` parameter from the URL to list all delegations for verified contacts in the authenticated user’s account.

Request parameters

This endpoint does not require any request parameters.

Response parameters

Name	Type	Description
delegations	array	Delegation records returned by the request.
.. id	int	Delegation ID. Use this ID to resend an approval email or delete the delegation.
.. user_id	int	ID of the user receiving delegated approval authority.
.. delegated_verified_contact_id	int	ID of the verified contact granting authority.
.. verified_contact_first_name	string	Verified contact’s first name.
.. verified_contact_last_name	string	Verified contact’s last name.
.. verified_contact_email	string	Verified contact’s email address.
.. organization_id	int	Organization ID associated with the delegation.
.. status	string	Delegation status. Status values:`pending`, `approved`, or `rejected`.
.. email_last_sent	string	Timestamp of the most recent delegation approval email.
.. date_created	string	Timestamp when the delegation record was created.
.. requested_by_user_id	int	ID of the user who requested the delegation.
.. delegation_group_id	string	Identifier linking records created by the same delegation request.