Api Endpoint

Scrapebench API

New and existing business entities from four state registries (CO, OR, NY, CT) in one schema, filterable by state, formation date, city, county and entity type. Nightly refresh of each state's open-data file covering the last 400 days of formations; a `since` date returns only what is new.

Open interactive test console

Offering

Provider
api.scrapebench.dev
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Legal And Compliance
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.scrapebench.dev/v1/business-registrations
MIME type
Not provided
First seen
2026-10-16T04:15:40.848Z
Last seen
Tags
business-registrations, secretary-of-state, KYB, leads, public-records

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.06 USDC
Atomic price: 60000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "60000",
    "payTo": "0x1bd1e9431c00ba6ff992a3dda541282079d02abf"
  }
]

Observed health

Status
Reachable
Latest latency
296 ms
Average latency
893 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "properties": {
        "city": {
          "anyOf": [
            {
              "maxLength": 100,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Case-insensitive substring of the city of the entity's principal address.",
          "title": "City"
        },
        "county": {
          "anyOf": [
            {
              "maxLength": 100,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "County name, e.g. 'Kings' or 'Kings County'. Only NY publishes a county, so this filter returns NY rows only.",
          "title": "County"
        },
        "entity_type": {
          "anyOf": [
            {
              "enum": [
                "LLC",
                "Corp",
                "LP",
                "Nonprofit",
                "Other"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Normalised entity type: LLC, Corp, LP, Nonprofit or Other (LLPs, cooperatives and the rest).",
          "title": "Entity Type"
        },
        "name": {
          "anyOf": [
            {
              "maxLength": 100,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Case-insensitive substring of the entity name.",
          "title": "Name"
        },
        "since": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Only entities formed on or after this date (YYYY-MM-DD). Pass yesterday's date for the daily delta.",
          "title": "Since"
        },
        "states": {
          "description": "Registries to read: CO, OR, NY, CT. Default: all of them.",
          "items": {
            "enum": [
              "CO",
              "OR",
              "NY",
              "CT"
            ],
            "type": "string"
          },
          "maxItems": 4,
          "minItems": 1,
          "title": "States",
          "type": "array"
        },
        "status": {
          "default": "active",
          "description": "Registry standing, normalised: active (incl. delinquent filings), inactive (dissolved, withdrawn, rejected, revoked ...) or any.",
          "enum": [
            "active",
            "inactive",
            "any"
          ],
          "title": "Status",
          "type": "string"
        },
        "until": {
          "anyOf": [
            {
              "format": "date",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Only entities formed on or before this date (YYYY-MM-DD).",
          "title": "Until"
        }
      },
      "title": "Input",
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "next_page": {
          "anyOf": [
            {
              "type": "integer"
            },
            {
              "type": "null"
            }
          ],
          "description": "Page to request next, or null when this is the last.",
          "title": "Next Page"
        },
        "page": {
          "description": "Zero-based page number of this response.",
          "title": "Page",
          "type": "integer"
        },
        "page_size": {
          "description": "Most rows a page can hold; one page is one price.",
          "title": "Page Size",
          "type": "integer"
        },
        "rows": {
          "description": "Data rows, or free Notice rows explaining a gap.",
          "items": {
            "anyOf": [
              {
                "additionalProperties": false,
                "properties": {
                  "city": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "City of the principal address.",
                    "title": "City"
                  },
                  "county": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "County, where the registry publishes one (NY), else null.",
                    "title": "County"
                  },
                  "county_method": {
                    "description": "'published' when the registry gives the county, 'none' otherwise.",
                    "title": "County Method",
                    "type": "string"
                  },
                  "entity_id": {
                    "description": "The registry's own entity / file number.",
                    "title": "Entity Id",
                    "type": "string"
                  },
                  "entity_key": {
                    "description": "Stable key across states and refreshes: '<state>:<entity_id>'.",
                    "title": "Entity Key",
                    "type": "string"
                  },
                  "entity_type": {
                    "description": "Normalised type: LLC, Corp, LP, Nonprofit or Other.",
                    "title": "Entity Type",
                    "type": "string"
                  },
                  "entity_type_raw": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Entity type as the registry writes it, e.g. 'DLLC' or 'DOMESTIC LIMITED LIABILITY COMPANY'.",
                    "title": "Entity Type Raw"
                  },
                  "formation_date": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Formation (or, for a foreign entity, registration) date, YYYY-MM-DD. CO can show a future, delayed effective date.",
                    "title": "Formation Date"
                  },
                  "jurisdiction": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Jurisdiction of formation, e.g. 'CO', 'Delaware'.",
                    "title": "Jurisdiction"
                  },
                  "name": {
                    "description": "Entity name as registered.",
                    "title": "Name",
                    "type": "string"
                  },
                  "principal_address": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "The entity's principal business address on one line, as the registry lists it.",
                    "title": "Principal Address"
                  },
                  "registered_agent": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Registered agent's name as published (a business record). Agent addresses are never included.",
                    "title": "Registered Agent"
                  },
                  "registry_url": {
                    "description": "The entity's page on the registry when the data links one (OR), else the state's public entity search.",
                    "title": "Registry Url",
                    "type": "string"
                  },
                  "scraped_at": {
                    "description": "UTC timestamp of the read.",
                    "format": "date-time",
                    "title": "Scraped At",
                    "type": "string"
                  },
                  "source_url": {
                    "description": "The URL or endpoint this record was read from.",
                    "title": "Source Url",
                    "type": "string"
                  },
                  "state": {
                    "description": "Two-letter code of the registry the row came from.",
                    "title": "State",
                    "type": "string"
                  },
                  "status": {
                    "description": "Normalised standing: active or inactive.",
                    "title": "Status",
                    "type": "string"
                  },
                  "status_raw": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "Status as the registry writes it, e.g. 'Good Standing'. OR and NY publish active entities only ('Active').",
                    "title": "Status Raw"
                  },
                  "zip": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "default": null,
                    "description": "ZIP of the principal address.",
                    "title": "Zip"
                  }
                },
                "required": [
                  "source_url",
                  "entity_key",
                  "state",
                  "entity_id",
                  "name",
                  "entity_type",
                  "status",
                  "county_method",
                  "registry_url"
                ],
                "title": "Output",
                "type": "object"
              },
              {
                "additionalProperties": false,
                "description": "A free row explaining why a page has no (or partial) data. Never charged.",
                "properties": {
                  "notice": {
                    "description": "Human-readable reason, and what to send instead if the input was the problem.",
                    "title": "Notice",
                    "type": "string"
                  },
                  "notice_type": {
                    "default": "input_error",
                    "description": "Machine-readable reason: input_error, no_results, blocked, truncated, source_changed, not_ready or stale.",
                    "title": "Notice Type",
                    "type": "string"
                  },
                  "scraped_at": {
                    "description": "UTC timestamp of the read.",
                    "format": "date-time",
                    "title": "Scraped At",
                    "type": "string"
                  },
                  "source_url": {
                    "default": "",
                    "description": "Empty: a notice is about the request, not about a page.",
                    "title": "Source Url",
                    "type": "string"
                  }
                },
                "required": [
                  "notice"
                ],
                "title": "Notice",
                "type": "object"
              }
            ]
          },
          "title": "Rows",
          "type": "array"
        },
        "service": {
          "description": "The service that answered.",
          "title": "Service",
          "type": "string"
        }
      },
      "required": [
        "service",
        "page",
        "page_size",
        "next_page",
        "rows"
      ],
      "title": "BusinessRegistrationsPage",
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}