Skip to main content
GET
/
v1
/
schedule
/
{scheduleId}
curl -X GET "https://api.hooked.so/v1/schedule/post_abc123xyz" \
  -H "x-api-key: your_api_key_here"

{
  "success": true,
  "data": {
    "id": "post_abc123xyz",
    "status": "pending",
    "scheduledDateTime": "2024-03-15T14:00:00.000Z",
    "platform": "youtube",
    "integration": {
      "id": "int_yt_def456",
      "type": "youtube",
      "account": {
        "id": "UC1234567890",
        "name": "My YouTube Channel",
        "username": "mychannel",
        "avatarUrl": "https://yt3.ggpht.com/..."
      }
    },
    "video": {
      "id": "vid_ghi789",
      "name": "10 Tips for Productivity",
      "url": "https://cdn.hooked.so/signed/...",
      "thumbnail": "https://cdn.hooked.so/signed/...",
      "durationInSeconds": 45
    },
    "platformData": {
      "title": "10 Tips for Productivity",
      "description": "Learn how to boost your productivity...",
      "tags": ["productivity", "tips", "workflow"],
      "privacyStatus": "public",
      "madeForKids": false
    },
    "createdAt": "2024-03-10T10:00:00.000Z",
    "updatedAt": "2024-03-10T10:00:00.000Z"
  }
}
Try it out! Use the API playground on the right to test the Get Schedule Details endpoint directly.

​
Overview

Get complete details about a specific scheduled post, including video information, platform data, and publishing status. This endpoint is useful for:
  • Checking the status of a scheduled post
  • Retrieving platform-specific metadata
  • Getting the video URL and thumbnail for preview

​
Endpoint

GET /v1/schedule/{scheduleId}

​
Path Parameters

​
scheduleId
string
required
The unique ID of the scheduled post to retrieve

​
Headers

​
x-api-key
string
required
Your API key from API Settings

​
Response

​
success
boolean
Whether the request was successful
​
data
object

​
Request Example

curl -X GET "https://api.hooked.so/v1/schedule/post_abc123xyz" \
  -H "x-api-key: your_api_key_here"

​
Response Examples

{
  "success": true,
  "data": {
    "id": "post_abc123xyz",
    "status": "pending",
    "scheduledDateTime": "2024-03-15T14:00:00.000Z",
    "platform": "youtube",
    "integration": {
      "id": "int_yt_def456",
      "type": "youtube",
      "account": {
        "id": "UC1234567890",
        "name": "My YouTube Channel",
        "username": "mychannel",
        "avatarUrl": "https://yt3.ggpht.com/..."
      }
    },
    "video": {
      "id": "vid_ghi789",
      "name": "10 Tips for Productivity",
      "url": "https://cdn.hooked.so/signed/...",
      "thumbnail": "https://cdn.hooked.so/signed/...",
      "durationInSeconds": 45
    },
    "platformData": {
      "title": "10 Tips for Productivity",
      "description": "Learn how to boost your productivity...",
      "tags": ["productivity", "tips", "workflow"],
      "privacyStatus": "public",
      "madeForKids": false
    },
    "createdAt": "2024-03-10T10:00:00.000Z",
    "updatedAt": "2024-03-10T10:00:00.000Z"
  }
}

​
Status Values

StatusDescription
pendingWaiting to be published at the scheduled time
publishedSuccessfully published. Check platformData.publishedUrl for the live link
failedPublishing failed. Check platformData.error for details
draftSaved but not scheduled

​
Next Steps

Update Schedule

Change the scheduled time or metadata

Cancel Schedule

Cancel a pending scheduled post

List All

View all scheduled posts

Webhooks

Get notified on status changes

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
scheduleId
string
required

Schedule ID

Response

200

Success