Tags

List tags

Returns the tag vocabulary of the account with how many entities use each one.

GET
/api/v1/tags

Request examples

curl https://app.filmo.io/api/v1/tags \
  --header "Authorization: Bearer $FILMO_API_KEY"
{
  "data": [
    {
      "id": "tag_9f3a2b",
      "name": "Example tag",
      "count": 1,
      "createdAt": "2026-09-01T08:00:00.000Z",
      "updatedAt": "2026-09-01T08:00:00.000Z"
    }
  ]
}

Generated from the schema

Resolve the real names before filtering by them.

Authorizations

Bearer API key with the scope below. tags:read

Response

application/json

Successful response.

Response schema: TagDto

Envelope: TagItems. 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 identifier of the tag.

data.namestring

Tag name.

data.countinteger

Number of entities the tag is assigned to.

data.createdAtstring<date-time>

Creation date in ISO 8601 UTC.

data.updatedAtstring<date-time>

Last modification date in ISO 8601 UTC.

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

  • Platform

    Tag

    Tag of the account, with how many entities use it.