events/get-venue reads a single venue: name, status, the full address broken into its fields, phone and website.
Use it when you have an ID — from an event, or from events/list-venues — and need the whole record.
At a glance
| Ability | events/get-venue |
| Toolset | The Events Calendar — toolset/events-calendar |
| Group | The Events Calendar › Venues |
| Requires | The Events Calendar, active on the site |
| Capability | manage_options |
| Safety | Read-only — changes nothing |
| Repeatable | Idempotent — running it twice leaves the same result |
| Ships in | AcrossAI Abilities Manager 0.0.34 and later |
How it works
The address is stored as separate fields rather than one block of text, which is what lets the calendar build map links and structured data from it. They come back the same way, so a caller can use the city on its own without parsing anything.
Every field is optional. A venue that exists as a name with no address at all is valid, and reads back with empty strings rather than an error — worth knowing before you build anything that assumes a postcode is there.
The status is included because venues follow post status like everything else. A draft venue attached to a published event is a real situation, and it shows up as an event page with a venue section that is mysteriously blank to logged-out visitors.
Input
| Name | Type | Required | What it is |
|---|---|---|---|
id | integer | Yes | The venue ID. |
What comes back
| Name | Type | What it is |
|---|---|---|
venue | object | ID, name, status, address, city, state, postcode, country, phone and website. |
success | boolean | Whether the call completed. |
message | string | A one-line summary of what happened, suitable for showing a human. |
error_code | string | Present only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation. |
Example
Ask your assistant:
What is the full address for venue 204?
It resolves to one call:
{
"ability": "events/get-venue",
"parameters": {
"id": 204
}
}Worth knowing
- Refused if the ID is not a venue. An event ID passed here is an error, not an empty result.
- Check the status when a venue looks blank on the front end.
Related abilities
- Update Venue — correct the details
- List Events — everything happening here
- List Venues — find the ID
Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager
Browse the rest: Every ability, by category