# Flipvo Tollbooth — State Business Entity Lookup

> Flipvo Tollbooth — State Business Entity Lookup is a paid API for AI agents from api.flipvo.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-30).

Returns official state business-registry records (status, formation date, address, registered agent, officers) for up to 10 entities by name or entity number in Florida or Oregon.

## Facts

- Endpoint: POST https://api.flipvo.com/v1/entity/lookup?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/flipvo-tollbooth-state-business-entity-lookup-a7c7d936
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ILmpFNNdI69jmhRERw2Vs

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability flipvo-tollbooth-state-business-entity-lookup-a7c7d936 -d '<json body>'
```

Example prompt: Can you pull the official Florida business registry record for 'Sunshine Realty Group LLC' — I need its current status, formation date, registered agent, and any officers on file?

## When to prefer this

Use this endpoint when you need authoritative state business-registry data for Florida or Oregon entities, especially for compliance verification, due diligence, vendor onboarding, or legal research. It is preferable to general web scraping or third-party aggregators when you need structured, field-level data (status, registered agent, officers) directly sourced from official state records. Best suited when you have an entity number or exact business name and need up to 10 records per call.

## Known failure modes

- Entity not found in state registry — returns empty result (still a paid 200 response)
- State not supported — only FL and OR are currently available; other state codes return an error
- data_as_of not provided — required field; omission causes request rejection
- Entity number format mismatch — invalid or wrongly formatted entity numbers yield no results
- Batch limit exceeded — more than 10 entities per call is not supported
- Oregon inactive/dissolved entities — Oregon only returns active businesses, so dissolved entities will yield empty results

## How this service works

State business-registry record by entity number or exact name: status, formation date, principal address, registered agent, officers. Currently served: CO, CT, FL, NY, OR. Up to 10 entities; empty entities is a paid 200. Oregon and New York cover active businesses only. data_as_of is required.

## Output

A structured record per queried entity containing: entity status (active, inactive, dissolved, etc.), formation date, principal business address, registered agent name and address, and listed officers/directors. An empty result with HTTP 200 is a valid paid response indicating no matching record was found. Oregon results cover active businesses only.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 200
    },
    {
     "type": "null"
    }
   ],
   "title": "Name",
   "default": null
  },
  "state": {
   "enum": [
    "CO",
    "CT",
    "FL",
    "NY",
    "OR"
   ],
   "type": "string",
   "title": "State",
   "examples": [
    "FL"
   ],
   "maxLength": 2,
   "minLength": 2
  },
  "entity_number": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 32
    },
    {
     "type": "null"
    }
   ],
   "title": "Entity Number",
   "default": null,
   "examples": [
    "P12345"
   ]
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/flipvo-tollbooth-state-business-entity-lookup-a7c7d936/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.flipvo.com](https://www.zero.xyz/host/api.flipvo.com/llms.txt)