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

# Sunbiz Federal Lien

`POST /us/sunbiz/federal-lien/v1`

## Request

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

Read one federal tax lien registered with the Florida Division of Corporations by its document number: the notice, its debtors, its secured parties and every event, release included. `found: false` when the Division has no such lien. 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
  - `document_number` string, required: Número de registro del gravamen federal en Florida, p. ej. `08FLR0012050`.

## Response `200`

Successful response

- SunbizFederalLienResponse
  - `data` SunbizFederalLienData, required
    - `found` boolean, required
    - `document_number` string, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `federal_lien` object, nullable, 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)