---
title: "Bulk SkipTrace API"
method: POST
path: "/v1/SkipTraceBatch"
---

# Bulk SkipTrace API

`POST /v1/SkipTraceBatch`

Skiptrace up to 1,000 people in one API call

## Headers

- `x-user-id` string

## Request body

- object
  - `skips` object[], required — An array of contacts that you will would like to have skipped and returned with demographic profiles, including phone numbers and emails
    - `key` integer, required — An internal key provided by you that will help you connect requests going into the API to the responses that hit your webhook
    - `webhook_url` string, required — The location where you would like to receive the responses for each of the individual requests sent to this endpoint
    - `first_name` string
    - `middle_name` string
    - `last_name` string
    - `phone` string — Phone must be 10 digits without any formatting & cannot contain any alpha characters or special characters
    - `email` string
    - `address` string — If you provide address, city, state, and zip then the mailing address parts aren't required but they can still be provided
    - `unit` string
    - `city` string
    - `state` string
    - `zip` string
    - `mail_address` string — If you provide mail_address, mail_city, mail_state, and mail_zip then the regular address parts aren't required but they can still be provided
    - `mail_unit` string
    - `mail_city` string
    - `mail_state` string
    - `mail_zip` string
  - `webcomplete_url` string, required — must be a valid https POST endpoint. The webhook_url should return a https status of 200. The response body can be empty.

## Response `200`

200

- object
  - `batchId` string
  - `batchRequestId` string
  - `requestId` string
  - `responseCode` integer
  - `requestDate` string
  - `responseMessage` string
  - `warnings` string
  - `input` object
    - `key` integer
    - `first_name` string
    - `last_name` string
    - `address` string
    - `city` string
    - `state` string
    - `zip` string
    - `mail_address` string
    - `mail_city` string
    - `mail_state` string
    - `mail_zip` string
  - `output` object
    - `identity` object
      - `names` object[]
        - `prefix` string
        - `firstName` string
        - `lastName` string
        - `middleName` string
        - `suffix` string
        - `fullName` string
      - `address` object
        - `house` string
        - `preDir` string
        - `street` string
        - `postDir` string
        - `strType` string
        - `aptNbr` string
        - `aptType` string
        - `city` string
        - `state` string
        - `county` string
        - `zip` string
        - `z4` string
        - `latitude` string
        - `longitude` string
        - `formattedAdddress` string
        - `lastSeen` string
        - `validSince` string
      - `addressHistory` object[]
        - `house` string
        - `preDir` string
        - `street` string
        - `postDir` string
        - `strType` string
        - `aptNbr` string
        - `aptType` string
        - `city` string
        - `state` string
        - `county` string
        - `zip` string
        - `z4` string
        - `latitude` string
        - `longitude` string
        - `formattedAdddress` string
        - `lastSeen` string
        - `validSince` string
      - `phones` object[]
        - `phone` string
        - `phoneDisplay` string
        - `isConnected` boolean
        - `doNotCall` boolean
        - `phoneType` string
        - `validSince` string
      - `emails` object[]
        - `email` string
        - `emailType` string
    - `demographics` object
      - `dob` string
      - `dod` string
      - `deceased` boolean
      - `gender` string
      - `age` string
      - `images` object[]
        - `url` string
      - `social` object[]
        - `name` string
        - `category` string
        - `domain` string
        - `url` string
      - `education` unknown[]
        - unknown
      - `jobs` object[]
        - `title` string
        - `industry` string
        - `display` string
        - `dates` string
      - `names` object[]
        - `type` string
        - `prefix` string
        - `firstName` string
        - `lastName` string
        - `middleName` string
        - `suffix` string
        - `fullName` string
        - `lastSeen` string
        - `validSince` string
    - `relationships` object[]
      - `type` string
      - `name` object
        - `prefix` string
        - `firstName` string
        - `lastName` string
        - `middleName` string
        - `suffix` string
        - `fullName` string
    - `stats` object
      - `searchResults` integer
      - `names` integer
      - `addresses` integer
      - `phoneNumbers` integer
      - `emailAddresses` integer
      - `associates` integer
      - `jobs` integer
      - `socialProfiles` integer
      - `images` integer
  - `match` boolean
  - `cached` boolean
  - `statusCode` integer
  - `statusMessage` string
  - `credits` integer
  - `live` boolean
  - `requestExecutionTimeMS` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/realestateapi/apis/property-apis.md) · [All operations](https://skmtc.net/realestateapi/apis/property-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/realestateapi/property-apis/versions/8e1eee264b55/schema)