---
title: "Search UniCourt without an end user"
method: POST
path: "/api/admin/courts/search"
tags: ["Courts"]
---

# Search UniCourt without an end user

`POST /api/admin/courts/search`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/admin/courts/search`
- Auth: API key in header `x-api-key`

## Request body

- CourtSearchRequestSchema
  - `apply_match_filters` boolean
  - `business_name` string
  - `dba` string
  - `filed_after` string, date
  - `max_pages` integer
  - `owner` CourtOwner
    - `first_name` string, required
    - `last_name` string, required
    - `middle_name` string
  - `page` integer
  - `party_side` 'defensive' | 'plaintiff'
  - `query` string
  - `search_for` 'lawsuits' | 'bankruptcies' | 'all'
  - `states` string[]

## Response `200`

UniCourt cases and search cost

- object
  - `cases` object[], required
  - `cost` number, required
  - `dropped` object[], required
  - `pages_fetched` integer, required
  - `query_used` string, required
  - `total_count` integer, required

## Other responses

- `422`: Invalid UniCourt query
- `502`: UniCourt search failed

## Changes

- **2026-11-03** `bd8008e49534`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/admin/courts/search/post.md)

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/4f9eaaa87f09?raw)