Contact Existence

POST 
/v1/enrich/contactExistence

Check for the existence of specific contact fields for a given contact from upcell’s database. This endpoint accepts a Contact object and a list of fields to check. The response contains a map where the key is the field and value is true/false for the existence of that field in upcell's database.

Request Body

Field	Type	Description	Required
contact	Contact	Contact data to match to check for existence of fields. Supports: linkedinUrl, firstName, lastName, title, companyName, companyDomain, companySocialUrl, email, personalEmail	✅ Yes
existenceFields	array	List of fields to check for existence (e.g., mobile).	✅ Yes

Possible Existence Field Values

• mobile

---

Example Request (JSON)

{
    "contact": {
        "linkedinUrl": "https://www.linkedin.com/in/marklbedard/"
    },
    "existenceFields": [
        "mobile"
    ]
}

---

Response

The response returns a map of fields to a boolean (true/false) if that field exists for the given contact in upcell's database.

Example Success Response

{
    "fieldsExistence": {
        "mobile": true
    }
}

---

Error Handling

The API returns appropriate error messages with status codes if something goes wrong.

Error Code	Message	Description
400	Invalid Request	Verify your request is properly formatted
401	Unauthorized	Verify you are using a valid API key
500	Internal Server Error	An unexpected error occurred.

Example Error Response

{
  "error": {
    "code": 400,
    "message":"Contact is required for existence check"
  }
}

Request

Responses

200

Successful response