---
title: "Sunbiz Entity by Document Number"
method: POST
path: "/us/sunbiz/entity/v1"
tags: ["United States", "Sunbiz (Florida Division of Corporations)"]
---

# Sunbiz Entity by Document Number

`POST /us/sunbiz/entity/v1`

## Request

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

Resolve one Florida business entity (Sunbiz, the Division of Corporations) by its document number and return the full record: status, filing type, addresses, formation date, FEI, annual reports, registered agent and officers. `found: false` when the registry has no entity with that number. Served by Croma (`as_of` says how current the data is), 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 documento de la entidad en Florida, p. ej. `P26000044030`.

## Response `200`

Successful response

- SunbizEntityResponse
  - `data` SunbizEntityData, required
    - `found` boolean, required
    - `document_number` string, required
    - `as_of` string, nullable, required: How current the data in this response is.
    - `entity` object, nullable, required
      - `document_number` string, required: The registry's own key for the entity, e.g. `P26000044030`. Its letter says what was filed (`P` profit corporation, `L` Florida LLC, `M` foreign LLC, `N` nonprofit, `F` foreign corporation, ...).
      - `name` string, required: The entity's name as registered.
      - `status` 'active' | 'inactive', required: `active` or `inactive`.
      - `filing_type` string, required: What was filed: `florida_llc`, `foreign_llc`, `domestic_profit`, `foreign_profit`, `domestic_nonprofit`, `foreign_nonprofit`, `domestic_limited_partnership`, `foreign_limited_partnership`, `nonprofit_registration`, `trust` or `registered_agent_designation`.
      - `jurisdiction` string, nullable, required: Where the entity was formed: `FL` for a Florida entity, another state's code, or a country code for one formed abroad.
      - `principal_address` object, required
        - `line_1` string, nullable, required
        - `line_2` string, nullable, required
        - `city` string, nullable, required: City of the principal address, as the registry prints it.
        - `state` string, nullable, required: State of the principal address.
        - `zip` string, nullable, required: `12345` or `12345-6789`; a foreign postal code as printed.
        - `country` string, nullable, required: Two-letter country code when the registry prints one.
      - `mailing_address` object, required
        - `line_1` string, nullable, required
        - `line_2` string, nullable, required
        - `city` string, nullable, required
        - `state` string, nullable, required: Two-letter state code, as the registry prints it.
        - `zip` string, nullable, required: `12345` or `12345-6789`; a foreign postal code as printed.
        - `country` string, nullable, required: Two-letter country code when the registry prints one.
      - `filed_on` string, nullable, required: `yyyy-mm-dd` of the formation or registration filing; an entity filed with a delayed effective date carries that later date, which can be months ahead.
      - `fei_number` string, nullable, required: Federal Employer Identification Number, nine digits, when the entity reported one.
      - `last_transaction_on` string, nullable, required: `yyyy-mm-dd` of the last filing the registry recorded on the entity.
      - `annual_reports` object[], required: The last three annual reports: the report year and the date it was filed.
        - `year` integer, required
        - `filed_on` string, nullable, required
      - `registered_agent` object, nullable, required
        - `kind` 'person' | 'company', nullable, required: Whether the registry lists a person or a company.
        - `name` string, required: The registered agent's name as one string; the search reaches it.
        - `first_name` string, nullable, required: Persons only.
        - `middle_name` string, nullable, required: Persons only; often an initial.
        - `last_name` string, nullable, required: Persons only.
        - `address` object, required
          - `line_1` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
      - `officers` object[], required: Up to six officers, directors, managers or members, as the registry lists them.
        - `kind` 'person' | 'company', nullable, required: Whether the registry lists a person or a company.
        - `name` string, required: The name as one string: `FIRST MIDDLE LAST` for a person, the company name otherwise.
        - `first_name` string, nullable, required: Persons only.
        - `middle_name` string, nullable, required: Persons only; often an initial.
        - `last_name` string, nullable, required: Persons only.
        - `address` object, required
          - `line_1` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
        - `title` string, nullable, required: The office as the registry abbreviates it: `P` (president), `VP`, `MGR` (manager), `AMBR` (authorized member), `MBR`, `D` (director), `T`, `S`, `CEO`, `AR`, ...
      - `officer_names` string[], required: Every officer's name; the search reaches them.
      - `more_than_six_officers` boolean, required: The registry lists more officers than the six it publishes here.
      - `updated_at` string, required: When the registry published the state this record reflects (ISO timestamp).
    - `fictitious_names` object[], required: Up to 20 fictitious names (DBAs) the entity owns, newest first.
      - `document_number` string, required: The registration's number, `G` and eleven digits. The key.
      - `name` string, required: The fictitious name as registered.
      - `county` string, nullable, required: The county the business operates in, upper-cased; `MULTIPLE` for more than one.
      - `address` object, required: The business's address under the fictitious name.
        - `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
      - `filed_on` string, nullable, required: When the registration was filed (yyyy-mm-dd).
      - `expires_on` string, nullable, required: When the registration expires unless renewed: December 31 of its fifth year (yyyy-mm-dd).
      - `cancelled_on` string, nullable, required: When the registration was cancelled, as its own record states (yyyy-mm-dd).
      - `status_code` string, nullable, required: The status on the registration's own record: `A` active, `C` cancelled, `E` expired.
      - `pages` number, nullable, required
      - `owner_count` number, nullable, required
      - `more_than_ten_owners` boolean, required: The registration has more owners than the ten the record carries.
      - `fei_number` string, nullable, required: The FEI number on the registration; returned only when every owner is a company.
      - `owners` object[], required
        - `kind` 'person' | 'company', nullable, required
        - `name` string, nullable, required: The owner's name: the company's, or the person's first, middle and last name and suffix.
        - `first_name` string, nullable, required: Persons only.
        - `middle_name` string, nullable, required: Persons only.
        - `last_name` string, nullable, required: Persons only.
        - `suffix` string, nullable, required: Persons only.
        - `document_number` string, nullable, required: The owner's own Sunbiz document number, when the owner is an entity on the registry: the join to `sunbiz-entity`.
        - `fei_number` string, nullable, required: The owner's FEI number; returned for a company owner only.
        - `address` object, required
          - `line_1` string, nullable, required
          - `city` string, nullable, required
          - `state` string, nullable, required
          - `zip` string, nullable, required
          - `country` string, nullable, required
      - `owner_names` string[], required: Every owner's name.
      - `owner_document_numbers` string[], required: The Sunbiz document numbers of the owners that are entities on the registry.
      - `person_owned` boolean, required: At least one owner is a person.
      - `listed_on` string, required: The day of the newest publication that lists the registration: the quarterly register or a day's filings (yyyy-mm-dd).
      - `updated_at` string, required: When the registry published the state this record reflects.
      - `status` 'active' | 'inactive' | 'cancelled', required: `active` while the Division's register lists it; `inactive` once it no longer does (expired or cancelled); `cancelled` when a cancellation was filed.
    - `fictitious_names_total` number, required
    - `marks` object[], required: Up to 20 trademarks and service marks the entity owns, newest first.
      - `number` string, required: The mark's registration number, e.g. `T26000123456`. The key.
      - `name` string, nullable, required: The mark as the register names it.
      - `cross_reference_name` string, nullable, required: A second name the register keeps for the mark.
      - `status` 'active' | 'inactive', required: `active` or `inactive`.
      - `classes` object[], required: The classes of goods or services the mark is registered in.
        - `type` string, nullable, required
        - `code` string, nullable, required
      - `class_codes` string[], required: The class codes, as the register writes them.
      - `disclaimers` string[], required
      - `used_for` string[], required: The goods or services the mark is used for, as the registrant describes them.
      - `filed_on` string, nullable, required: When the mark was filed (yyyy-mm-dd).
      - `expires_on` string, nullable, required: When the registration expires (yyyy-mm-dd).
      - `first_used_on` string, nullable, required: When the mark was first used anywhere (yyyy-mm-dd).
      - `first_used_in_florida_on` string, nullable, required: When the mark was first used in Florida (yyyy-mm-dd).
      - `owners` object[], required
        - `document_number` string, nullable, required: The owner's Sunbiz document number, when the owner is an entity on the registry.
        - `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
      - `owner_names` string[], required
      - `owner_document_numbers` string[], required: The Sunbiz document numbers of the owners that are entities on the registry.
      - `last_event_code` string, nullable, required
      - `last_event_filed_on` string, nullable, required: When the last event was filed (yyyy-mm-dd).
      - `event_sequence` number, nullable, required
      - `updated_at` string, required: When the registry published the state this record reflects.
    - `marks_total` number, required
    - `general_partnerships` object[], required: Up to 20 general partnerships the entity is a partner in, newest first.
      - `document_number` string, required: The partnership's document number, `GP` or `LLP` and digits. The key.
      - `name` string, nullable, required: The partnership's name.
      - `status_code` string, nullable, required: The status as the registry writes it: one letter.
      - `filed_on` string, nullable, required: When the partnership was filed (yyyy-mm-dd).
      - `effective_on` string, nullable, required: When the filing took effect (yyyy-mm-dd).
      - `cancelled_on` string, nullable, required: When the filing was cancelled (yyyy-mm-dd).
      - `expires_on` string, nullable, required: When the filing expires (yyyy-mm-dd).
      - `fei_number` string, nullable, required
      - `fei_status` string, nullable, required
      - `jurisdiction` string, nullable, required
      - `principal_address` object, nullable, 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
      - `mailing_address` object, nullable, 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
      - `converted` string, nullable, required: The conversion flag as the registry writes it.
      - `pages` number, nullable, required
      - `total_pages` number, nullable, required
      - `florida_partners` number, nullable, required
      - `total_partners` number, nullable, required
      - `cancel_document_number` string, nullable, required
      - `partners` object[], required
        - `sequence` number, nullable, required
        - `type` string, nullable, required: `P` partner or `A` authorized person.
        - `kind` 'person' | 'company', nullable, required
        - `name` string, nullable, required
        - `document_number` string, nullable, required: The partner's Sunbiz document number, when the partner is an entity on the registry.
        - `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
      - `partner_names` string[], required
      - `partner_document_numbers` string[], required: The Sunbiz document numbers of the partners that are entities on the registry.
      - `events` object[], required: Every event filed against the partnership, oldest first.
        - `event_document_number` string, nullable, required
        - `sequence` number, nullable, required
        - `code` string, nullable, required
        - `description` string, nullable, required
        - `filed_on` string, nullable, required: When the event was filed (yyyy-mm-dd).
        - `effective_on` string, nullable, required: When it took effect (yyyy-mm-dd).
        - `cancelled_on` string, nullable, required: A cancellation date the event records (yyyy-mm-dd).
        - `expires_on` string, nullable, required: An expiration date the event records (yyyy-mm-dd).
        - `pages` number, nullable, required
        - `notes` string[], required
        - `merger_document_number` string, nullable, required
        - `name` string, nullable, required: A name the event records.
        - `name_sequence` number, nullable, required
        - `principal_address` object, nullable, 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
        - `mailing_address` object, nullable, 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
        - `dissociated` object, nullable, required: A partner the event dissociates.
          - `name` string, nullable, required
          - `address` object, nullable, 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
        - `affected_document_number` string, nullable, required
        - `cancel_document_number` string, nullable, required
      - `listed_on` string, nullable, required: The day of the newest publication that lists the filing.
    - `general_partnerships_total` number, required

## 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)