Events fit score

Calculate how well a Lensmor event matches a company profile using fit scores, explanation signals, and recommendation context.

Score a single event against the authenticated caller’s current profile context.

Use this endpoint when you already know the target event and want a compact compatibility result instead of a full ranked list.

When to use this endpoint

Use POST /external/events/fit-score when your UI needs to answer a focused question: “Is this event a good fit for the current profile?”

It works best after an event has already been selected from search, profile recommendations, or a saved shortlist. If you need to rank multiple candidates, use Events rank. If you need a full recommendation page from profile inputs, use Apply profile and get recommended events.

Endpoint

POST /external/events/fit-score

Authentication

See Authentication

Success status code

201 Created

Request body

Name	Required	Type	Notes
event_id	Yes	string	Event identifier.

Request example

curl -X POST "https://platform.lensmor.com/external/events/fit-score" \
  -H "Authorization: Bearer $LENSMOR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"139574"}'

Response example

{
  "event": {
    "id": "123",
    "eventId": "139574",
    "name": "NRF 2026",
    "nickname": null,
    "description": "Retail industry event",
    "url": "https://example.com/events/nrf-2026",
    "dateStart": "2026-01-12",
    "dateEnd": "2026-01-15",
    "venue": "Javits Center",
    "city": "New York",
    "region": "NY",
    "country": "United States",
    "exhibitorCount": 950,
    "image": null,
    "dataSource": "database"
  },
  "score": 8.1,
  "recommendation": "recommended",
  "breakdown": {
    "profile_match": 8.1,
    "matched_exhibitor_density": 1.9,
    "event_scale": 9.5
  }
}

Response fields

Field	Description
event	Compact event object for the scored event.
score	Numeric compatibility score for the authenticated caller’s current profile context.
recommendation	Human-readable recommendation category.
breakdown.profile_match	Profile-context compatibility component.
breakdown.matched_exhibitor_density	Signal based on relevant exhibitor overlap or density.
breakdown.event_scale	Signal based on event size and scale.

Interpretation guidance

• Use score for display and ordering, but avoid treating small differences as exact truth.
• Use recommendation as the primary user-facing label.
• Use breakdown to explain why an event is strong or weak when your UI has space for detail.

Error responses

• 400 Bad Request
• 401 Unauthorized
• 404 Not Found
• 409 Conflict
• 429 Too Many Requests

Notes

• This endpoint uses POST because the request body can contain structured profile context that does not fit cleanly in query parameters. It does not create a persistent resource.
• The current implementation returns event, score, recommendation, and breakdown only.
• Older draft fields such as breakdown_details are not part of the live response.