Skip to main content

​
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 "https://api.voyantcloud.com/v1/organizations?q=travel&category=agency" \
  -H "Authorization: Bearer $VOYANT_API_KEY"

​
Response

{
  "data": [
    {
      "id": "org_123",
      "name": "Voyant Cruises",
      "legalName": "Voyant Cruises SRL",
      "email": "contact@voyantcruises.com",
      "phone": "+40 700 000 001",
      "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.