For developers and AI agents

Business lookup API for official state records

Registry Verify looks up a business name in the company records a state publishes and returns the companies that match, each with the state's own number for it, its status, the people on record, the state file it came from and the date the data was last updated. It covers Florida, New York and California today, each at its own charge URL. An agent pays 0.10 USDC per call over x402 on Base, so it needs a funded wallet and no account with us.

Who it is for

It is for developers whose AI agents pay invoices, onboard vendors or customers, or sign contracts with companies. Before it acts, the agent sends the company's name to the state where the company says it is formed or registered, pays for the call from its own x402 wallet, and gets back what that state's records say about the company.

The states today

  • Florida: the Florida Division of Corporations, about 13 million filings, active and inactive, new daily files loaded every day, on top of the quarterly snapshot.
  • New York: the New York Department of State, about 7.2 million companies, active and inactive, updated every day.
  • California: the California Secretary of State, about 9.4 million companies, active and inactive, statuses from a monthly file, new companies from a weekly file.

Each state's page says what its answer carries, how current its data is, and how often the right company comes first.

What every answer carries

Whatever the state, an answer gives the name you sent, up to five candidate companies closest name first, how current the data is, and plain sentences on what a match, a no match and a status mean. Each candidate carries the state's own number for the company, its name and status as the state reports them, its home state, how close its name is to the one you sent, which of its names matched, and the publisher and file the record came from. Each state adds what its records hold:

Florida
annual_report, history, flags, shared_records, name_history, officers, ra_name, claim_check. Warning flags, shared record counts, former names, listing the filings formed in a chosen home state first, and checks of an EIN, ZIP code, address or person against each filing. Florida company data describes each one.
New York
biennial_statement, chief_executive, service_of_process, registered_agent, principal_office, history, former_names, fictitious_names, county. Whether the biennial statement is on file (New York asks business corporations and LLCs for one every two years), fictitious names in the search, and a warning when New York dissolved the company by proclamation. The New York page describes each one.
California
status_meaning, is_active, standing, statement_of_information, officers, agent_for_service, record_dates, mailing_address, california_office. California's standing flags, the Statement of Information with up to 25 people, and a search of the company's name in its home state as well as its California name. The California page describes each one.

The company data page explains every field.

How to call it

Send one GET request to the charge URL of the state whose records you want, with the business name in name, URL encoded:

GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Publix%20Super%20Markets
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-new-york-business?name=Pfizer%20Inc
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-california-business?name=Apple%20Inc
  1. The first request returns HTTP 402 Payment Required with the price, the network and the recipient.
  2. Your x402 client pays 0.10 USDC on Base and sends the same request again with the payment attached.
  3. Proceeds, the payment service that runs our paywall, settles the payment and returns our JSON answer.

limit sets how many candidates come back, from 1 to 5. Florida also takes home_state, and ein, zip, address and person to check what a counterparty told you. The machine readable description of all three calls is at /openapi.json, and agents that use skills can read /skill.md or install it with npx skills add https://registryverify.com.

MCP clients such as Claude, Claude Code and Cursor can connect to our MCP server at https://registryverify.com/mcp. It has one free tool per state, verify_florida_business, verify_new_york_business and verify_california_business. Each checks a name and returns that state's charge URL, which the agent pays with its own x402 wallet.

Which state to check

Check the state where the company says it was formed, and each state where it says it is registered to do business. A company formed in Delaware that works in Florida has a Florida registration, and the Florida answer names its home state and links that state's own search. A lookup in one state says nothing about another state's register, and each lookup is a separate payment.

What a result means

A result is a candidate name match, not proof of identity. It shows which record in that state's register carries a name and what the state reports about it. Check a second fact, such as the address, the agent or an officer, before you rely on it. A lookup that finds nothing means we found no candidate in the files we hold for that state; it does not prove the company is absent. The agent guide shows how an agent should act on an answer, and pricing shows how payment works.

What each state returns

Registry Verify answers for Florida, New York and California. Each state has its own records and its own charge URL, so one lookup searches one state. A lookup costs 0.10 USDC in each state, paid the same way over x402 on Base, and every answer says how current its data is.

Florida

