Skip to main content
GET
/
core
/
v1
/
contacts
/
unverified
List Unverified Contacts
curl --request GET \
  --url https://api.dev.name.com/core/v1/contacts/unverified \
  --header 'Authorization: Basic <encoded-value>'
{
  "unverifiedContacts": [
    {
      "verificationId": 4897668,
      "createDate": "2025-01-01T15:35:06Z",
      "verifyBy": "2025-01-16T15:35:06Z",
      "email": "[email protected]",
      "domains": [
        "<string>"
      ]
    }
  ],
  "from": 1,
  "to": 25,
  "lastPage": 123,
  "nextPage": 123,
  "totalCount": 123
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Query Parameters

​
perPage
integer<int32>
default:100

PerPage is the number of records to return per request. If not passed in the request, the default value is 100 records.

Required range: x >= 1
Example:

100

​
page
integer<int32>
default:1

Page is which page to return. If not passed in the request, the default page is 1.

Required range: x >= 1
Example:

2

Response

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.

A list of unverified contacts that relate to your account.

​
unverifiedContacts
object[]
required
​
from
integer<int32>
required

From is the starting record for the current page.

Example:

1

​
to
integer<int32>
required

To is the ending record for the current page.

Example:

25

​
lastPage
integer<int32>
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<int32> | null
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<int32>
required

TotalCount is total number of domains returned for request.