Entitylight

Entitylight Business Searches API

The Business Searches API from Entitylight — 2 operation(s) for business searches.

Documentation GitHub OpenAPI

Operations 2

POST /business-searches Find businesses by officer, registered agent or address #

GET /business-searches/{businessSearchId} Get a business search #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/entitylight:entitylight-business-searches-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Entitylight Business Searches API
  version: 1.0.0
  description: Look up a business's Secretary of State record, UCC filings and court cases, with names as filed, and watch businesses for new filings and lawsuits.
servers:
- url: https://api.entitylight.com/v1
security:
- apiKey: []
tags:
- name: Business Searches
paths:
  /business-searches:
    post:
      summary: Find businesses by officer, registered agent or address
      description: Searches the state's business register for businesses listing the officer or registered agent, or using the street address, and answers at once with up to 25 of them. Look one up by its sosId for the full record. Counts as one lookup; a search that couldn't reach the register isn't charged.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BusinessSearchRequest'
      responses:
        '201':
          description: Searched
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSearch'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '402':
          description: The plan has no lookups left
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Invalid fields, or a state without this kind of search
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than 60 requests a minute for this key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: The register couldn't be searched; not charged
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Business Searches
      operationId: postBusinessSearches
      x-operation-id-source: derived
  /business-searches/{businessSearchId}:
    get:
      summary: Get a business search
      parameters:
      - name: businessSearchId
        in: path
        required: true
        schema:
          type: string
          format: uuid
      responses:
        '200':
          description: The search as it ran
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSearch'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: No business search with that id
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          description: More than 60 requests a minute for this key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Business Searches
      operationId: getBusinessSearchesByBusinessSearchId
      x-operation-id-source: derived
components:
  schemas:
    BusinessSearch:
      type: object
      properties:
        id:
          type: string
          format: uuid
          pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
        by:
          type: string
          enum:
          - officer
          - registered_agent
          - address
        name:
          description: The officer or registered agent searched
          type:
          - string
          - 'null'
        street:
          type:
          - string
          - 'null'
        zip:
          type:
          - string
          - 'null'
        state:
          type: string
          enum:
          - AL
          - AK
          - AZ
          - AR
          - CA
          - CO
          - CT
          - DE
          - DC
          - FL
          - GA
          - HI
          - ID
          - IL
          - IN
          - IA
          - KS
          - KY
          - LA
          - ME
          - MD
          - MA
          - MI
          - MN
          - MS
          - MO
          - MT
          - NE
          - NV
          - NH
          - NJ
          - NM
          - NY
          - NC
          - ND
          - OH
          - OK
          - OR
          - PA
          - RI
          - SC
          - SD
          - TN
          - TX
          - UT
          - VT
          - VA
          - WA
          - WV
          - WI
          - WY
        businessCount:
          type: integer
          minimum: -9007199254740991
          maximum: 9007199254740991
        truncated:
          type: boolean
          description: The register lists more than 25 businesses; narrow the search to see the rest
        businesses:
          type: array
          items:
            type: object
            properties:
              legalName:
                type: string
              sosId:
                description: The state's own id for the business; look it up for the full record
                type:
                - string
                - 'null'
              state:
                type: string
              status:
                type:
                - string
                - 'null'
              entityType:
                description: As the state records it
                type:
                - string
                - 'null'
              formationDate:
                description: YYYY-MM-DD
                type:
                - string
                - 'null'
              registeredAgent:
                type:
                - string
                - 'null'
              registeredAgentAddress:
                type:
                - string
                - 'null'
              principalAddress:
                type:
                - string
                - 'null'
              mailingAddress:
                type:
                - string
                - 'null'
              officers:
                type: array
                items:
                  type: object
                  properties:
                    name:
                      type: string
                    title:
                      type:
                      - string
                      - 'null'
                    address:
                      type:
                      - string
                      - 'null'
                  required:
                  - name
                  - title
                  - address
                  additionalProperties: false
                description: Officers as the state's register lists them
              matched:
                type: object
                properties:
                  as:
                    type: string
                    enum:
                    - officer
                    - registered_agent
                    - address
                  value:
                    type: string
                    description: The officer, agent or address as the register spells it
                  title:
                    description: The officer's title, for officer searches
                    type:
                    - string
                    - 'null'
                  addressTypes:
                    type: array
                    items:
                      type: string
                      enum:
                      - principal
                      - mailing
                      - registered_agent
                    description: Which of the business's addresses matched, for address searches
                required:
                - as
                - value
                - title
                - addressTypes
                additionalProperties: false
              sourceAsOf:
                description: ISO 8601. When the state's register was published, where it comes from a published file
                type:
                - string
                - 'null'
            required:
            - legalName
            - sosId
            - state
            - status
            - entityType
            - formationDate
            - registeredAgent
            - registeredAgentAddress
            - principalAddress
            - mailingAddress
            - officers
            - matched
            - sourceAsOf
            additionalProperties: false
        createdAt:
          type: string
          description: ISO 8601
      required:
      - id
      - by
      - name
      - street
      - zip
      - state
      - businessCount
      - truncated
      - businesses
      - createdAt
      additionalProperties: false
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            issues:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
                required:
                - path
                - message
                additionalProperties: false
          required:
          - code
          - message
          additionalProperties: false
      required:
      - error
      additionalProperties: false
    BusinessSearchRequest:
      type: object
      properties:
        by:
          type: string
          enum:
          - officer
          - registered_agent
          - address
          description: 'officer: businesses listing this person or firm as an officer. registered_agent: businesses naming this registered agent. address: businesses at this street address'
        name:
          description: 'For officer and registered_agent: the name, matched on all its words in any order'
          type: string
          minLength: 2
          maxLength: 200
        street:
          description: 'For address: the street line, such as 3300 Publix Corporate Pkwy. A suite number must match'
          type: string
          minLength: 3
          maxLength: 200
        zip:
          description: 'For address: the 5-digit ZIP code of the street'
          type: string
          pattern: ^\d{5}$
        state:
          description: 'Two-letter code of the state whose register to search. officer: AK, CT, FL, IL, NY, OR, PA, VA, WV; registered_agent: AK, CO, CT, DC, FL, IA, IL, KY, NY, OR, RI, VA, WV; address: AK, CO, CT, DC, FL, IA, IL, KY, MS, NY, OR, PA, RI, VA, WV'
          type: string
      required:
      - by
      - state
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer