> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/concepts/activities/activities-api-and-webhooks/retrieve-scheduled-activity-details-by-id-api.md).
# Retrieve Scheduled Activity Details by ID API
{% hint style="success" %}
**Audience:** Developers and Solution Architects
**Purpose:** Enables you to retrieve the full details of a single scheduled Activity by ID using the Kizen API.
{% endhint %}
## Overview
Use the **Retrieve Scheduled Activity Details by ID** endpoint to fetch the complete details of a single Scheduled Activity using its unique identifier. This includes scheduling information, ownership, associations, notes, and completion metadata needed to fully understand or act on a specific planned Activity.
This endpoint is designed for detail-oriented use cases, such as inspecting a selected Scheduled Activity after discovery, validating scheduling state or timing, or retrieving authoritative data for synchronization, troubleshooting, or space.vars.automations.
The material on this page builds on information covered on the [Activities Core Concepts](/docs/concepts/activities/activities-core-concepts.md) and [Activities Data Model](/docs/concepts/activities/activities-data-model.md).
{% hint style="info" %}
**Note:** This API pulls the details of only one space.vars.activity by ID. To retrieve a full list of all your Scheduled Activities without details, check out [List Scheduled Activities API](/docs/concepts/activities/activities-api-and-webhooks/list-scheduled-activities-api.md).
{% endhint %}
### Why Would I Use This API?
You can use the Retrieving Scheduled Activity Details by ID API when you need to:
* Retrieve the complete, authoritative details for a single Scheduled space.vars.activity by ID
* Inspect scheduling metadata, ownership, associations, and notes for a selected Logged Activity
* Confirm whether a Scheduled space.vars.activity is still upcoming or has been completed and logged
* Synchronize a known Scheduled space.vars.activity with external systems after discovery
* Validate scheduling state or timing for troubleshooting, automation, or reconciliation workflows
* Follow the transition of a Scheduled space.vars.activity into a Logged space.vars.activity using completion metadata
### Retrieve Scheduled Activity Details by ID API Behavior
Use this endpoint to retrieve a single Scheduled space.vars.activity and evaluate its current planned state within the platform. It:
* Returns a Scheduled space.vars.activity by its unique identifier
* Displays the Scheduled space.vars.activity in the UI as an upcoming task based on `due_datetime`
* Maintains a Scheduled state until the space.vars.activity is completed and logged
* May trigger an `activity.completed` webhook when the Scheduled space.vars.activity is completed
* Marks the Scheduled space.vars.activity as Completed and includes metadata such as `completed_at` and `logged_activity_id` once logged
* Returns a response structured according to the [Activities Data Model](/docs/concepts/activities/activities-data-model.md) schema
***
## Retrieve Scheduled Activity Details by ID Endpoint
Want to try this endpoint out? Visit our [Swagger](https://app.go.kizen.com/api/docs/public/swagger#/activities/activities_scheduled_activity_retrieve) docs.
## GET /api/activities/scheduled-activity/{id}
> Get scheduled activity record by ID
```json
{"openapi":"3.0.3","info":{"title":"Kizen API","version":"1.0.0"},"security":[{"businessId":[],"userId":[],"apiKey":[]}],"components":{"securitySchemes":{"businessId":{"type":"apiKey","in":"header","name":"X-BUSINESS-ID"}},"schemas":{"ScheduledActivityV2Read":{"type":"object","properties":{"associated_entities":{"type":"array","items":{"$ref":"#/components/schemas/_AssociatedEntityRead"}},"id":{"type":"string","format":"uuid"},"note":{"type":"string"},"due_datetime":{"type":"string","format":"date-time"},"original_due_datetime":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"logged_activity_id":{"type":"string","format":"uuid"},"activity_object":{"type":"string"},"employee":{"type":"string"},"role":{"$ref":"#/components/schemas/SimpleRole"},"mentions":{"$ref":"#/components/schemas/EmployeeSerpy"},"associated_fields":{"type":"string"},"notifications":{"type":"string"},"created":{"type":"string","format":"date-time"},"access":{"$ref":"#/components/schemas/AccessSerpy"}},"required":["access","activity_object","associated_entities","associated_fields","completed_at","created","due_datetime","employee","id","logged_activity_id","mentions","note","notifications","original_due_datetime","role"]},"_AssociatedEntityRead":{"type":"object","properties":{"custom_object":{"$ref":"#/components/schemas/_CustomObjectRead"},"entity":{"$ref":"#/components/schemas/_EntityRead"},"custom_object_id":{"type":"string","format":"uuid","deprecated":true},"object_name":{"type":"string","deprecated":true},"object_api_name":{"type":"string","deprecated":true},"entity_id":{"type":"string","format":"uuid","deprecated":true},"name":{"type":"string","readOnly":true,"deprecated":true},"display_name":{"type":"string","readOnly":true,"deprecated":true}},"required":["custom_object","custom_object_id","display_name","entity","entity_id","name","object_api_name","object_name"]},"_CustomObjectRead":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"object_name":{"type":"string"}},"required":["id","name","object_name"]},"_EntityRead":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string","readOnly":true},"display_name":{"type":"string","readOnly":true}},"required":["display_name","email","id","name"]},"SimpleRole":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","maxLength":200},"default_for_new_users":{"type":"boolean"}},"required":["id","name"]},"EmployeeSerpy":{"type":"object","properties":{"picture_url":{"type":"string"},"id":{"type":"string","format":"uuid"},"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string","format":"email"},"display_name":{"type":"string"},"account_type":{"type":"string"}},"required":["account_type","display_name","email","first_name","id","last_name","picture_url"]},"AccessSerpy":{"type":"object","properties":{"view":{"type":"boolean"},"edit":{"type":"boolean"},"remove":{"type":"boolean"}},"required":["edit","remove","view"]}}},"paths":{"/api/activities/scheduled-activity/{id}":{"get":{"operationId":"activities_scheduled_activity_retrieve","description":"Get scheduled activity record by ID","parameters":[{"in":"path","name":"id","schema":{"type":"string","pattern":"^[0-9a-fA-F]{8}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{4}\\-[0-9a-fA-F]{12}$"},"required":true}],"tags":["activities"],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ScheduledActivityV2Read"}}},"description":""}}}}}}
```
### Retrieve Scheduled Activity Details by ID APISchema
## The ScheduledActivityV2Read object
```json
{"openapi":"3.0.3","info":{"title":"Kizen API","version":"1.0.0"},"components":{"schemas":{"ScheduledActivityV2Read":{"type":"object","properties":{"associated_entities":{"type":"array","items":{"$ref":"#/components/schemas/_AssociatedEntityRead"}},"id":{"type":"string","format":"uuid"},"note":{"type":"string"},"due_datetime":{"type":"string","format":"date-time"},"original_due_datetime":{"type":"string","format":"date-time"},"completed_at":{"type":"string","format":"date-time"},"logged_activity_id":{"type":"string","format":"uuid"},"activity_object":{"type":"string"},"employee":{"type":"string"},"role":{"$ref":"#/components/schemas/SimpleRole"},"mentions":{"$ref":"#/components/schemas/EmployeeSerpy"},"associated_fields":{"type":"string"},"notifications":{"type":"string"},"created":{"type":"string","format":"date-time"},"access":{"$ref":"#/components/schemas/AccessSerpy"}},"required":["access","activity_object","associated_entities","associated_fields","completed_at","created","due_datetime","employee","id","logged_activity_id","mentions","note","notifications","original_due_datetime","role"]},"_AssociatedEntityRead":{"type":"object","properties":{"custom_object":{"$ref":"#/components/schemas/_CustomObjectRead"},"entity":{"$ref":"#/components/schemas/_EntityRead"},"custom_object_id":{"type":"string","format":"uuid","deprecated":true},"object_name":{"type":"string","deprecated":true},"object_api_name":{"type":"string","deprecated":true},"entity_id":{"type":"string","format":"uuid","deprecated":true},"name":{"type":"string","readOnly":true,"deprecated":true},"display_name":{"type":"string","readOnly":true,"deprecated":true}},"required":["custom_object","custom_object_id","display_name","entity","entity_id","name","object_api_name","object_name"]},"_CustomObjectRead":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"object_name":{"type":"string"}},"required":["id","name","object_name"]},"_EntityRead":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"name":{"type":"string"},"email":{"type":"string","readOnly":true},"display_name":{"type":"string","readOnly":true}},"required":["display_name","email","id","name"]},"SimpleRole":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true},"name":{"type":"string","maxLength":200},"default_for_new_users":{"type":"boolean"}},"required":["id","name"]},"EmployeeSerpy":{"type":"object","properties":{"picture_url":{"type":"string"},"id":{"type":"string","format":"uuid"},"first_name":{"type":"string"},"last_name":{"type":"string"},"email":{"type":"string","format":"email"},"display_name":{"type":"string"},"account_type":{"type":"string"}},"required":["account_type","display_name","email","first_name","id","last_name","picture_url"]},"AccessSerpy":{"type":"object","properties":{"view":{"type":"boolean"},"edit":{"type":"boolean"},"remove":{"type":"boolean"}},"required":["edit","remove","view"]}}}}
```
***
## What’s Next?
After retrieving a specific scheduled space.vars.activity via the API, you can:
* Display detailed upcoming work in external applications or calendar views
* Confirm scheduling, ownership, or association details for a specific space.vars.activity
* Monitor when a scheduled Activity transitions into a logged space.vars.activity
* Use scheduled space.vars.activity data in time-based automations or workflows
For more information on scheduled and logged space.vars.activities, review the related topics below:
Related Topics
* [Scheduling Activities via API](/docs/concepts/activities/activities-api-and-webhooks/schedule-activities-api.md)
* [Viewing Logged Activity Details](/docs/concepts/activities/activities-api-and-webhooks/view-logged-activity-details-api.md)
* [Listing Scheduled Activities](/docs/concepts/activities/activities-api-and-webhooks/list-scheduled-activities-api.md)
* [Triggering External Activity Workflows with Webhooks](/docs/concepts/activities/activities-api-and-webhooks/triggering-external-activity-workflows-with-webhooks.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.kizen.com/docs/concepts/activities/activities-api-and-webhooks/retrieve-scheduled-activity-details-by-id-api.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.