List Sub-Orgs

{
  "query": {
    "limit": 20,
    "name": "%PrimeVault%"
  }
}

# Sample only. Generate a new signed token for each request
# (see Authentication). Tokens expire after 120 seconds.
curl --request GET \
  --url "https://api.primevault.com/api/external/sub_orgs/?limit=20&name=%25PrimeVault%25" \
  --header "Authorization: Bearer <signed JWT>" \
  --header "Api-Key: <API key>" \
  --header "Accept: application/json"

getSubOrgs(
  params?: Record<string, string>,
  limit?: number,
  cursor?: string | null,
): Promise<SubOrgListResponse>

import type { SubOrg } from "@primevault/js-api-sdk";

const subOrgs: SubOrg[] = [];
let cursor: string | null = null;

do {
  const page = await apiClient.getSubOrgs(
    { name: "%PrimeVault%" },
    20,
    cursor,
  );
  subOrgs.push(...page.results);
  cursor = page.nextCursor;
} while (cursor);

from typing import List, Optional
from primevault_python_sdk.types import SubOrg

sub_orgs: List[SubOrg] = []
cursor: Optional[str] = None

while True:
    page = api_client.get_sub_orgs(
        {"name": "%PrimeVault%"}, limit=20, cursor=cursor
    )
    sub_orgs.extend(page.results)
    if not page.hasNext:
        break
    cursor = page.nextCursor

{
  "results": [
    {
      "id": "a648fa0d-4ca9-4f4f-a520-7ef5e9db34eb",
      "orgId": "a30d5e99-7076-45da-a933-0d5642619340",
      "name": "PrimeVault customer",
      "controlMode": "MANAGED",
      "createdAt": "2026-09-14T12:00:00Z",
      "updatedAt": "2026-09-14T12:00:00Z",
      "isDeleted": false,
      "version": 1
    }
  ],
  "nextCursor": null,
  "hasNext": false
}

interface SubOrgListResponse {
  results: SubOrg[];
  nextCursor?: string | null;
  hasNext?: boolean;
}