Internal services

List internal services

Returns the plannable assignments not attached to an order, cursor-paginated.

GET
/api/v1/internal-services

Request examples

curl https://app.filmo.io/api/v1/internal-services \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": [
    {
      "id": "internal_service_9f3a2b",
      "title": "Example title",
      "status": "Example status",
      "startDate": "2026-09-01T08:00:00.000Z",
      "endDate": "2026-09-01T08:00:00.000Z",
      "projectId": "project_9f3a2b",
      "createdAt": "2026-09-01T08:00:00.000Z",
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJvIjoyMH0",
    "hasMore": true,
    "total": 1
  }
}

Generated from the schema

Filter by status, type, project and an overlap window (overlapsFrom/overlapsTo: assignments whose period overlaps it). Sorted by start date. Creation and update date filters and filtering by assigned resource are not available on this listing.

Authorizations

Bearer API key with the scope below. internal-services:read

Query parameters

limitintegerdefault:50

Page size (1-500). Defaults to 50.

Limits: min 1, max 500

cursorstring

Opaque cursor of the page to return. Pass the value of pagination.nextCursor from the previous response; treat it as opaque.

Limits: max length 200

sortstring

Sort order: up to 3 comma-separated fields, each with a leading "-" for descending (e.g. "-updatedAt,name"). Sortable fields: startDate, endDate, title, status, createdAt, updatedAt. Defaults to "startDate". Ties are broken by id, so the order is stable across pages, and a cursor is bound to the sort it was issued with.

Limits: max length 200

statusstring

Filter by status: active, completed or cancelled.

Available options: active, completed, cancelled

serviceTypestring

Filter by type: crew (personnel), fleet (vehicles) or general.

Available options: crew, fleet, general

projectIdstring

Filter by associated project.

Limits: min length 1, max length 100

overlapsFromstring

Start of the overlap window: returns assignments whose period overlaps [overlapsFrom, overlapsTo]. A bare day (YYYY-MM-DD, read in the business timezone) or an ISO 8601 instant with offset.

Limits: pattern ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}(:?\d{2})?))?$

overlapsTostring

End of the overlap window: returns assignments whose period overlaps [overlapsFrom, overlapsTo]. A bare day (YYYY-MM-DD, read in the business timezone) or an ISO 8601 instant with offset.

Limits: pattern ^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}(:?\d{2})?))?$

includeTotalbooleandefault:false

Set it to true to include pagination.total, the number of results that match the filters across all pages. Off by default.

Response

application/json

Successful response.

Response schema: InternalServiceDto

Envelope: InternalServiceList. meta.warnings is present only when the operation is deprecated.

Headers: X-Request-Id · RateLimit-Limit · RateLimit-Remaining · RateLimit-Reset

dataobject[]

Show child attributes
data.idstring

Unique assignment identifier.

data.titlestring

Assignment title.

data.statusstring

Status: active, completed or cancelled.

data.startDatestring<date-time>

Start in ISO 8601 UTC.

data.endDatestring<date-time>

End in ISO 8601 UTC.

data.projectIdstring | null

Associated project; null if not applicable.

data.createdAtstring<date-time>

Creation date in ISO 8601 UTC.

data.updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

paginationobject

Opaque-cursor pagination metadata.

Show child attributes
pagination.nextCursorstring | null

Opaque cursor of the next page; null when there are no more results. Pass it as cursor in the next request.

pagination.hasMoreboolean

Whether more results exist beyond this page.

pagination.totalinteger

Number of results matching the filters across all pages. Present only when the request sets includeTotal=true.

Limits: min 0

metaobject

Additional information about the response.

Show child attributes
meta.warningsobject[]

Lifecycle warnings; present only when the operation is deprecated.

Show child attributes
meta.warnings.codestring

Stable warning code.

Available options: deprecated

meta.warnings.messagestring

For people: what is deprecated, until when, and what to use.

meta.warnings.sunsetstring

Day (YYYY-MM-DD) the operation stops being served.

meta.warnings.replacementstring | null

operationId of the operation to use instead, or null if there is none.

Errors

StatusCodesMeaning
400validation_errorMalformed 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