Get Organization

Retrieve a single organization by ID including members, domains, feature flags, and security policies.

Endpoint

GET /v1/organizations/{id}

Base URL: https://api-id.avnology.net

Authentication: API Key or OAuth token with admin:orgs:read scope

Request

curl "https://api-id.avnology.net/v1/organizations/org_7a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer ak_live_..."

Response

Success (200 OK)

{
  "id": "org_7a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
  "name": "acme-corp",
  "display_name": "Acme Corporation",
  "slug": "acme",
  "logo_url": "https://cdn.id.avnology.net/logos/org_7a2b3c4d.png",
  "registration_mode": "invite_only",
  "member_count": 142,
  "domains": [
    {

Errors

Status	Code	Description
404	`AVNOLOGY_AUTH_300`	Organization not found

Code Examples

JavaScript (fetch)

async function getOrganization(apiKey, orgId) {
  const response = await fetch(`https://api-id.avnology.net/v1/organizations/${orgId}`, {
    headers: { 'Authorization': `Bearer ${apiKey}` },
  });
  return response.json

Python (httpx)

import httpx

def get_organization(api_key: str, org_id: str) -> dict:
    return httpx.get(f"https://api-id.avnology.net/v1/organizations/{org_id}",
        headers

Go (net/http)

func getOrganization(ctx context.Context, apiKey, orgID string) (*Organization, error) {
	url := fmt.

List Organizations -- list all organizations
Update Organization -- modify organization settings
List Members -- list org members
SDK: client.admin.getOrganization(orgId) (TypeScript)

On this page