Themes, Boundaries & Taxonomies API
These endpoints provide metadata, styling configuration, boundary shapes, and standard taxonomies that power district discovery experiences.
1. District Themes (/v0.3/themes/)
Themes define branding, colors, typography, and embed layout configurations for a specific client district or neighborhood.
Endpoints
GET /v0.3/themes/— List all public themes.GET /v0.3/themes/{slug}/— Retrieve complete theme styling and configuration tokens by slug (e.g./v0.3/themes/clermont/).
Request
GET https://api.vibemap.com/v0.3/themes/clermont/ HTTP/1.1
Host: api.vibemap.com
Key Response Fields
name: Display name of the district (e.g."Connect Clermont").slug: URL identifier (e.g."clermont").color: Primary brand accent color hex (e.g."#0072ce").branding: Logos, favicon, and partner visual identity assets.design_tokens: Typography, border radii, shadows, and color palette tokens.layout: Display defaults for map styles, cards, and filter toggles.
2. Boundaries API (/v0.3/boundaries/)
Boundaries represent geographical polygons (neighborhoods, BIDs, downtown districts, or municipal borders).
Endpoints
GET /v0.3/boundaries/— List boundaries.GET /v0.3/boundaries/{id}/— Retrieve detailed boundary record with polygon geometries.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
show_in_app | boolean | Filter boundaries designated for public applications (true). |
type | string | Filter by boundary classification (e.g. neighborhood, bid, city). |
search | string | Search boundary by name or city. |
3. Taxonomies: Categories, Vibes & Tags
Standard vocabularies used across Vibemap for tagging and search filtering.
Categories (GET /v0.3/categories)
Returns the hierarchical taxonomy of place and event categories:
{
"categories": [
{
"id": 1138,
"slug": "arts",
"name": "Arts & Culture",
"parent": null
},
{
"id": 1791,
"slug": "gallery",
"name": "Art Gallery",
"parent": "arts"
}
]
}
Vibes (GET /v0.3/vibes/)
Returns the complete list of canonical vibe tags used for experiential filtering:
{
"all_vibes": [
{ "name": "cozy" },
{ "name": "lively" },
{ "name": "family-friendly" },
{ "name": "romantic" },
{ "name": "scenic" }
]
}
Tags (GET /v0.3/tags/)
Returns editorial and municipal taxonomy tags (such as black-owned, women-owned, wheelchair-accessible).
4. Search Autocomplete (/v0.3/search/autocomplete/)
Fast prefix lookup for search inputs:
GET https://api.vibemap.com/v0.3/search/autocomplete/?q=coffee HTTP/1.1
Host: api.vibemap.com
Response Example
{
"results": [
{
"id": "e932b109-8472-4638-9210-983b6320a102",
"name": "Coffee Emporium",
"model": "place"
}
]
}