# NYC DCA Business License Lookup

> NYC DCA Business License Lookup is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches NYC Department of Consumer and Worker Protection (DCWP/DCA) license records by business name and returns license details including number, category, status, expiry, and address.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/nyc-business-licenses?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nyc-dca-business-license-lookup-2f50d14e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HxbxZuFxLnNQuSPVkX9tq

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 nyc-dca-business-license-lookup-2f50d14e
```

Example prompt: Can you check if 'Gotham Pawn Shop' has a valid NYC Department of Consumer and Worker Protection license — I want to see their license number, category, and when it expires?

## When to prefer this

Use this endpoint when you need to verify or retrieve official NYC DCWP/DCA license information for a specific business by name — particularly for compliance checks, vendor due diligence, or consumer protection verification in New York City. Prefer this over generic web search when you need structured, authoritative license data (number, status, expiry, category) directly from the official NYC open data source. Choose the NYC Small Business Services endpoint instead if you need certified business (M/WBE) status rather than consumer protection licenses.

## Known failure modes

- No results returned if business name does not match any DCA record (count: 0, empty results array)
- Query string shorter than 2 characters or longer than 60 characters will be rejected
- Special characters outside letters, digits, spaces, periods, commas, ampersands, and hyphens will cause a validation error
- Upstream NYC Open Data (Socrata) outage may result in service unavailability
- Partial name matches may return unrelated businesses requiring client-side filtering
- Limit parameter outside 1-25 range may cause an error or be clamped

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object with a count of matching records, the original query, a source URL pointing to the NYC Open Data Socrata dataset, a checkedAt timestamp, and a results array where each item contains: businessName, licenseNumber, licenseType, category, status, created date, expires date, borough, and full address.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Business name part, letters, digits, spaces and . , & - only, 2 to 60 characters"
      },
      "limit": {
       "type": "string",
       "description": "Rows to return, 1 to 25 (default 10)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "query": "james robinson",
  "source": "https://data.cityofnewyork.us/resource/w7w3-xahh.json",
  "results": [
   {
    "status": "Active",
    "address": "480 PARK AVENUE NEW YORK NY 10022",
    "borough": "Manhattan",
    "created": "2003-10-31",
    "expires": "2027-07-31",
    "category": "Secondhand Dealer - General",
    "licenseType": "Premises",
    "businessName": "JAMES ROBINSON, INC.",
    "licenseNumber": "0016371-DCA"
   }
  ],
  "checkedAt": "2026-10-23T09:37:39.143Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nyc-dca-business-license-lookup-2f50d14e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)