Models

TagRead

object

typestringrequired

Immutable value

Example

tags

idstringrequired

Example

attributesTagModelrequired

Show child attributes

created_atstring<date-time>read only

Example

2026-10-01T00:00:00+00:00

updated_atstring<date-time>read only

Example

2026-10-01T00:00:00+00:00

tagstringrequired

The tag

Example

expensive

datestring<date> | null

The date to which the tag is applicable.

Example

2026-10-01

descriptionstring | null

Example

Tag for expensive stuff

latitudenumber<double> | null

Latitude of the tag's location, if applicable. Can be used to draw a map.

Example

51.983333

longitudenumber<double> | null

Latitude of the tag's location, if applicable. Can be used to draw a map.

Example

5.916667

zoom_levelinteger<int32> | null

Zoom level for the map, if drawn. This to set the box right. Unfortunately this is a proprietary value because each map provider has different zoom levels.

Example

linksObjectLinkrequired

Show child attributes

0object

Show child attributes

relstring

Example

self

uristring

Example

/OBJECTS/1

selfstring<uri>

Example

https://demo.firefly-iii.org/api/v1/OBJECTS/1

Example

{
  "type": "tags",
  "id": "2",
  "attributes": {
    "created_at": "2026-10-01T00:00:00+00:00",
    "updated_at": "2026-10-01T00:00:00+00:00",
    "tag": "expensive",
    "date": "2026-10-01",
    "description": "Tag for expensive stuff",
    "latitude": 51.983333,
    "longitude": 5.916667,
    "zoom_level": 6
  },
  "links": {
    "0": {
      "rel": "self",
      "uri": "/OBJECTS/1"
    },
    "self": "https://demo.firefly-iii.org/api/v1/OBJECTS/1"
  }
}