RErecruitwithatlas
People

Bulk lookup people by identity

Changed on

Use this endpoint to check whether a batch of contacts already exist in your Atlas account - before importing or syncing them from another system.

You send a list of contact details (up to 100 at a time), and Atlas will automatically figure out what type each one is based on its format - for example, anything that looks like an email address will be treated as an email, a URL containing "linkedin.com" will be treated as a LinkedIn profile, and a string of digits will be treated as a phone number.

For each item you send, Atlas tells you:

  • Whether it recognised the format (if not, it returns "invalid identity format")
  • Whether a person with that contact detail already exists in your agency
  • The ID of that person, if they exist (useful for linking records)

This is particularly useful when you have a spreadsheet or external system full of contacts and you want to quickly find out which ones are already in Atlas before deciding what to do with the rest.

post/api/v1/people/lookup

Request

Request body

identitiesstring[] required

List of identity strings to look up (max 100). Type is auto-detected from the value pattern.

Example request

{
  "identities": [
    "test@example.com",
    "+380631817386",
    "www.linkedin.com/in/pavel",
    "/in/jshlosberg",
    "in/jane-doe"
  ]
}

Response

Lookup results, one entry per input identity in the same order

status'ok' required

Changes