---
title: "List published business index"
method: GET
path: "/v1/businesses/index.json"
tags: ["Discovery"]
---

# List published business index

`GET /v1/businesses/index.json`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/businesses/index.json`
- Auth: none declared

Returns published profiles only. Directory listings are intentionally excluded. Cursor-paginated: pass limit (1-100, default 100) and cursor (the next_cursor value from the previous page); next_cursor is present only when more pages exist, so small registries fit in one unpaginated response. Public-read by default; some deployments may require a Loppee API key.

## Query parameters

- `limit` number
- `cursor` string

## Response `200`

BusinessIndex

- BusinessIndex
  - `schema_version` '3.0', required
  - `trust_model_version` 'v3', required
  - `registry_name` 'Loppee', required
  - `generated_at` string, date-time, required
  - `total_registry_records` integer, required
  - `registry_count_basis` string, required
  - `registry_count_observed_at` string, nullable, required
  - `published_profile_count` integer, required
  - `page_limit` integer
  - `next_cursor` string
  - `public_base_url` string, required
  - `search_url` string, required
  - `recommend_url` string, required
  - `trust_card_pattern` string, required
  - `domain_lookup_pattern` string, required
  - `publishing_rule` string, required
  - `businesses` object[], required
    - `business_id` string, required
    - `display_name` string, required
    - `street_address` string, nullable: Owner-published street address where authorized. Registry candidates return an empty string; withheld data must not be inferred as a missing source address.
    - `zip` string, nullable: Owner-published postal code where authorized. Registry candidates return an empty string; city/state remain public.
    - `domain` string, nullable, required
    - `category` string, required
    - `city` string, required
    - `state` string, required
    - `website` string, nullable, required
    - `phone` string, nullable, required
    - `trust_model_version` 'v3', required
    - `verification_class` 'verified' | 'listed', required
    - `verification_disclosure` 'Loppee completed this business's registration, professional license, and contact checks.' | 'Loppee completed this business's registration and contact checks.' | 'Recommended by customers. NOT verified by Loppee.' | 'Listed on Loppee. NOT verified by Loppee.', required
    - `review_reputation` object, required
      - `display_rating` number, nullable, required
      - `display_review_count` integer, required
      - `verified_review_count` integer, required
      - `ranking` union, required
        - object
          - `status` 'quality_ranked', required
          - `basis` 'identity_verified_reviewer_reviews', required
          - `half_star_band` number, required
          - `explanation` 'Ratings from identity-verified reviewers influence quality ordering within the applicable business class or Registry pool. They do not verify the business, prove a transaction, change discovery reach, or permit paid influence.', required
        - object
          - `status` 'unrated', required
          - `basis` 'identity_verified_reviewer_reviews', required
          - `half_star_band` unknown, required
          - `explanation` 'No identity-verified reviewer rating is available. There is no reviewer-quality ranking signal for this business.', required
      - `latest_review_snippet` string, nullable
      - `counts_truncated` boolean
      - `reviews_url` string
      - `identity_verified_review_count` integer, required
      - `quality_rating` number, nullable, required
    - `trust_card_url` string, required
    - `public_profile_url` string, required
    - `insurance` object
      - `status` 'owner_provided', required
      - `carrier_name` 'Not publicly disclosed', required
      - `stated_expires_at` string, nullable, required
      - `disclosure` 'Insurance certificate provided by the business. Not independently confirmed by Loppee.', required
    - `brand_assets` object, nullable
      - `logo_url` string, nullable, required
      - `hero_image_url` string, nullable, required
      - `gallery_image_urls` string[], required
      - `hero_alt` string, required
      - `source` string, required

## Other responses

- `429`: RateLimitError
- `default`: ErrorResponse

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)