Publisher
The Florida Division of Corporations, from its quarterly snapshot of corporate records and its daily files of new filings, changes and status events, the data behind Sunbiz (source files). About 13 million filings, active and inactive.
Updates
Every day we load Florida's new daily files on top of its quarterly snapshot, and each quarter we load the new snapshot. Florida's daily event files miss some status changes, which reach us with the next quarterly snapshot.
Data date
Every answer carries this date in dataset.source_file_date_end, the date of the newest Florida daily file we hold. dataset.stale is true when our last import finished more than 7 days ago. Florida's data status page shows this date as it stands now, with the record count.
Charge URL
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-florida-business?name=Publix%20Super%20Markets

Send name, and optionally limit (1 to 5), home_state (a two letter state code that lists filings formed there first), and ein, zip, address and person to check what a counterparty told you.

Fields
Document number, name as filed, status, filing type and date, principal city and ZIP code, registered agent, up to six officers, home state, annual report status, status history, and the Florida source file.
Only in Florida
Warning flags, shared record counts, former names, listing the filings formed in a chosen home state first, and checks of an EIN, ZIP code, address or person against each filing.
Limits
At most six officers, as Florida's file holds them. A filing formed before 2008 and renamed once is found only by its current name. A no match does not prove a company is absent from Florida's records. To confirm a filing made in the last day or two, a person can search Florida's own site in a browser (it refuses automated clients): Sunbiz search.

Florida business lookup API: every field, how to call it, a sample answer and how often the right company comes first.

New York

Publisher
The New York Department of State, Division of Corporations, from its company register published on data.ny.gov (source files). About 7.2 million companies, active and inactive.
Updates
Updated every day: at 16:30 UTC we add New York's daily filings and status changes.
Data date
Every answer carries this date in dataset.source_file_date_end, the date of the newest New York file we loaded. dataset.stale is true when our New York data is more than 10 days old. New York's data status page shows this date as it stands now, with the record count.
Charge URL
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-new-york-business?name=Pfizer%20Inc

Send name, and optionally limit (1 to 5). Florida's other parameters are accepted, change nothing, and are listed under inputs_not_used.

Fields
DOS ID, name, status and the filing that set it, entity type, formation date, county, home state, the service of process, registered agent, chief executive and principal office addresses, its five newest filings, and its former and fictitious names.
Only in New York
Whether the biennial statement is on file (New York asks business corporations and LLCs for one every two years), fictitious names in the search, and a warning when New York dissolved the company by proclamation.
Limits
No officers beyond the chief executive, and New York LLCs name no members or managers. No warning flags, shared record counts or fact checks, and New York publishes no EIN. New York says its open data is not an official record. For a certified record, ask the Department of State, or check New York's record search.

New York business lookup API: every field, how to call it, a sample answer and how often the right company comes first.

California

Publisher
The California Secretary of State, from its bizfile Online bulk data (source files). About 9.4 million companies, active and inactive.
Updates
Two files. A monthly file lists every company with its status on the file's last day, and it is the only source of status changes. A weekly file adds the companies first filed that week. A company suspended or revived after the monthly file's last day keeps its earlier status here until the next monthly file.
Data date
Every answer carries both dates: dataset.status_data_through, the last day of the newest monthly file, and dataset.new_companies_through, the last day of the newest weekly file. dataset.stale is true when the weekly data is more than 9 days old or the monthly data more than 35 days old. California's data status page shows both dates as they stand now, with the record count.
Charge URL
GET https://myproceeds.xyz/api/pay/cmupojkok000bjz043ecdfmec/verify-california-business?name=Apple%20Inc

Send name, and optionally limit (1 to 5). Florida's other parameters are accepted, change nothing, and are listed under inputs_not_used.

Fields
Entity number, name, status in California's own words and what it means, standing with the Secretary of State, the Franchise Tax Board and for its agent, entity type, first filing date, home state and the company's name there, principal, mailing and California office addresses, the agent for service of process, up to 25 officers, managers and members from the latest Statement of Information, and that statement's date.
Only in California
California's standing flags, the Statement of Information with up to 25 people, and a search of the company's name in its home state as well as its California name.
Limits
No status history and no former names, because California's file has neither. No warning flags, shared record counts or fact checks, and California publishes no EIN. California publishes this data without a promise of accuracy. For proof of status, ask the Secretary of State for a certificate of status, or check California's business search.

California business lookup API: every field, how to call it, a sample answer and how often the right company comes first.