List off periods is a WordPress ability from LatePoint — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List off periods
Read-onlyList off/blocked periods for agents, optionally filtered by agent and date range.
Requires the LatePoint plugin on WordPress 6.9+ (the WordPress Abilities API is only available from 6.9 onward). All abilities also require the site's 'latepoint_abilities_api' master toggle to be enabled; write abilities additionally require the 'latepoint_abilities_api_edit' setting, and destructive abilities additionally require the 'latepoint_abilities_api_delete' setting. Each ability further requires the current user to hold the matching LatePoint capability (e.g. 'booking__view', 'customer__edit'), and some abilities also verify the user is allowed to act on that specific record.
What it does
This ability returns LatePoint's off periods — the blocks of time during which an agent (or the business) is unavailable for bookings. You can narrow results to a single agent_id, and/or restrict them to periods that fall within (or overlap) a date_from/date_to window; any combination of filters, or none, is accepted. Matching periods are returned ordered by start date, each with its id, name, start_date, end_date, and agent_id, so you can quickly see what's blocked and when.
See it in action
You ask your AI assistant
"Show me all off periods scheduled for agent 8 between 2026-07-01 and 2026-07-31."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| agent_id | integer | No | Filter by agent ID. |
| date_from | string | No | Start date filter (Y-m-d). |
| date_to | string | No | End date filter (Y-m-d). |
Returns
An object with 'off_periods', an array of matching off periods (id, name, start_date, end_date, agent_id) ordered by start date.
Permission
The current user must have LatePoint's 'agent__view' capability, and the site's 'latepoint_abilities_api' Abilities API setting must be enabled.
More LatePoint abilities
Add off period
Create a new off/blocked period so an agent, or the whole business, stops accepting bookings for a date range.
Approve booking
Approve a pending booking in one step.
Cancel booking
Cancel a booking while keeping its record intact.
Change booking status
Set a booking to any valid status — approved, pending, cancelled, no_show, or completed.
Change invoice status
Update the payment status of an existing invoice, such as marking it paid or partially paid.
Change order status
Change the status of an order to open, cancelled, or completed.