Sneyk API Documentation

Integrate Florida business data directly into your applications with our
RESTful API. Data is updated daily.

Quick Start

Get API Key

Make Your First Request

Use your API key to authenticate and start accessing business data.

Integrate

Build powerful applications with up-to-date Florida business data.

Example Request

curl "https://api.sneyk.com/api/v1/businesses/search?q=tech&city=Miami&entity_type=Florida%20Limited%20Liability%20Company&limit=10&sort=-filing_date" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

Note: Use JWT token from POST /api/auth/login for authentication.

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

You can find your API key in your dashboard under API Keys section.

API Endpoints

GET/api/v1/businesses/search

Search Florida business records with advanced filtering, sorting, and pagination. Supports full-text search, geographic filters, entity type filters, and date range queries. Returns comprehensive business data including names, addresses, status, and filing dates.

Parameters:

Name	Type	Description
q	string	Search query for business name (minimum 3 characters, e.g., 'acme', 'consulting')
city	string	Filter by city (e.g., 'Miami', 'Tampa', 'Jacksonville')
county	string	Filter by county (e.g., 'Miami-Dade', 'Broward', 'Orange')
zip	string	Filter by ZIP code (5 digits, e.g., '33101')
entity_type	string	Filter by entity type (e.g., 'Florida Limited Liability Company', 'Florida Profit Corporation')
status	string	Filter by business status: 'Active' or 'Inactive'
filing_date_from	string	Filter by filing date from (YYYY-MM-DD, e.g., '2024-01-01')
filing_date_to	string	Filter by filing date to (YYYY-MM-DD, e.g., '2024-12-31')
page	number	Page number (default: 1)
limit	number	Results per page (max 100, default: 25)
sort	string	Sort field with - for descending: business_name, -business_name, filing_date, -filing_date

GET/api/v1/businesses/{id}

Get detailed business information by document number including full address, registered agent details, principal address, and related filing records.

Parameters:

Name	Type	Description
id	string	Business document number (e.g., 'P12000123456' for corporations, 'L12000123456' for LLCs)

GET/api/v1/businesses/autocomplete

Fast autocomplete search optimized for typeahead functionality. Returns business name suggestions with minimal latency (<100ms typical response time).

Parameters:

Name	Type	Description
q	string	Search query (minimum 2 characters, e.g., 'ac' for 'acme')
limit	number	Maximum suggestions to return (max 20, default: 10)

GET/api/business-search-postgres/search

Alternative search endpoint using PostgreSQL full-text search. Provides fast, indexed search across all Florida business records with the same filtering capabilities as /api/v1/businesses/search.

Parameters:

Name	Type	Description
q	string	Search query for business name
city	string	Filter by city
county	string	Filter by county
zip_code	string	Filter by ZIP code
entity_type	string	Filter by entity type
status	string	Filter by status (Active/Inactive)
state	string	State filter (default: FL)
limit	number	Results limit (default: 50)
offset	number	Pagination offset (default: 0)

GET/api/business-search-postgres/export

🔒 Professional tier required. Get a secure pre-signed S3 URL for downloading pre-generated daily export files. Returns direct download URL valid for 1 hour (configurable). This is the RECOMMENDED method for downloading exports - simple parameters, instant response.

Parameters:

Name	Type	Description
date	string	Export date in YYYYMMDD format (e.g., 20241002 for October 2, 2024) - REQUIRED
data_type	string	Entity type: corporate, federal_lien, fictitious_name, general_partnership, mark - REQUIRED
subtype	string	Data subtype: filings, events, debtors (federal_lien only), secured (federal_lien only) - REQUIRED
format	string	File format: csv, xlsx, json - REQUIRED
state	string	State filter (default: FL, currently only FL supported)
expires_in	number	URL expiration in seconds (60-604800, default: 3600 = 1 hour)

GET/api/v1/exports/available

🔒 Professional tier required. List all pre-generated daily export files available for download. Files are organized by entity type, data type, format, and date. Updated daily at 6 AM EST. Use this to discover what data is available before downloading.

Parameters:

Name	Type	Description
entity_type	string	Filter by entity type: corporate, federal_lien, fictitious_name, general_partnership, mark
data_type	string	Filter by data type: filings, events, debtors, secured
format	string	Filter by file format: csv, xlsx, json
date	string	Filter by specific date (YYYYMMDD format, e.g., 20241002)

POST/api/v1/exports/download

🔒 Professional tier required. Generate a secure pre-signed URL for downloading a specific export file using its S3 key. URLs are time-limited and automatically expire. Use this after getting the s3_key from /api/v1/exports/available.

Parameters:

Name	Type	Description
s3_key	string	Full S3 key from /api/v1/exports/available response (e.g., 'raw/record_type=data_exports/state=FL/corporate/filings/csv/corporate_filings_20241002.csv')
expires_in	number	URL expiration in seconds (60-604800, default: 3600 = 1 hour)

GET/api/v1/exports/dates

🔒 Professional tier required. Get a list of all available export dates for a specific entity type, data type, and format combination. Returns dates in YYYYMMDD format sorted newest first. Useful for discovering historical data availability.

Parameters:

Name	Type	Description
entity_type	string	Entity type: corporate, federal_lien, fictitious_name, general_partnership, mark - REQUIRED
data_type	string	Data type: filings, events, debtors, secured - REQUIRED
format	string	File format: csv, xlsx, json - REQUIRED

Rate Limits & Headers

Rate Limits

Per minute:1000 requests
Monthly quota:50,000 requests

Need higher limits? Contact our team

Rate Limit Headers

RateLimit

Modern RFC format with remaining quota and reset time

X-RateLimit-*

Legacy headers for backward compatibility

Retry-After

Seconds to wait when rate limited (429 response)

Ready to Build?

Get started with our API today and integrate Florida business data into your applications.

Get Your API Key