> ## Documentation Index > Fetch the complete documentation index at: https://avala.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Organizations > Use this endpoint to list organizations in the Avala API using GET on /organizations/. ## OpenAPI ````yaml GET /organizations/ openapi: 3.0.0 info: title: Avala API description: > # Authentication ## Generating an API Key The Avala SDK uses API keys to authenticate requests. You can create and manage your API keys from the Settings page of Mission Control. Follow these steps to generate a new API key: 1. Open your settings page by clicking on your user avatar located at the top right-hand corner of any Mission Control screen, and select `Settings`. 2. From the left-hand sub-menu, select `Security & Identity`. 3. Click on `New API Key`, enter a name for the key, and then click `Create key`. The new key will be automatically copied to your clipboard. Please note, for security reasons, the key will not be accessible once you close the window. Ensure you store it in a safe location before closing the pop-up modal. ### Video walkthrough of API key generation ## Authenticating with an API Key This is the easiest part! Just add a header named `X-Avala-Api-Key` to your requests and set the previously generated API Key as the value. termsOfService: https://avala.ai/legal/terms contact: email: support@avala.ai version: v1 servers: - url: https://api.avala.ai/api/v1 security: - API_Key: [] - JWT: [] tags: - name: datasets description: To be completed... - name: projects description: To be completed... - name: tasks description: List and retrieve annotation tasks. - name: exports description: To be completed... paths: /organizations/: parameters: [] get: tags: - organizations description: ViewSet for organization CRUD operations. operationId: organizations_list parameters: - name: ordering in: query description: Which field to use when ordering the results. required: false schema: type: string - name: page in: query description: A page number within the paginated result set. required: false schema: type: integer - name: limit in: query description: Number of results to return per page. required: false schema: type: integer - name: order in: query description: >- Sets the CursorPagination `offset` when `cursor` is also set. e.g. `cursor=...&offset=1` schema: type: string - name: reverse in: query description: >- Sets the CursorPagination `reverse` when `cursor` is also set. e.g. `cursor=...&reverse=1`. schema: type: integer responses: '200': description: '' content: application/json: schema: required: - count - results type: object properties: count: type: integer next: type: string format: uri nullable: true previous: type: string format: uri nullable: true results: type: array items: $ref: '#/components/schemas/OrganizationList' components: schemas: OrganizationList: required: - name - slug type: object properties: uid: title: Uid type: string format: uuid readOnly: true name: title: Name type: string maxLength: 1024 minLength: 1 slug: title: Slug type: string format: slug pattern: ^[-a-zA-Z0-9_]+$ maxLength: 255 minLength: 1 handle: title: Handle description: >- Unique handle for the organization (e.g., 'irobot'). Used in URLs and mentions. type: string pattern: ^[a-zA-Z0-9_]+$ maxLength: 50 nullable: true logo: title: Logo type: string readOnly: true format: uri nullable: true industry: title: Industry type: string enum: - robotics - autonomous_vehicle - ai_ml - other visibility: title: Visibility description: Whether the organization profile is publicly visible. type: string enum: - public - private plan: title: Plan description: Subscription plan for the organization. type: string enum: - basic - pro - enterprise is_verified: title: Is verified description: Whether the organization has been verified by staff. type: boolean is_active: title: Is active description: >- Whether the organization is active. Inactive organizations cannot be accessed. type: boolean member_count: title: Member count description: Number of members in the organization type: integer readOnly: true team_count: title: Team count description: Number of teams in the organization type: integer readOnly: true role: title: Role description: Current user's role in this organization type: string readOnly: true nullable: true billing_status: title: Billing status description: >- Billing subscription status: active, past_due, canceled, trialing, inactive, or null type: string readOnly: true nullable: true created_at: title: Created at type: string format: date-time readOnly: true joined_at: title: Joined at description: When the current user joined this organization type: string readOnly: true nullable: true public_slug: title: Public slug description: >- Canonical slug for URL rendering. Coworker viewers receive the organization's codename; others receive the real slug. type: string readOnly: true securitySchemes: API_Key: type: apiKey name: X-Avala-Api-Key in: header description: >- API key for authentication. Generate one in Mission Control Settings > Security & Identity. JWT: type: apiKey name: Authorization in: header description: JWT token with 'JWT' prefix, e.g., 'JWT eyJhbGciOiJIUzI1NiIsInR...' ````