Skip to main content

​
Recommended exhibitors for event

Return recommended exhibitors for a single event. Use this endpoint when you already know the target event and want exhibitor recommendations under the caller’s current recommendation state.

​
Endpoint

GET /external/profile-matching/recommendations/exhibitors

​
Authentication

See Authentication

​
Success status code

200 OK

​
Query parameters

NameRequiredTypeNotes
event_idYesstringSupports either Event.eventId or internal Event.id.
pageNointegerDefaults to 1.
pageSizeNointegerDefaults to 20; maximum 100.
locationNostringCountry or region filter.
searchQueryNostringCompany-name or description search.
exhibitorNameNostring[]Exact-name filter; repeated query params are normalized into arrays.
categoryNostring[]Category filter.
industryNostring[]Industry-name filter; repeated query params are normalized into arrays.
employeesMinNointegerMinimum employee count.
employeesMaxNointegerMaximum employee count.

​
Response example

{
  "items": [
    {
      "id": "456",
      "companyName": "Acme Retail Systems",
      "description": "Retail analytics platform",
      "logo": null,
      "website": "https://acme.example",
      "country": "United States",
      "industry": "Retail Technology",
      "categories": ["Retail", "POS"],
      "employeeCount": 220,
      "fundingRound": "Series B",
      "techStacks": ["Cloudflare", "Nginx"]
    }
  ],
  "total": 87,
  "page": 1,
  "pageSize": 20,
  "totalPages": 5,
  "hasMore": true
}

​
Error responses

  • 400 Bad Request
  • 401 Unauthorized
  • 404 Not Found

​
Notes

  • Unknown event_id values are normalized to 404 EVENT_NOT_FOUND responses.
  • The request parameter event_id refers to the event identifier returned elsewhere as eventId, not the internal id field.
  • The route may return fallback metadata at the top level: code: "AI_SEARCH_RESULT_MISMATCH" and show_refresh_hint: true.
  • In fallback mode, items.length may be smaller than pageSize even when hasMore is true because stored recommended exhibitor ids can resolve to deleted or missing exhibitor rows.
  • categories is preserved when recommendation data contains category labels.
  • techStacks is always returned as an array; when no data is available, the API returns techStacks: [].