GET /v1/metadata

Public, unmetered dataset metadata and capability discovery for Compass DaaS.

Request

Field	Type	Notes
Authentication	none	Public endpoint. No API key or auth header is required.
Quota	none	Does not consume Compass credits and is available to all tiers.
Response status	200 \| 304 \| 500	Returns JSON, a cache revalidation response, or an internal error.

curl "https://api.compassfoodtechnologies.com/v1/metadata"

Response

Field	Type	Notes
datasetVersion	string	Dataset version date for the published searchable corpus.
totalRestaurants	integer	Current searchable restaurant count exposed by Compass.
totalWithVeganScore	integer	Restaurants with deterministic VeganScore coverage.
lastUpdated	date-time	Timestamp for the current metadata snapshot. Restaurant and response freshness use last_evaluated_at on restaurant-bearing endpoints.
coverageByCountry	object	Country-code counts for public dataset coverage.
averageVeganScore	number	Average deterministic VeganScore from 0 to 100.
scoringVersion	string	Dataset scoring version stamp.
cuisineDistribution	object	Public cuisine-count distribution.
api_version	string	Current public API version. Currently v1.
supported_enums	object	Accepted request enums and response enums. Diet values are preference inputs; they are not certification/free-from fact fields.
available_regions	array	Public region slugs available for the current launch. Currently us.
model_versions	object	Current scoring and embedding model/version stamps.

{
  "datasetVersion": "2026-05-04",
  "totalRestaurants": 374041,
  "totalWithVeganScore": 360000,
  "lastUpdated": "2026-05-04T09:30:00.000Z",
  "coverageByCountry": {
    "US": 374041
  },
  "averageVeganScore": 72,
  "scoringVersion": "v3.0-deterministic",
  "cuisineDistribution": {
    "Vegan": 18250,
    "Italian": 14600
  },
  "api_version": "v1",
  "supported_enums": {
    "diets": [
      "strict_vegan",
      "vegetarian",
      "pescatarian",
      "gluten_free",
      "halal",
      "kosher",
      "low_fodmap"
    ],
    "decisions": ["fit", "not_fit", "unknown"],
    "confidences": ["high", "medium", "low"],
    "risk_flags": [
      "cross_contamination_risk",
      "limited_evidence",
      "stale_data",
      "third_party_unverified",
      "user_report_only",
      "language_barrier"
    ],
    "evidence_tiers": ["A", "B"],
    "evidence_types": [
      "menu_item",
      "review_signal",
      "external_source",
      "user_report",
      "restaurant_declared"
    ]
  },
  "available_regions": ["us"],
  "model_versions": {
    "scoring": "v3.0-deterministic",
    "embedding_model": "voyage-4-large-512d-v1"
  }
}