POST a UserQuery JSON body to /users/query.
Request body
Response
Pull to refresh
Enter to send · Shift + Enter for a new line
Vendor semantic catalog
Upload, inspect, test, and publish vendor meanings before they are used in production.
Business describes intent, field names the database field, and value maps words to stored values.
View sample JSON format
{
"concepts": [
{
"name": "active_vendor",
"type": "business",
"field": "status",
"operator": "equals",
"value": 1,
"description": "A vendor whose status is active.",
"phrases": ["active vendor", "active restaurants"],
"examples": ["How many vendors are active?"]
},
{
"name": "verified_vendor",
"type": "business",
"field": "verified",
"operator": "equals",
"value": 1,
"description": "A vendor that has been verified.",
"phrases": ["verified vendor", "verified restaurants"],
"examples": ["List verified vendors"]
},
{
"name": "free_delivery_vendor",
"type": "business",
"field": "free_delivery",
"operator": "equals",
"value": 1,
"description": "A vendor offering free delivery.",
"phrases": ["free delivery vendor", "vendors with free delivery"],
"examples": ["How many vendors offer free delivery?"]
},
{
"name": "promoted_vendor",
"type": "business",
"field": "promoted",
"operator": "equals",
"value": 1,
"description": "A promoted vendor.",
"phrases": ["promoted vendor", "promoted restaurants"],
"examples": ["List promoted vendors"]
},
{
"name": "busy_vendor",
"type": "business",
"field": "is_busy",
"operator": "equals",
"value": 1,
"description": "A vendor currently marked busy.",
"phrases": ["busy vendor", "busy restaurants"],
"examples": ["How many vendors are busy?"]
},
{
"name": "restaurant_name",
"type": "field",
"field": "restaurant_name",
"description": "The vendor's restaurant name.",
"phrases": ["restaurant name", "vendor name", "called"],
"examples": ["Which vendors have Daavi in their name?"]
},
{
"name": "vendor_location",
"type": "field",
"field": "location",
"description": "The vendor's stored location.",
"phrases": ["in", "from", "located in"],
"examples": ["How many vendors are in UG?"]
},
{
"name": "vendor_rating",
"type": "field",
"field": "rating",
"description": "The vendor's current rating.",
"phrases": ["rating", "stars", "star rating"],
"examples": ["List vendors with at least 4 stars"]
},
{
"name": "commission",
"type": "field",
"field": "commission_percent",
"description": "The vendor commission percentage.",
"phrases": ["commission", "commission percentage"],
"examples": ["Show vendors with commission above 20"]
},
{
"name": "created_date",
"type": "field",
"field": "created_at",
"description": "When the vendor was created.",
"phrases": ["created date", "joined", "registered"],
"examples": ["List vendors created this month"]
},
{
"name": "active_value",
"type": "value",
"field": "status",
"operator": "equals",
"value": 1,
"description": "The stored value for active.",
"phrases": ["active"],
"examples": ["active vendors"]
},
{
"name": "verified_value",
"type": "value",
"field": "verified",
"operator": "equals",
"value": 1,
"description": "The stored value for verified.",
"phrases": ["verified"],
"examples": ["verified vendors"]
},
{
"name": "momo_value",
"type": "value",
"field": "payment_method",
"operator": "equals",
"value": "momo",
"description": "The stored value for mobile money.",
"phrases": ["momo", "mobile money"],
"examples": ["vendors accepting momo"]
},
{
"name": "instant_payout_value",
"type": "value",
"field": "payout_type",
"operator": "equals",
"value": "instant",
"description": "The stored value for instant payout.",
"phrases": ["instant payout", "instant"],
"examples": ["vendors with instant payout"]
}
]
}
Approved query tables
Click refresh to load schema
Parameters
Response
Benchmark
Latest breakdown
Run a benchmark to see timings
History
No runs recorded yet
Request audit log
Recent requests on this server. Method, path, status, and timing. Question text and API keys are not stored.
Open this tab to load the audit log.
Recent SQL and intent review
Admin-only. Shows question, generated filters, SQL, result state, and timing—not result rows.
Open this tab to load recent queries.