---
title: "Search Cobalt Secretary of State filings without an end user"
method: POST
path: "/api/admin/sos/search"
tags: ["Secretary of State"]
---

# Search Cobalt Secretary of State filings without an end user

`POST /api/admin/sos/search`

## Request

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

## Request body

- SosSearchRequestSchema
  - `apply_name_filter` boolean
  - `auto_select` boolean
  - `business_name` string
  - `city` string
  - `include_ucc_data` boolean
  - `person` SosPerson
    - `first_name` string, required
    - `last_name` string, required
  - `retry_id` string
  - `sos_id` string
  - `state` string
  - `street` string
  - `timeout` integer
  - `zip` string

## Response `200`

Cobalt filing results and search cost

- object
  - `alternatives` object[], required
  - `auto_selected` boolean, required
  - `calls_made` integer, required
  - `cobalt_status` string, required
  - `cost` number, required
  - `filing` object, nullable, required
  - `filtered_out` object[], required
  - `requery_performed` boolean, required
  - `retry_id` string, nullable, required

## Other responses

- `422`: Invalid Secretary of State search
- `502`: Cobalt search failed

## Changes

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

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/admin/sos/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)