1. Org
Cognita
  • Introduction
  • Auth
    • register
      POST
    • login
      POST
    • callback
      GET
    • profile
      GET
    • verify email
      POST
    • refresh
      POST
    • logout
      POST
    • forgot password
      POST
    • reset password
      POST
    • request reset password
      POST
    • update-profile
      PATCH
  • Meetings
    • Transcripts
      • Retrieve transcripts for a meeting
    • upload init
    • Get meeting details
  • Transcription
    • live
    • Get Transcript segments
    • Create translation for transcript
  • Organization
    • Billing
      • Get Billing Details
      • Update Plan
    • Org
      • Create Organization
        POST
      • Get Organization
        GET
      • Get Organizations
        GET
      • update organization
        PUT
      • update settings
        PATCH
      • Delete Organization
        DELETE
      • get organization settings
        GET
      • Suspend
        POST
      • Resume
        POST
    • Retention
      • Set Retention Policy
      • Get Retention Policy
      • Update Retention Policy
    • Domains
      • Allowed Domains
      • Allowed Domains
      • Domain verfying
  • Workspaces
    • Org
      • Get Organization Workspaces
    • Workspace
      • Create Workspace
      • Get Workspace
      • Update Workspace
      • Delete Workspace
    • Users
      • Get Workspace Members
      • Delete Member from Workspace
    • Meetings
      • Start a meeting in workspace
  • configurations
    • feature-flags
    • configs
    • tenant-defaults
  • Schemas
    • Organization
      • OrganizationSettings
      • FeatureFlags
      • RetentionPolicy
      • Organization
      • CreateOrgRequestBody
    • Billing & Subscriptions
      • BillingAccount
      • SubscriptionEntitlements
      • SubscriptionPlan
      • Subscription
      • PaymentMethod
      • Invoice
      • UsageRecords
      • Bill
    • Roles & permissions
      • Permissions
    • Workspace
      • Workspaces
    • Meeting & Recordings
      • Meetings
    • Trascriptions & Summaries
    • Integrations
    • Notifications & Audit logs
    • AI Services
    • Localization
    • Auth & Users
      • user
      • AccessToken
    • ErrorResponse
    • SuccessResponse
    • DeviceInfo
    • Session
  1. Org

Get Organizations

Developing
Develop Env
http://localhost:3000/api
Develop Env
http://localhost:3000/api
GET
http://localhost:3000/api
orgs/
organization
Maintainer:Abdelrhman Moataz
##Purpose
List organizations for system admins or billing dashboards.

Auth / Scope#

system:admin or billing:read depending on filters

Notes#

Returns summary fields by default (id, name, orgType, billingPlan); use include=full to fetch all fields.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Query Params

Responses

🟢200Success
application/json
Body

🟠400Bad Request
🟠409Bad Request
🟠403Forbidden
🔴500Server Error
🟠429Too Many Requests
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:3000/apiorgs/?limit&page&q&type&include' \
--header 'Authorization: Bearer <token>'
Response Response Example
200 - Success
{
  "message": "Organizations fetched successfully",
  "data": [
    {
      "orgId": "a1b2c3d4-5678-90ef-1234-567890abcdef",
      "name": "Cognita Education Group",
      "orgType": "education",
      "billingAccountId": "cus_87654321xyz",
      "createdAt": "2023-05-15T08:30:00Z",
      "updatedAt": "2024-06-10T14:22:30Z",
      "retentionPolicy": {
        "transcripts": "730d",
        "recordings": "365d",
        "chatLogs": "365d",
        "userData": "1825d",
        "examData": "3650d"
      },
      "settings": {
        "timezone": "America/Los_Angeles",
        "defaultLanguage": "en-US",
        "complianceMode": "ferpa",
        "recordingConsent": "required",
        "aiSummaries": "enhanced",
        "educationMode": true,
        "dlpEnabled": true,
        "translationEnabled": true,
        "realTimeSummaries": true,
        "lmsIntegration": "canvas",
        "retentionAlerts": true
      },
      "billingPlan": "enterprise_edu",
      "isSuspended": false,
      "suspensionReason": null,
      "suspensionDate": null,
      "trialEndDate": "2024-08-15T00:00:00Z",
      "allowedDomains": [
        "cognita.edu",
        "school-district.k12"
      ],
      "featureFlags": {
        "realTimeTranslation": true,
        "roleAwareSummaries": true,
        "examGeneration": true,
        "meetingEnergyDashboard": false
      }
    }
  ]
}
Modified at 2025-10-16 11:46:25
Previous
Get Organization
Next
update organization
Built with