Skip to navigation
API ReferenceListings

Block dates (create unavailability)

View as Markdown

Scope: bookings:write

Blocks a listing for a time range — maintenance, shop time, a booking taken elsewhere.

Body

  • trip_start (string, required) — local start time
  • trip_end (string, required) — local end time, on or after trip_start
  • source (object, required) — where to apply the block. direct: true blocks it in Fleetwire; turo / getaround / outdoorsy: true also push the block to that connected marketplace listing. Unknown keys are rejected.
  • notes (string, optional, max 255)

The response reports, per channel, whether the block was attempted and succeeded.

Authentication

AuthorizationBearer

An API token from Settings → API tokens in Fleetwire, sent as Authorization: Bearer …. Each token carries scopes: read for every GET, plus write scopes such as bookings:write.

Path parameters

l_idstringRequired
Listing ID

Request

This endpoint expects an object.
trip_startstringRequired
Start of the block, before 2038.
trip_endstringRequired

End of the block, on or after trip_start, before 2038.

sourceobjectRequired

Where to block the dates: Fleetwire (direct) and any connected platforms.

supplementalboolean or nullOptional
notesstring or nullOptional<=255 characters

Response

OK
listingobjectOptional
bookingslist of objectsOptional
sourcesBlockedobjectOptional

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
422
Unprocessable Entity Error
429
Too Many Requests Error