> ## Documentation Index > Fetch the complete documentation index at: https://docs.nouxdigital.com/llms.txt > Use this file to discover all available pages before exploring further. # List rooms for organization > Get light metadata for rooms owned by the organization. Results are paginated using cursor-based pagination. Rooms are sorted by creation date (newest first) for consistent ordering. Use the optional `from` query parameter to specify a room ID to start from (inclusive). If omitted, starts from the newest room. Use the optional `pageSize` parameter to control how many rooms to return (2-100, default 100). The `hasMore` field indicates if there are additional rooms available. The `total` field shows the total number of rooms in the organization. This endpoint can be used to loop through all rooms and get full room details one-by-one using the room/{id} endpoint. Authenticate using Bearer token with your Noux API key. ## OpenAPI ````yaml /openapi.json get /api/v1/rooms openapi: 3.0.0 info: title: Noux REST API version: 1.0.0 description: This page contains the standard OpenAPI specification for the Noux REST API. contact: name: Noux Digital Oy url: https://nouxdigital.com/ servers: - url: https://api.noux.app description: Production API - url: http://localhost:4000 description: Local development security: [] paths: /api/v1/rooms: get: tags: - Rooms summary: List rooms for organization description: >- Get light metadata for rooms owned by the organization. Results are paginated using cursor-based pagination. Rooms are sorted by creation date (newest first) for consistent ordering. Use the optional `from` query parameter to specify a room ID to start from (inclusive). If omitted, starts from the newest room. Use the optional `pageSize` parameter to control how many rooms to return (2-100, default 100). The `hasMore` field indicates if there are additional rooms available. The `total` field shows the total number of rooms in the organization. This endpoint can be used to loop through all rooms and get full room details one-by-one using the room/{id} endpoint. Authenticate using Bearer token with your Noux API key. parameters: - schema: type: string description: >- Optional room ID to start from (inclusive). The specified room will be included in the results. Must belong to your organization. required: false description: >- Optional room ID to start from (inclusive). The specified room will be included in the results. Must belong to your organization. name: from in: query - schema: type: string pattern: ^\d+$ description: >- Number of rooms per page. Must be between 2 and 100. Default is 100. required: false description: Number of rooms per page. Must be between 2 and 100. Default is 100. name: pageSize in: query - schema: type: string description: Bearer token with Noux API key required: true description: Bearer token with Noux API key name: authorization in: header responses: '200': description: Rooms list retrieved successfully content: application/json: schema: type: object properties: rooms: type: array items: type: object properties: roomId: type: string roomName: type: string languageCode: type: string description: >- Language code for the room. Defaults to "en" (English) if not set. owner: type: object properties: id: type: string email: type: string nullable: true format: email firstName: type: string nullable: true lastName: type: string nullable: true required: - id - email - firstName - lastName editors: type: array items: type: object properties: id: type: string email: type: string nullable: true format: email firstName: type: string nullable: true lastName: type: string nullable: true required: - id - email - firstName - lastName required: - roomId - roomName - languageCode - owner - editors hasMore: type: boolean description: >- Indicates if there are more rooms available beyond the current page total: type: number description: Total number of rooms in the organization pageSize: type: number description: >- Number of rooms per page (as specified in the request, default 100) required: - rooms - hasMore - total - pageSize '400': description: Bad Request - invalid pageSize or from room ID content: application/json: schema: type: object properties: error: type: boolean enum: - true description: Indicates this is an error response code: type: string enum: - PARSE_ERROR - BAD_REQUEST - INTERNAL_SERVER_ERROR - NOT_IMPLEMENTED - METHOD_NOT_SUPPORTED - TIMEOUT - CONFLICT - PRECONDITION_FAILED - PAYLOAD_TOO_LARGE - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - CLIENT_CLOSED_REQUEST - INVALID_INPUT - UNAUTHORIZED - NOT_FOUND - FORBIDDEN - INVALID_STATE - SERVER_ERROR description: Error code for programmatic handling message: type: string description: Human-readable error message required: - error - code - message '401': description: Unauthorized - invalid or missing API key content: application/json: schema: type: object properties: error: type: boolean enum: - true description: Indicates this is an error response code: type: string enum: - PARSE_ERROR - BAD_REQUEST - INTERNAL_SERVER_ERROR - NOT_IMPLEMENTED - METHOD_NOT_SUPPORTED - TIMEOUT - CONFLICT - PRECONDITION_FAILED - PAYLOAD_TOO_LARGE - UNPROCESSABLE_CONTENT - TOO_MANY_REQUESTS - CLIENT_CLOSED_REQUEST - INVALID_INPUT - UNAUTHORIZED - NOT_FOUND - FORBIDDEN - INVALID_STATE - SERVER_ERROR description: Error code for programmatic handling message: type: string description: Human-readable error message required: - error - code - message security: - BearerAuth: [] components: securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: API Key description: Noux API key from your integration settings ````