API Guide: Integrating New Business Filing Data

Overview

The NewFilingAlerts API provides programmatic access to new business filing data from Secretary of State offices across multiple US states. This guide covers authentication, endpoints, response formats, and common integration patterns.

Authentication

All API requests require an API key passed in the X-API-Key header. You can obtain an API key by subscribing to a plan on our pricing page.

GET /api/v1/filings
X-API-Key: your_api_key_here

Base URL

https://newfilingalerts.com/api/v1

Search Endpoint

The primary endpoint for querying filings:

GET /api/v1/filings?state=TX&entity_type=LLC&filed_after=2026-03-01&limit=50

Parameters

Response Format

{
  "data": [
    {
      "id": "TX-123456789",
      "business_name": "ACME SOLUTIONS LLC",
      "entity_type": "LLC",
      "state": "TX",
      "filing_date": "2026-03-15",
      "status": "Active",
      "principal_city": "Austin",
      "principal_state": "TX"
    }
  ],
  "total": 1542,
  "limit": 25,
  "offset": 0
}

Note: The API returns truncated records. Full details including registered agent information, principal address, and filing numbers are available through the web interface.

Common Integration Patterns

CRM Integration

Sync new filings into your CRM as leads. Most teams set up a daily cron job that queries filings from the previous day and creates new lead records.

// Example: Daily sync to CRM
const response = await fetch(
  'https://newfilingalerts.com/api/v1/filings?' +
  'state=TX&entity_type=LLC&filed_after=' + yesterday,
  { headers: { 'X-API-Key': process.env.NFA_API_KEY } }
);
const { data } = await response.json();

for (const filing of data) {
  await crm.createLead({
    company: filing.business_name,
    state: filing.state,
    source: 'NewFilingAlerts',
    filingDate: filing.filing_date
  });
}

Analytics Dashboard

Build a dashboard that tracks filing trends over time. Query filings by date range and state to visualize formation activity.

Lead Scoring

Combine filing data with other signals to score and prioritize leads. For example, you might score higher for corporations (which tend to be larger ventures) or for filings in your primary service area.

Rate Limits

API rate limits depend on your plan tier:

Rate limit headers are included in every response:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 487
X-RateLimit-Reset: 1710720000

Error Handling

The API returns standard HTTP status codes:

• 200 — Success
• 400 — Bad request (invalid parameters)
• 401 — Unauthorized (invalid or missing API key)
• 429 — Rate limit exceeded
• 500 — Server error

Error responses include a message field:

{
  "error": "Invalid state code. Use two-letter abbreviation (e.g., TX, FL)."
}

RapidAPI

The NewFilingAlerts API is also available on RapidAPI for teams that prefer centralized API management and billing. Search for "NewFilingAlerts" on RapidAPI to get started.

Getting Started

1. Choose a plan on our pricing page
2. Get your API key from the dashboard
3. Make your first request
4. Set up automated daily syncs

Questions? Contact us at josh@palavir.co.