---
title: "Sunbiz Federal Liens Search"
method: POST
path: "/us/sunbiz/federal-liens-search/v1"
tags: ["United States", "Sunbiz (Florida Division of Corporations)"]
---

# Sunbiz Federal Liens Search

`POST /us/sunbiz/federal-liens-search/v1`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/us/sunbiz/federal-liens-search/v1`
- Auth: HTTP bearer

Search the federal tax lien notices registered with the Florida Division of Corporations since 2009, and the releases since 1993, by the debtor's or the secured party's name, status (active, released, inactive) and filing dates. Each lien with its debtors, secured parties and events. Newest first, pages of up to 50. Served by Croma, brought up to date daily.

**Dataset endpoint**: answers from the whole source in milliseconds and carries `as_of`.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `query` string: Palabras a buscar en los nombres del registro (opcional).
  - `status` '' | 'active' | 'released' | 'inactive': Estado del gravamen: `active`, `released` o `inactive` (opcional).
  - `filed_from` string, date: Optional date filter in yyyy-mm-dd format.
  - `filed_to` string, date: Optional date filter in yyyy-mm-dd format.
  - `page` integer: 1-based page number for paginated results.
  - `per_page` integer: Resultados por página (1-50).

## Response `200`

Successful response

- SunbizFederalLiensSearchResponse
  - `data` SunbizFederalLiensSearchData, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `query` string, required
    - `status` string, nullable, required
    - `filed_from` string, nullable, required
    - `filed_to` string, nullable, required
    - `total` number, required: Matches, counted up to 1000.
    - `total_is_exact` boolean, required: False when more than 1000 match: `total` is then 1000, and the pages go on.
    - `page` number, required
    - `per_page` number, required
    - `total_pages` number, required: Pages over `total`; there are more when `total_is_exact` is false.
    - `count` number, required
    - `federal_liens` object[], required
      - `document_number` string, required: The lien's document number, e.g. `08FLR0012050`. The key.
      - `filed_on` string, nullable, required: When the lien was filed (yyyy-mm-dd).
      - `assessed_on` string, nullable, required: The assessment date the notice states (yyyy-mm-dd).
      - `expires_on` string, nullable, required: When the filing expires (yyyy-mm-dd).
      - `cancelled_on` string, nullable, required: When the filing was cancelled (yyyy-mm-dd).
      - `status_code` string, nullable, required: On the filing's own record: `A` active, `L` lapsed, `T` terminated.
      - `type_code` string, nullable, required: `F` federal lien registration.
      - `transmitting_utility` string, nullable, required
      - `pages` number, nullable, required
      - `total_pages` number, nullable, required
      - `event_count` number, nullable, required
      - `debtors_total` number, nullable, required
      - `secured_parties_total` number, nullable, required
      - `debtors_current` number, nullable, required
      - `secured_parties_current` number, nullable, required
      - `debtors` object[], required
        - `sequence` number, nullable, required
        - `kind` 'person' | 'company', nullable, required
        - `name` string, nullable, required
        - `address` object, required
          - `line_1` string, nullable, required
          - `line_2` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
          - `country` string, nullable, required
        - `relation` string, nullable, required: `C` current.
        - `original` string, nullable, required: Whether the party was on the original filing, as the registry marks it.
        - `status_code` string, nullable, required: `A` active, `L` lapsed, `T` terminated.
        - `listed_on` string, required: The day of the newest publication that lists the party.
      - `secured_parties` object[], required: The lienholder, usually the Internal Revenue Service.
        - `sequence` number, nullable, required
        - `kind` 'person' | 'company', nullable, required
        - `name` string, nullable, required
        - `address` object, required
          - `line_1` string, nullable, required
          - `line_2` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
          - `country` string, nullable, required
        - `relation` string, nullable, required: `C` current.
        - `original` string, nullable, required: Whether the party was on the original filing, as the registry marks it.
        - `status_code` string, nullable, required: `A` active, `L` lapsed, `T` terminated.
        - `listed_on` string, required: The day of the newest publication that lists the party.
      - `events` object[], required: Every event filed against the lien, oldest first.
        - `event_document_number` string, nullable, required
        - `action_code` string, nullable, required: e.g. `COR` certificate of release, `AGI`, `RNL`, `RNC`, `COD`, `CHA`.
        - `action` string, nullable, required
        - `filed_on` string, nullable, required: When the event was filed (yyyy-mm-dd).
        - `created_on` string, nullable, required: When the registry recorded it (yyyy-mm-dd).
        - `event_number` string, nullable, required: The registry's tracking number for the event.
        - `action_counter` number, nullable, required
        - `sequence` number, nullable, required
        - `action_sequence` number, nullable, required
        - `pages` number, nullable, required
        - `name_type` string, nullable, required: `D` debtor or `S` secured party, for an event that changes a name.
        - `previous_name_sequence` number, nullable, required
        - `new_name_sequence` number, nullable, required
      - `debtor_names` string[], required
      - `secured_party_names` string[], required
      - `released` boolean, required: A certificate of release (`COR`) was filed.
      - `released_on` string, nullable, required: When the release was filed (yyyy-mm-dd).
      - `listed_on` string, nullable, required: The day of the newest publication that lists the filing; null for a lien known only from its events.
      - `status` 'active' | 'released' | 'inactive', required: `released` once a certificate of release was filed; `active` while the Division's register lists it; `inactive` once it no longer does.

## Other responses

- `400`: Invalid request body
- `401`: Missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal error
- `502`: Upstream source returned an error

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)