List Time Blocks
Lists same-organization Time Blocks — a Team Member's unavailability such as PTO, sick time, or training — ordered by start. Filter by teamMemberId, or by endsAfter to get blocks that have not ended yet. Required scope: time_blocks:read.
Lists same-organization Time Blocks — a Team Member's unavailability such as PTO, sick time, or training — ordered by start. Filter by teamMemberId, or by endsAfter to get blocks that have not ended yet. Required scope: time_blocks:read.
List Time Blocks. Use an organization API key with time_blocks:read. Check the response envelope and meta.requestId before triggering dependent workflow steps.
Required scopes
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| teamMemberId | query | string | Only Time Blocks for this Team Member. |
| endsAfter | query | string | Only Time Blocks that end after this ISO 8601 date-time. |
| limit | query | integer | Maximum records to return. Defaults to 50 and is capped at 100. |
| cursor | query | string | Opaque record cursor from the previous response meta.nextCursor value. |
Request body
This endpoint does not accept a JSON request body.
Responses
Time Block list envelope
#/components/schemas/TimeBlockListEnvelope
endsAfter is not a date-time
#/components/schemas/OrgApiError
Missing or invalid organization API key
#/components/schemas/OrgApiError
Organization billing access or an endpoint-specific business quota denied the request
#/components/schemas/OrgApiError
Missing required scope: time_blocks:read
#/components/schemas/OrgApiError
Rate limit exceeded
#/components/schemas/OrgApiError
Errors
Static examples
curl -X GET "$SOLAROS_BASE_URL/api/v1/time-blocks" \ -H "Authorization: Bearer $SOLAROS_API_KEY"