tiempoAPI reference
v1 · 2026-10-04API keysDashboard
API reference

Locations

A place resources work at, with its own timezone. Locations can be closed with blocks.

Create a location

POST/v1/locations

Send the business’s id in Tiempo-Account.

Body parameters

  • namestringrequired

    Shown in your dashboard; not to customers.

  • timezonestring

    IANA name, for example Europe/London.

  • metadatamap

    Up to 50 keys of your own (strings, keys up to 40 characters, values up to 500). Returned on every read and webhook. On update, an empty string removes a key.

List locations

GET/v1/locations

Send the business’s id in Tiempo-Account.

Query parameters

  • limitinteger

    1 to 100. Defaults to 20.

  • starting_afterstring

    An object id from the previous page; returns the page after it.

  • ending_beforestring

    An object id; returns the page before it.

  • metadata[key]string

    Only objects whose metadata has this key and value. Repeat for several.

Retrieve a location

GET/v1/locations/{id}

Send the business’s id in Tiempo-Account.

Path parameters

  • idstringrequired

    The object’s id.

Update a location

POST/v1/locations/{id}

Send the business’s id in Tiempo-Account.

Path parameters

  • idstringrequired

    The object’s id.

Body parameters

  • namestring

    Shown in your dashboard; not to customers.

  • timezonestring

    IANA name, for example Europe/London.

  • metadatamap

    Up to 50 keys of your own (strings, keys up to 40 characters, values up to 500). Returned on every read and webhook. On update, an empty string removes a key.

Delete a location

DELETE/v1/locations/{id}

Only a location nothing refers to can be deleted; otherwise 409.

Send the business’s id in Tiempo-Account.

Path parameters

  • idstringrequired

    The object’s id.