List Organizations

Retrieve organizations for the current workspace with optional filters.

Method

GET /v1/organizations

Query Parameters

q · string

Search query (matches name/description).

category · string

Filter by organization category.

modeKey · string

Filter by capability mode key.

Headers

Authorization · string

Bearer token with organizations:read scope.

Request Example

cURL

curl "https://api.voyantcloud.com/v1/organizations?q=travel&category=agency" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

Response

200 OK

{
  "data": [
    {
      "id": "org_123",
      "name": "Voyant Cruises",
      "legalName": "Voyant Cruises SRL",
      "email": "[e-mail]",
      "phone": "[phone]",
      "description": "Cruise specialist partner",
      "taxId": "RO12345678",
      "kind": "agency",
      "billingAddress": null,
      "visitingAddress": null,
      "metadata": null,
      "createdAt": "2025-01-20T10:00:00.000Z",
      "updatedAt": "2025-01-20T10:00:00.000Z"
    }
  ]
}

Workspace context must be present. Workspace-scoped API keys add this automatically.