---
title: "List verified contact delegations"
source_url: https://dev.digicert.com/certcentral-apis/services-api/users/list-verified-contact-delegations.html
api_method: GET
api_endpoint: "/services/v2/user/delegation"
api_url: "https://www.digicert.com/services/v2/user/delegation"
---

**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.


> **Info**
>
> 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

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

## 200 OK

```json
{
  "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

<table class="params-table">
<thead>
<tr><th>Name</th><th>Req/Opt</th><th>Type</th><th>Description</th></tr>
</thead>
<tbody>
<tr><td>user_id</td><td>optional</td><td>int</td><td>Returns the delegations for the specified delegated-to <code>user_id</code>.
<br>
Omit the <code>user_id</code> parameter from the URL to list all delegations for verified contacts in the authenticated user’s account.</td></tr>
</tbody>
</table>

## Request parameters
This endpoint does not require any request parameters.

## Response parameters

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