---
title: "List Unverified Contacts"
method: GET
path: "/core/v1/contacts/unverified"
tags: ["Contact Verification"]
---

# List Unverified Contacts

`GET /core/v1/contacts/unverified`

Returns a list of contacts, related to domains within your account, that require verification as per ICANN procedures.
When a new domain is created, unverified contacts are not immediately available in API responses.  Records are added by a scheduled process that runs approximately every 10 minutes.  As a result, there may be up to a 10-minute delay before unverified contacts appear in the API. This delay also applies to related events such as webhooks or other downstream systems that depend on contact verification data.

## Query parameters

- `perPage` integer — Maximum number of records to return per page for paginated list endpoints.
- `page` integer

## Response `200`

A successful response containing an array of unverified contacts.  This array may be empty if there are no unverified contacts related to domains in your account.

- UnverifiedContactsResponse — A list of unverified contacts that relate to your account.
  - `unverifiedContacts` UnverifiedContact[], required
    - `verificationId` integer, required — The id of the verification record for the contact. Please note, this is different than the `contact_id` that may be returned in other API contexts. This id specifically relates to the verification record and will be different than a `contact_id` for the same contact record in other contexts.
    - `createDate` string, date-time, required — The date the record requiring verification was created.
    - `verifyBy` string, date-time, required — The date/time that the contact record **must** be verified by. If the contact record is not verified by this date, the domain may become locked by the registry. This is typically 15 days from the creation date of the verification record, but may vary by TLD and registry.
    - `email` string, email, required — The email address of the contact to be verified. This is the primary identifier used for verification.
    - `domains` string[], required — A list of the domains that the contact verification record is applied to.
  - `from` integer, required — From is the starting record for the current page.
  - `to` integer, required — To is the ending record for the current page.
  - `lastPage` integer, required — LastPage is the identifier for the final page of results. This value will be null if there is not a previous result page.
  - `nextPage` integer, nullable, required — NextPage is the identifier for the next page of results. This value will be null if there is not a next page of results.
  - `totalCount` integer, required — TotalCount is total number of domains returned for request.

## Other responses

- `400` — Bad request - Invalid query parameters.
- `401` — Unauthorized.
- `403` — Forbidden - you do not have permission to perform this action.
- `405` — Method not allowed.
- `429` — Rate limit has been exceeded.
- `500` — Internal server error.
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

[API](https://skmtc.dev/name/apis/name-com-core-api.md) · [All operations](https://skmtc.dev/name/apis/name-com-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/name/name-com-core-api/revisions/a37d4cbd3991/schema)