ValidateBusiness Fast Florida business verification API
Sign in

API Documentation

Integrate ValidateBusiness to validate and verify U.S. companies (Florida-first) using official public records.

1. Introduction

The ValidateBusiness API is designed for backend usage (PHP, Node, Python, etc.) and returns normalized, production-ready company data.

All requests are made over HTTPS and return responses as application/json.

Recommended base URL:

https://api.yourdomain.com/v1

2. Authentication

Authentication uses the header Authorization: Bearer <API_KEY>. You can view and rotate your key from the dashboard. 

GET /v1/company?registration=K123456 HTTP/1.1
Host: api.yourdomain.com
Authorization: Bearer sk_live_xxxxxxxx
Accept: application/json

3. Endpoint GET /company

3.1 Description

Returns a company profile using its state registration number or a supported identifier. Ideal for onboarding, KYB checks, vendor validation, and internal workflows.

GET /company?registration={ID}

3.2 Parameters

  • registration (required): State registration number (e.g., Florida Sunbiz).
  • live (optional, bool): Force a real-time refresh (when available).

3.3 Response example

{
  "success": true,
  "data": {
    "name": "EXAMPLE COMPANY LLC",
    "registration": "L23000012345",
    "state": "FL",
    "status": "ACTIVE",
    "type": "LLC",
    "filed_date": "2023-01-18",
    "registered_agent": {
      "name": "REGISTERED AGENT NAME",
      "address": "MIAMI, FL"
    },
    "sources": ["FLORIDA_DIVISION_OF_CORPORATIONS"]
  }
}

3.4 Error codes

  • 400: missing or invalid registration.
  • 401: missing or invalid API key.
  • 404: no company found for that identifier.
  • 429: rate limit exceeded.

4. SDK PHP / Laravel

Minimal example to fetch a company profile in PHP or Laravel.

4.1 Install

composer require ValidateBusiness/sdk-php

4.2 Quick example (Laravel)

<?php

use ValidateBusiness\Client;

$client = new Client(env('ValidateBusiness_API_KEY'));

$response = $client->company([
    'registration' => 'L23000012345',
]);

if ($response->ok()) {
    $data = $response->json();
    // $data['data']['status'], $data['data']['name'], etc.
}

5. SDK Node / JavaScript

Typical usage in a Node backend (Express, Nest, serverless, etc.).

5.1 Install

npm install @ValidateBusiness/sdk

5.2 Quick example (Node)

import { ValidateBusiness } from "@ValidateBusiness/sdk";

const client = new ValidateBusiness(process.env.VB_API_KEY);

const res = await client.company({ registration: "L23000012345" });

if (res?.data?.status === "ACTIVE") {
  console.log("Active company:", res.data.name);
}