Retrieve a Time Blocker

GET

/businesses/{businessId}/time-blockers/{timeBlockerId}

• production

Retrieve a Time Blocker

Authorizations

• apiKey

Responses

200

A Time Blocker

Media typeapplication/json

object

data

object

id

Unique identifier across the platform.

string format: uuid

createdAt

Time when the resource was created (ISO 8601 format).

string format: date-time

updatedAt

Time when the resource was last updated (ISO 8601 format).

string format: date-time

staffId

The ID of the Staff this resource belongs to.

string format: uuid

startDate

Start date and time of the time blocker (ISO 8601 format).

string format: date-time

endDate

End date and time of the time blocker (ISO 8601 format).

string format: date-time

reason

Reason for the time blocker.

string

nullable

Example ^generated

{
  "data": {
    "staffId": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "startDate": "2026-04-15T12:00:00Z",
    "endDate": "2026-04-15T12:00:00Z",
    "reason": "example"
  }
}

400

The time blocker ID is malformed.

Media typeapplication/json

object

error

object

code

number

type

The specific error that occurred.

string

Allowed values: BadRequestError

title

Human-readable description of the error.

string

Example

{
  "error": {
    "code": 400,
    "type": "BadRequestError",
    "title": "Invalid platformId format."
  }
}

403

The API key is missing or invalid, or the Business cannot be accessed with it.

Media typeapplication/json

object

error

object

code

number

type

The specific error that occurred.

string

Allowed values: UnauthorizedError BusinessArchivedError BusinessDisabledError

title

Human-readable description of the error.

string

Example

{
  "error": {
    "code": 403,
    "type": "UnauthorizedError",
    "title": "Invalid API token"
  }
}

404

The time blocker does not exist.

Media typeapplication/json

object

error

object

code

number

type

The specific error that occurred.

string

Allowed values: NotFoundError BusinessNotFoundError

title

Human-readable description of the error.

string

Example

{
  "error": {
    "code": 404,
    "type": "NotFoundError",
    "title": "Resource not found"
  }
}