Schedule
Get the schedule for a range
Returns the consolidated schedule of a window: projects, orders, tasks, internal services and order services.
Request examples
curl 'https://app.filmo.io/api/v1/schedule?startDate=2026-09-01T08%3A00%3A00Z&endDate=2026-09-01T08%3A00%3A00Z' \
--header "Authorization: Bearer $FILMO_API_KEY"Generated from the schema
It does not paginate: it is bounded by dates, which is what a calendar asks for, but each layer is capped and the response does not say when it was cut: at most 200 projects, 200 orders and 500 tasks, ordered by start date, so a layer that returns exactly its cap may be truncated (use a shorter window). Only active records appear: projects in draft, budgeted, confirmed or in_progress, and orders in draft, reserved, prepared_partially, prepared, picked_up_partially, picked_up, returned_partially, returned or checked_in_partially; a checked_in, cancelled or archived order is not returned. It is therefore not a complete snapshot: do not delete a record only because it is missing. Assignees come out by identifier and name; their contact details do not.
Authorizations
Bearer API key with the scope below. schedule:read
Headers
Conditional read: the ETag of the copy you already have. If the resource has not changed, the response is 304 with no body.
Example:"\"3sT3d9pBvZq4h2N0w8x1YkLmQ7c\""
Query parameters
Window start, in ISO 8601 with offset.
Window end, in ISO 8601 with offset.
Which layers to fetch: projects, orders, tasks, internal_services or order_services. By default, everything. Repeat the parameter or separate the values with commas for several.
Available options: projects, orders, tasks, internal_services, order_services
Limits: min 1 items, max 50 items
Filter projects by status.
Limits: min 1 items, max 50 items
Filter orders by status.
Limits: min 1 items, max 50 items
Keep only what is assigned to these staff members.
Limits: min 1 items, max 200 items
Response
Successful response.
Response schema: ScheduleDto
Envelope: ScheduleResponse. meta. is present only when the operation is deprecated.
Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · ETag
Consolidated schedule of a date window.
Show child attributesHide child attributes
Projects that fall within the window.
Show child attributesHide child attributes
Orders that fall within the window.
Show child attributesHide child attributes
Schedule tasks. Without the contact data of whoever they are assigned to.
Show child attributesHide child attributes
Show child attributesHide child attributes
Staff member identifier.
Name shown in the schedule.
Assignments not attached to an order.
Show child attributesHide child attributes
Show child attributesHide child attributes
Staff member identifier.
Name shown in the schedule.
Staff and fleet services attached to an order.
Show child attributesHide child attributes
Show child attributesHide child attributes
Staff member identifier.
Name shown in the schedule.
Additional information about the response.
Show child attributesHide child attributes
Lifecycle warnings; present only when the operation is deprecated.
Show child attributesHide child attributes
Stable warning code.
Available options: deprecated
For people: what is deprecated, until when, and what to use.
Day (YYYY-MM-DD) the operation stops being served.
operationId of the operation to use instead, or null if there is none.
Where the deprecation is documented (the changelog).
Not modified: the If-None-Match sent matches the current ETag. No body; the copy you have is current.
Headers: ETag
No body.
Invalid request (validation_error): malformed query or body. errors[] lists every offending field with its stable code.
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Authentication failed (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin).
Headers: X-Request-Id · Content-Language
Not allowed (insufficient_scope: the API key does not have the required scope, named in requiredScope; forbidden: the owner of the key lacks the permission the operation requires). insufficient_scope is answered before the request counts against the rate limit, so it carries no RateLimit-* headers; forbidden does.
Headers: X-Request-Id · Content-Language
Rate limit exceeded (rate_limited): retry after Retry-After seconds; RateLimit-* says which quota ran out.
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset · Retry-After
Internal error (internal_error).
Headers: X-Request-Id · Content-Language · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset
Errors
| Status | Codes | Meaning |
|---|---|---|
| 400 | validation_error | Malformed query or body. errors[] lists every offending field with its stable code. |
401, 403, 429, 500 can be returned by any operation. Errors
Deprecation
This operation is not deprecated. Deprecations are announced with a Deprecation header and a sunset date. Versioning policy
Related
Related pages
Link to this section: Related pagesOperations
Schedule
Consolidated schedule of a date window.
Was this page helpful?