---
title: "Bulk SkipTrace API (v2)"
method: POST
path: "/v2/SkipTraceBatch"
---

# Bulk SkipTrace API (v2)

`POST /v2/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
  - `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)