Staff

Get a staff member

Returns a staff member by its identifier.

GET
/api/v1/staff/{staffId}

Request examples

curl https://app.filmo.io/api/v1/staff/staf_8f2a1c \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": {
    "id": "staff_member_9f3a2b",
    "fullName": "Example full name",
    "staffType": "employee",
    "collectionId": "collection_9f3a2b",
    "collectionName": "Example collection name",
    "hasDrivingLicense": true,
    "showInPlanner": true,
    "externalRef": "Example external ref",
    "createdAt": "2026-09-01T08:00:00.000Z",
    "updatedAt": "2026-09-01T08:00:00.000Z"
  }
}

Generated from the schema

The projection is the same as the listing, and that is deliberate: the internal record carries personal and employment data —emergency contact, contract type and hours, internal and external cost, platform role— that is not published to an integrator. This operation exists to resolve an identifier without paginating the whole listing, not to widen what is seen of a person.

Authorizations

Bearer API key with the scope below. staff:read

Headers

If-None-Matchstring

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\""

Path parameters

staffIdstringRequired

Staff member identifier.

Limits: min length 1

Response

application/json

Successful response.

Response schema: StaffMemberDto

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

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

dataobject

Staff member, with the minimum projection needed for planning. Does NOT include contact, identity, employment or platform access data: see the resource documentation.

Show child attributes
data.idstring

Unique staff member identifier.

data.fullNamestring

Full name.

data.staffTypestring

Staff member type.

Available options: employee, freelancer, contractor

data.collectionIdstring | null

Identifier of the collection it belongs to; null if it is in none.

data.collectionNamestring | null

Collection path it belongs to; null if not applicable.

data.hasDrivingLicenseboolean

true if they hold a driving licence.

data.showInPlannerboolean

true if they appear in the planner of the account.

data.externalRefstring | null

External reference for matching with third-party systems; null if it has none.

data.createdAtstring<date-time> | null

Creation date in ISO 8601 UTC; null if not recorded.

data.updatedAtstring<date-time> | null

Last modification date in ISO 8601 UTC; null if not recorded.

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
404not_foundIt does not exist or is outside the scope of the API key.

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

  • Operations

    Staff member

    Staff member, with the minimum projection needed for planning.