Skip to main content
TypeScript

Authorizations

Authorization
string
header
required

Your Periskope API token, sent as Authorization: Bearer <token>. Generate one from the Periskope dashboard under Settings → API & Webhooks. API access requires an active Pro or Enterprise plan.

Headers

x-phone
string

Optional. Scope results to a single phone: country code + number without symbols or spaces (e.g. 911111111111), or a phone_id (phone-xxxxxxxxxxxx). Omit to return data across all phones the API token can access.

Example:

"919876543210"

Query Parameters

offset
integer | null

Number of records to skip before the first returned record. Use together with limit to paginate: page N is offset = N * limit. Defaults to 0.

Required range: x >= 0
Example:

0

limit
integer

Maximum number of records to return in one page. Defaults to 1000.

Required range: x >= 1
Example:

1000

start_time
string

Only messages whose next run is at or after this time (ISO 8601).

Example:

"2026-01-01T00:00:00Z"

end_time
string

Only messages whose next run is at or before this time (ISO 8601).

Example:

"2026-01-31T23:59:00Z"

q
string

Case-insensitive substring search on the message text of the scheduled content.

Example:

"reminder"

chat_id
string

One or more chat_ids, comma-separated.

Example:

"120363000000000000@g.us"

performed_by
string

One or more creators, comma-separated — member emails or "api".

Example:

"user@example.com"

status
string

One or more statuses, comma-separated: 'scheduled', 'paused', 'completed'.

Example:

"scheduled,paused"

is_repeat
enum<string>

Return only repeating (true) or only one-time (false) messages.

Available options:
true,
false
Example:

"true"

sort_by
enum<string>

Field to sort by: 'scheduled_at' (default) or 'created_at'.

Available options:
scheduled_at,
created_at
Example:

"scheduled_at"

sort_order
enum<string>

Sort direction: 'asc' or 'desc' (default).

Available options:
asc,
desc
Example:

"desc"

Response

Paginated list of scheduled messages

from
integer

1-based index of the first record in this page (offset + 1).

Example:

1

to
integer

1-based index of the last record in this page.

Example:

20

count
integer

Number of records in this page — the length of the scheduled_messages array, not the total across all pages.

Example:

20

scheduled_messages
object[]

The scheduled_messages in this page.