Help Center
Login Sign up
  1. Home
  2. API reference
  3. API documentation (JSON/XML)
  4. Tasks
  5. Contact tasks

Contact list

API reference (XML/JSON) · Updated 2026-03-24

Function

This task type generates a list with certain details of domain contacts. Additional details can be displayed with the <key> key in XML or query parameters in JSON.

You can find more information about list queries here. 

Description

POST ​/contact​/_search

Query parameters

The data of the following keywords can be queried with the query parameter ?keys[]=:

  • address
  • alias
  • city
  • comment
  • country
  • created
  • domainsafe
  • email
  • fax
  • fname
  • id
  • lname
  • organization
  • pcode
  • phone
  • sip
  • state
  • title
  • type
  • updated
  • verification
{
   "filters": [
      {
         "key": "id",
         "value": "23142212",
         "operator": "EQUAL",
         "link": "AND",
         "filters": []
      }
   ],
   "view": {
      "limit": 5,
      "offset": 0,
      "children": true,
      "from": "2019-03-01T14:31:33.6306444Z",
      "to": "2019-05-09T14:00:33.6306444Z"
   },
   "type": "DESC"
}
{
    "stid": "20190628-app3-dev-11544",
    "status": {
        "code": "S0304",
        "text": "Domain contact information was inquired successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Contact",
        "summary": 1
    },
    "data": [
        {
            "created": "2019-05-09T10:09:25.000+0200",
            "updated": "2019-06-12T10:22:00.000+0200",
            "id": 23142212,
            "owner": {
                "context": 4,
                "user": "customer"
            },
            "alias": "johndoe",
            "type": "PERSON",
            "organization": "Company",
            "title": "Dr.",
            "city": "example city",
            "country": "US",
            "state": "",
            "verification": "SUCCESS",
            "fname": "john",
            "lname": "doe",
            "address": [
                "example street"
            ],
            "pcode": "54321",
            "phone": "+49-321-54321",
            "fax": "+49-321-54321"
        }
    ]
}