Business Data Schema
Truee returns business data in two levels: search results and full business profiles.
Search result
A compact search result contains:
| Field | Description |
|---|---|
id | Stable business ID. |
name | Registered or public business name. |
slug | Public profile slug. |
title | Search-friendly title. |
summary | Short business summary. |
category | Primary category. |
location | Human-readable location. |
verified | Whether the business is verified. |
freshness | Freshness bucket: FRESH, RECENT, STALE, or LEGACY. |
qualification_status | QUALIFIED, PARTIAL, or INCOMPLETE. |
match_score | Relevance score from 0 to 1. |
profile_url | Human profile URL. |
data_url | API profile URL. |
Full business profile
Fetch a full profile with:
GET /registry/businesses/{idOrSlug}
Full profiles can include:
- Business identity and description.
- Locations and branches.
- Products and services.
- Announcements and media.
- Contact fields.
- Trust signals and verification state.
- Freshness and scoring metadata.
Delta sync
Use delta sync to keep your local cache fresh:
GET /registry/updated?since=2026-05-01T00:00:00Z
This returns changed business IDs and update metadata.