Franchise filingsState recordsTexas and Florida

Who sells franchises, under which brands, and since when.

Before a franchisor sells franchises in some states, it files there: a registration, or a notice that it is exempt. pdatum reads those filings and serves them in one shape: every one the Texas Secretary of State lists, and every franchisor Florida lists with where its filing stands. Each names the franchisor, its brands and the names it gave up, and links to the private companies lenders hold.

Request a key

More than 16,000 Texas filings back to 1985, and more than 2,700 Florida franchisors, read every week.

Illustrative: Acme and its filing are invented.

What a script can ask

The questions the feed is built to answer, and the field that answers each.

Is this company a franchisor?

A filing links to a company we track when one of its legal or brand names is that company's name. A franchisor often files under a subsidiary named for its brand, so a link someone reviewed says what it rests on instead.

"matched": "ACME TUTORING" // or "evidence"

Which brands does it sell?

The state writes every name in one field. names splits it: the franchisor's legal name, its brands (trade), and the names it used to have (former), which never link.

{"name": "ACME TUTORING", "kind": "trade"}

When did it start, and has it stopped?

filed_at is when it registered or filed its exemption. status says where the filing stands in words every state shares, and state_status in the state's own, which can say why a franchisor stopped.

"state_status": "Closed - Out of Business"

Is the state read at all?

/franchises/states lists every state and DC, and why we do not read the ones we do not. Asking only about a state we do not read is refused with the reason, never answered with a zero.

404 not_found // "We don't read IN ..."

What a record holds

One record per filing. The API reference has a whole example.

state, filing
Where it was filed, and the state's own number for it. Texas reused some numbers in the 1980s, so id is what identifies a filing.
filed_as, name, names
The franchisor exactly as the state wrote it, its legal name, and every name split out as legal, trade or former.
kind, status, state_status
A registration or an exemption; and registered, exempt, expired or terminated, beside the status in the state's own words where it gives them.
filed_at, registered_at, exempt_at, terminated_at, expires_at
The dates the state lists, including when a filing renewed every year runs out. A date that cannot be real, like a year of 0222, is null rather than a guess.
address, city, region, zip
The franchisor's address as the state lists it, and its parts when they read as one.
company, matched, evidence
The company under Companies it links to, and either the name that matched or what a reviewed link rests on.
employer_slug
The employer record whose name is one of the franchisor's, by name only.
source, observed_at
The state's page, and when we first read the filing. Every filing read is kept.

Good to know

How the data behaves, in brief. The front page lists every source we read, and the API reference has the rest.

  • Texas and FloridaEvery franchisor's filing with Texas, back to 1985, and every franchise exemption Florida lists, each read every week. /franchises/states lists every state and when each was last read.
  • Links are leadsA filing links to a company when the names are the same. A franchisor files under its own name, so a reviewed link is what connects one to its parent.
  • Filings, with their datesEach filing is the registration or exemption a franchisor makes with the state: who, when, and when it ended.

The other feeds

Jobs and employers

Open postings with their full text, the employers behind them, and a changes feed that keeps a copy in sync, with dates a backtest can trust.

GET/api/v1/jobs

Federal awards

The contracts and grants federal agencies have awarded any company you name, from USAspending.gov: how many, how much, from which agencies, and when the work ends.

GET/api/v1/awards

BDC books

Every loan a business development company reports each quarter, from its SEC filings, and how every other lender we read marks the same loan.

GET/api/v1/bdc/books/{ticker}

Companies

Every private company the BDCs we read hold, under every name their lenders file it as, with one slug. Any name can be looked up; one we do not hold is searched for on EDGAR.

GET/api/v1/companies/resolve

WARN notices

The layoff and closure notices states publish under the WARN Act, read every day and served in one shape: the employer, the place, how many people and when, linked to the companies lenders hold.

GET/api/v1/warn

Capital raises

Every private capital raise a company has reported to the SEC on Form D since 2008: how much it offered, how much it sold and to how many investors, linked to the companies lenders hold.

GET/api/v1/raises

Ask for a key

Keys are issued by hand while the API is young. Write to pdatum@pearachute.com and say what you are building and which data you need. If you need a state we do not read yet, say which: requests decide which comes next.