---
title: "Get details suggestion for a given event."
method: GET
path: "/integrations/calendar/events/{event_id}/details-suggestion"
tags: ["calendar"]
---

# Get details suggestion for a given event.

`GET /integrations/calendar/events/{event_id}/details-suggestion`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/integrations/calendar/events/{event_id}/details-suggestion`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/integrations/calendar/events/:event_id/details-suggestion/get.ts> (a function with typed inputs; its response is checked against the schema)

Given an event ID, this endpoint responds with the most probable event details (and the accuracy) to
assign to the to-be-created time entry.
This endpoint will only suggests time entries with description and project not empty, because it uses the
description to tell if the TE is similar and the project as the main detail to be suggested.

If the description is equal, as well as all the other details, the accuracy will be 100%, in the case
the description is equal but the other details differs, the most frequent will be suggested and the
accuracy will be given based on the frequency. In the case there is no TE with the same description
the most similar will be suggested based on the Jaro-Winkler algorithm, and the accuracy will be the
similarity rating.

This endpoint returns status 200 OK and a "null" string in case no suggestion was found.

## Path parameters

- `event_id` integer, required

## Response `200`

Suggestion of project to fill

- ModelsSuggestion
  - `accuracy` number
  - `billable` boolean
  - `description_match` boolean
  - `last_seen` string
  - `project_id` integer
  - `tag_ids` integer[]
  - `task_id` integer
  - `workspace_id` integer

## Other responses

- `400`: Invalid event ID
- `403`: Possible error messages:<ul><li>the user has no access to this calendar feature</li><li>the user has no access to this event</li><li>event with ID {event_id} was not found</li></ul>
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)