List All 1:1 Coaching Periods — Shilo Coaching API

Use this endpoint to retrieve the list of coaching periods generated for your Shilo integration. Each period represents a discrete time window during which call data is collected for agent coaching agendas. You can use this endpoint to discover active and past periods, check whether the review window is still open, and determine whether the team digest has been generated yet.

Endpoint

GET https://api.shilo.ai/api/v1/coaching/periods

Authentication

Include your API key in the request header:

x-api-key: YOUR_API_KEY

Query Parameters

number

default:"50"

Maximum number of results to return per page. Maximum value is 100.

string

Pagination cursor from a previous response’s pagination.next_cursor. Omit to start from the beginning.

string

default:"desc"

Sort order by created date. Accepted values: asc, desc. Defaults to desc so the most recent period appears first.

string

Filter results to a specific coaching cadence. Accepted values: monthly, semimonthly, weekly. Omit to return periods of all cadences.

Response

200 — Success

Returns a CoachingPeriodsResponseDto containing a data array of coaching period objects and a pagination block.

array

Array of coaching period objects.

Show CoachingPeriod object

string

Unique identifier for the coaching period (UUID).

string

The cadence for this period: weekly, semimonthly, or monthly.

string

Calendar date on which call data collection for this period begins (inclusive). Format: YYYY-MM-DD.

string

Calendar date on which call data collection for this period ends (inclusive). Format: YYYY-MM-DD.

string

Inclusive UTC calendar-date deadline for agents to complete their coaching agendas. Format: YYYY-MM-DD.

string

Whether the review window is currently open. open through the end of review_period_end in UTC; closed thereafter.

string

Processing status of the team-level digest for this period. pending while the digest is being generated; completed when the digest is available on the period detail.

string

ISO-8601 timestamp of when the period record was created.

string

ISO-8601 timestamp of the most recent update to this period record.

object

Pagination metadata.

Show pagination object

boolean

Whether additional pages of results exist.

string | null

Cursor to pass as the cursor query parameter for the next page. null when has_more is false.

400 — Bad Request

One or more query parameters contain invalid values.

401 — Unauthorized

Your API key is missing or invalid.

Example Request

curl --request GET \
  --url "https://api.shilo.ai/api/v1/coaching/periods?limit=10&sort=desc&cadence=weekly" \
  --header "x-api-key: YOUR_API_KEY"

Example Response

{
  "data": [
    {
      "id": "ee6f2136-b94a-4438-9335-3acf5b2a0d31",
      "cadence": "weekly",
      "period_start": "2026-06-01",
      "period_end": "2026-06-07",
      "review_period_end": "2026-06-14",
      "review_status": "open",
      "digest_status": "pending",
      "created_date": "2026-06-08T12:34:56Z",
      "updated_date": "2026-06-08T12:34:56Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  }
}

review_status is open through the end of review_period_end in UTC, and transitions to closed after that deadline passes. Use this field to determine whether agents can still submit their agendas for the period.

Overview

Calls

Appointments

Roleplays

Contacts

Users

Invitations

Metrics

Coaching

List All 1:1 Coaching Periods — Shilo Coaching API

Endpoint

Authentication

Query Parameters

Response

200 — Success

400 — Bad Request

401 — Unauthorized

Example Request

Example Response

​Endpoint

​Authentication

​Query Parameters

​Response

​200 — Success

​400 — Bad Request

​401 — Unauthorized

​Example Request

​Example Response

Endpoint

Authentication

Query Parameters

Response

200 — Success

400 — Bad Request

401 — Unauthorized

Example Request

Example Response