v1

latestOpenAPI 3.1.02026-07-241695611.0 MB

Person Search

Create Person Search

post/person_searches

Headers

Preferstring nullable

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:respond-async

Request body

first_namestring required

The first name of the person to search for.

last_namestring required

The last name of the person to search for.

middle_namestring nullable

The middle name of the person to search for.

phone_numberstring nullable

The phone number of the person to search for. Area code is mandatory.

emailstring nullable

The email address of the person to search for.

date_of_birthstring date nullable

The date of birth of the person to search for.

gender'M' | 'F'

addressstring nullable

The address of the person to search for. The state provided in this address will be used for the liens search, if selected.

suffixstring nullable

The suffix of the person to search for.

titlestring nullable

The title of the person to search for.

reference_idstring nullable

An optional reference ID to associate with the search request.

optionsPersonSearchOptions[] required

Options controlling which searches to run. At least one is required. Use ['Order.Litigations'] for civil dockets only, ['Order.Bankruptcy'] for bankruptcy only, or both for combined docket search.

Example request

{
  "first_name": "John",
  "last_name": "Doe",
  "ssn": "123456789",
  "middle_name": "Michael",
  "phone_number": "+14013059855",
  "email": "john.doe@example.com",
  "date_of_birth": "1990-01-15",
  "address": "123 Main St, Anytown, CA 12345",
  "suffix": "Jr.",
  "title": "Mr.",
  "reference_id": "Search1234",
  "options": [
    "Order.Litigations"
  ]
}

Response

idstring uuid required

The unique identifier of the search.

state'PENDING' | 'EXECUTING' | 'COMPLETED' | 'FAILED' | 'CANCELLED' required

created_atstring date-time required

The datetime the search was created.

updated_atstring date-time nullable

The datetime the search was updated at (generally when the search completed).

reference_idstring nullable

The reference ID associated with the search.

tin_matchedboolean nullable

Whether the SSN for this person search matches with the name provided

errorstring nullable

Any errors that occurred.

warningsstring[]

Any warnings that occurred.

Example response

{
  "created_at": "2026-07-16T19:24:27.815920",
  "updated_at": "2026-07-16T19:24:27.815934",
  "reference_id": "Search1234",
  "person": {
    "id": "8e3b7f77-2799-4931-a322-9f80cc67eebe",
    "first_name": "John",
    "last_name": "Doe",
    "ssn": "XXXXX1234",
    "middle_name": "Michael",
    "phone_number": "+17075489914",
    "email": "johndoe@example.com",
    "date_of_birth": "1990-01-15",
    "suffix": "Jr.",
    "title": "Mr.",
    "created_at": "2025-01-15T12:00:00Z",
    "updated_at": "2025-01-15T12:00:00Z",
    "dockets": [
      {
        "docket_number": "A19284",
        "court": "Supreme Court of Orange County",
        "division": "Civil Court Division",
        "judges": [
          "Honorable Paul Shaw"
        ],
        "title": "Doe v. City of New York",
        "case_type": "Civil",
        "status": "Pending",
        "parties": [
          {
            "party_type": "Complaintant",
            "counsel": [
              "Robin Keller"
            ]
          }
        ],
        "updates": [
          {
            "title": "Update 2",
            "contents": "New details about the case.",
            "date": "2024-06-01",
            "exhibits": [
              {
                "title": "Exhibit 1A"
              }
            ]
          }
        ]
      }
    ],
    "liens": [
      {
        "filing_number": "P98172",
        "filing_type": "Lien for Loan Default",
        "filing_date": "2023-09-18",
        "lapse_date": "2023-04-15",
        "status": "Under Appeal",
        "number_of_pages": 14,
        "document_filename": "docket_47182.pdf",
        "parties": [
          {
            "name": "Louis Schneider",
            "address": {
              "street": "913 Hendrix Gardens Suite 492",
              "city": "Jasonfurt",
              "zip": "19773",
              "latitude": 38.03012,
              "longitude": 78.47665
            },
            "type": "individual"
          }
        ],
        "amendments": [
          {
            "filing_number": "H76162",
            "filing_type": "Notarized Letter",
            "filing_date": "2023-11-27",
            "number_of_pages": 4
          }
        ],
        "collateral_statements": [
          {
            "text": "2022 Blue Honda Civic"
          }
        ]
      }
    ],
    "watchlist_hits": [
      {
        "code": "DMF",
        "count": 1,
        "details": [
          {
            "address": "123 Main St",
            "date_of_birth": "1980-01-01",
            "name": "John Doe"
          }
        ]
      }
    ]
  },
  "tin_matched": true,
  "error": "RuntimeError The Search could not be completed."
}