Skip Trace API

About

The Skip Trace API lets you run skip traces from your own code — any server, script, or third-party tool that can make HTTPS requests. Send an address (and optionally a person or entity name), receive the people we can match to that property — names, phones, and emails — in the same response. Each person is labelled with how they are connected to the property, so you can tell a deed owner from a relative before you dial. Each call consumes one skip-trace credit from your organization’s balance, the same way an in-app skip trace does.

Generating an API key

1. Open the Integrations page

   From the left sidebar, click Integrations under the Automations section.

2. Find the Skip Trace API card

   It lives under the Developer section. The card is only visible to organization admins — if you do not see it, ask an admin to generate a key for you.

3. Click Generate API key

   Goliath shows your new key once, in a dialog. Copy it now and store it in your secrets manager — the full key is never shown again. After you close the dialog, only the first and last characters are visible in the UI.

4. Use the key

   Pass it as a Bearer token on every request:

   Authorization: Bearer gd_...

Making a request

Endpoint

POST https://server.goliathdata.com/api/v1/skiptrace

Headers

Example

curl -X POST https://server.goliathdata.com/api/v1/skiptrace \
  -H "Authorization: Bearer gd_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "address": {
      "line1": "123 Main St",
      "city": "Austin",
      "state": "TX",
      "zip": "78701"
    }
  }'

const res = await fetch("https://server.goliathdata.com/api/v1/skiptrace", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.GOLIATH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    address: {
      line1: "123 Main St",
      city: "Austin",
      state: "TX",
      zip: "78701",
    },
  }),
})
const data = await res.json()

Request body

Response

{
  "id": "3f21d6e0-a8a4-4a0e-8f25-9e9a74c37c2e",
  "status": "records_found",
  "persons": [
    {
      "firstName": "Jane",
      "lastName": "Doe",
      "middleName": null,
      "age": 47,
      "relationship": "owner",
      "deceased": false,
      "phones": [
        { "number": "5125551234", "type": "mobile" },
        { "number": "5125559999", "type": "residential" }
      ],
      "emails": ["jane@example.com"]
    },
    {
      "firstName": "Robert",
      "lastName": "Doe",
      "middleName": null,
      "age": 51,
      "relationship": "relative",
      "deceased": false,
      "phones": [{ "number": "5125557777", "type": "mobile" }],
      "emails": []
    }
  ]
}

Errors

All errors return a JSON body of the shape:

{ "error": { "code": "insufficient_credits", "message": "..." } }

Rate limits

• 1,000 requests per minute per API key.
• 10 concurrent requests per API key per server instance.

Every response includes:

Credits and billing

Each successful skip-trace call consumes one SKIPTRACE credit from your organization’s balance. This is the same credit pool as in-app skip traces — running either path debits the same bucket.

When your balance hits zero, subsequent calls return 402 insufficient_credits. Buy more credits in the Goliath app under Billing → Credits and then retry the request.

Frequently asked questions