Documentation Index
Fetch the complete documentation index at: https://api.lensmor.com/llms.txt
Use this file to discover all available pages before exploring further.
Events fit score
Score a single event against the authenticated caller’s current profile context.
Endpoint
POST /external/events/fit-score
Authentication
See Authentication
Success status code
201 Created
Request body
| Field | Required | Type | Notes |
|---|
event_id | Yes | string | Event identifier returned by Lensmor event endpoints. |
Response body
Top-level fields
| Field | Type | Notes |
|---|
event | object | Event summary for the scored event. |
score | number | Normalized to a 0.0-10.0 style scale. |
recommendation | string | One of recommended, consider, or not_recommended. |
breakdown | object | Contains profile_match, matched_exhibitor_density, and event_scale. |
event fields
| Field | Type | Notes |
|---|
id | string | Lensmor event identifier. |
eventId | string | Source event identifier, when available. |
name | string | Event name. |
nickname | string or null | Event short name. |
description | string or null | Event description. |
url | string or null | Event website URL. |
dateStart | YYYY-MM-DD string or null | Start date. |
dateEnd | YYYY-MM-DD string or null | End date. |
venue | string or null | Venue name. |
city | string or null | City. |
region | string or null | Region or state. |
country | string or null | Country. |
attendeeCount | integer or null | Attendance count, when available. |
exhibitorCount | integer or null | Exhibitor count, when available. |
personnelCount | integer or null | Personnel count, when available. |
image | string or null | Image URL. |
breakdown fields
| Field | Type | Notes |
|---|
profile_match | number | Profile similarity component. |
matched_exhibitor_density | number | Matched exhibitor density component. |
event_scale | number | Event scale component. |
Response example
{
"event": {
"id": "123",
"eventId": "139574",
"name": "Shoptalk",
"nickname": null,
"description": null,
"url": "https://example.com",
"dateStart": "2026-03-25",
"dateEnd": "2026-03-28",
"venue": "Convention Center",
"city": "Las Vegas",
"region": "Nevada",
"country": "United States",
"exhibitorCount": 250,
"image": null
},
"score": 7.8,
"recommendation": "recommended",
"breakdown": {
"profile_match": 7.8,
"matched_exhibitor_density": 2.4,
"event_scale": 2.5
}
}
Error responses
400 Bad Request when event_id is missing or invalid.401 Unauthorized when the API key is missing, malformed, or invalid.404 Not Found when the target event cannot be resolved.409 Conflict when the recommendation dependency is still processing.
Notes
- Use the event
id returned by Lensmor event endpoints when requesting a fit score.
