---
title: "List new businesses"
method: GET
path: "/api/businesses"
tags: ["New businesses"]
---

# List new businesses

`GET /api/businesses`

## Request

- Base URL: `https://noozra.com`
- URL: `https://noozra.com/api/businesses`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/noozra/apis/noozra-news-api/docs/api/businesses/get.ts> (a function with typed inputs; its response is checked against the schema)

Businesses newly licensed or registered in a city, from each city's open-data portal. Each item's `date` is the day the business was licensed or registered. Sort with `sort`; page by passing `next_cursor` back as `cursor`. `as_of` is when the data was last known current. Records dated in the last 14 days for every key; API Pro reaches every record.

## Query parameters

- `city` string
- `q` string
- `naics` string
- `after` string, date
- `sort` 'newest'
- `cursor` string
- `limit` integer

## Response `200`

OK

- BusinessesResponse
  - `as_of` string, date-time, nullable, required: When this dataset was last known current: the oldest last successful read among its sources (the city's own, with `city`).
  - `businesses` Business[], required
    - `activity` string, nullable, required
    - `city` string, required: The city's slug.
    - `date` string, date, required: YYYY-MM-DD: the day the business was licensed or registered.
    - `description` string, nullable, required: The source's own text, at most 1000 characters.
    - `id` string, uuid, required
    - `naics` Classification, required
      - `code` string, required
      - `description` string, nullable, required
    - `name` string, required
    - `place` Place, required
      - `address` string, nullable, required
      - `city` string, nullable, required
      - `country` string, nullable, required: ISO 3166-1 alpha-3, such as USA.
      - `latitude` number, nullable, required
      - `longitude` number, nullable, required
      - `state` string, nullable, required: Two-letter state.
      - `zip` string, nullable, required
    - `reference` string, required: The record's own number at its source.
    - `source` string, required: Who published the record. Name it when you show the record.
    - `url` string, uri, nullable, required: The record at its source; for a city record without a page of its own, the city's dataset.
  - `count` integer, required
  - `next_cursor` string, nullable, required: Pass as `cursor` for the next page; null at the end.

## Other responses

- `400`: A parameter out of shape (the `error` says which), a sort this dataset does not take, a cursor not given out for this sort, or a date outside 1970–9999
- `401`: No API key, or an invalid or revoked one
- `403`: `after` reaches past the last 14 days: that needs API Pro
- `429`: Daily rate limit exceeded (honor the Retry-After header)

## Changes

- **2026-10-29** `e0c2d7df6d6f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/noozra/apis/noozra-news-api/changes/api/businesses/get.md)

---

[API](https://skmtc.dev/noozra/apis/noozra-news-api.md) - [All operations](https://skmtc.dev/noozra/apis/noozra-news-api/llms.txt) - [OpenAPI document](https://skmtc.dev/noozra/apis/noozra-news-api/revisions/9067da767e84?raw)