businesses

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.

get/api/businesses

Request

  • Base URL: https://api.mymarky.ai
  • URL: https://api.mymarky.ai/api/businesses
  • Auth: HTTP bearer

Query parameters

limitinteger

Max results per page (1-100)

cursorstring nullable

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.

namestring nullable

Filter by name, case-insensitive substring (e.g. "bakery" matches "Eli's Bakery").

Headers

Marky-Version'2026-04-08' | '2026-07-17' | '2026-08-02' | '2026-08-04' | '2026-08-06'
Example:2026-08-06

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

nextstring nullable

Opaque cursor for the next page; null when there are no more. Pass it back verbatim as ?cursor=. Do not construct or decode it.

Changes

No recorded changes to this operation across all 1 revision of this API.