List businesses
List the businesses (workspaces) you can access.
An API key sees its organization's businesses. A signed-in user sees every business in an org they own or administer, plus only the specific businesses they were added to in an org where they are a guest.
START HERE: every other endpoint takes a required business_id, and this is the tool that returns them — an agent with no business_id in context begins with this call. Returns SUMMARY rows only (id, name, description, industry, website, language, timestamps), newest first. To read a business's full brand profile (tone, palettes, fonts, logo, writing rules), call get_business with the id from this list. Optional name narrows the list by case-insensitive substring match. If next is set, keep paging with it before concluding a business doesn't exist.
Errors: 401 authentication_required: API key or token is missing, invalid, or revoked. 403 permission_denied: Your plan does not include API access. 429 rate_limit_exceeded: You sent too many requests this minute.
Request
- Base URL: https://api.mymarky.ai
- URL: https://api.mymarky.ai/api/businesses
- Auth: HTTP bearer
Query parameters
Max results per page (1-100)
The next value from the previous page's response, passed back verbatim. Leave it out for the first page. When next is null you have every result.
Filter by name, case-insensitive substring (e.g. "bakery" matches "Eli's Bakery").
Headers
Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.
Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.