> ## Documentation Index > Fetch the complete documentation index at: https://docs.versori.com/llms.txt > Use this file to discover all available pages before exploring further. # Get organisations boards > Retrieves the boards belonging to a given organisation. ## OpenAPI ````yaml get /organisations/{organisationId}/boards openapi: 3.0.3 info: title: Switchboard API description: >- The Switchboard API provides users the ability to manage their Apps, Integrations and Workflows version: 0.0.1-alpha.0 servers: - url: https://platform.versori.com/api/switchboard/v1alpha1/ description: Production server - url: http://localhost:8080/v1alpha1/ description: Localhost security: - apiKey: [] paths: /organisations/{organisationId}/boards: get: tags: - boards description: | Retrieves the boards belonging to a given organisation. operationId: GetBoards parameters: - name: organisationId in: path required: true schema: type: string - name: search in: query required: false schema: type: string - name: first in: query required: false schema: type: integer default: 20 - name: before in: query required: false schema: type: string - name: after in: query required: false schema: type: string - name: tags in: query required: false schema: type: string examples: multiple tags: summary: Multiple tags value: env:prod,env:dev single tag: summary: Single tag value: env:prod - name: sort in: query required: false examples: single column ascending: summary: Single column search in ascending order value: id:asc single column descending: summary: Single column search in descending order value: name:desc multiple columns: summary: Multiple column search value: name:asc,id:desc schema: type: string pattern: ^([^:,]+:[^:,]+)(,[^:,]+:[^:,]+)*$ responses: '200': $ref: '#/components/responses/GetBoardsResponse' default: $ref: '#/components/responses/ErrorResponse' components: responses: GetBoardsResponse: description: A paginated set of Boards content: application/json: schema: $ref: '#/components/schemas/BoardsPage' ErrorResponse: description: The default error response content: application/json: schema: $ref: '#/components/schemas/Error' schemas: BoardsPage: type: object allOf: - $ref: '#/components/schemas/PageInfo' - type: object properties: items: type: array items: $ref: '#/components/schemas/Board' Error: type: object properties: code: type: string message: type: string extensions: type: object required: - code - message PageInfo: type: object properties: totalCount: type: integer next: type: string prev: type: string required: - totalCount Board: type: object properties: id: type: string orgId: type: string name: type: string hubId: type: string status: $ref: '#/components/schemas/BoardStatus' activePublishInfo: $ref: '#/components/schemas/BoardPublishInfo' recentPublishHistory: description: > RecentPublishHistory is an array of BoardPublishInfo containing up to the last 5 publishes for a board. If full history is required, users should use the ListPublishHistory operation for a paginated view. type: array items: $ref: '#/components/schemas/BoardPublishInfo' createdAt: type: string format: date-time updatedAt: type: string format: date-time deletedAt: type: string format: date-time tags: $ref: '#/components/schemas/BoardTagsBody' thumbnailUrl: type: string format: uri required: - id - orgId - name - status - createdAt - updatedAt BoardStatus: description: > BoardStatus is used to indicate the status of a board. The "unknown" status is used in case of inconsistencies in the database with the Board scheduler and the API cannot deduce the correct status without administrator intervention. If the status is "unknown", then clients should assume it's in a draft/published state based on whether the board has an "activePublishInfo" field. If a board cannot be published due to it already being published and the "activePublishInfo" field is null, users should contact support. type: string enum: - unknown - draft - publishing - published - unpublishing BoardPublishInfo: type: object description: BoardPublishInfo provides information on a published board instance properties: id: type: string taskId: description: > TaskID is a unique identifier for the execution of a board. Each time a board is (re)published a new task ID will be generated. type: string lastEventId: description: > LastEventID is the last observed event before this board was published. This may not be the last event on the stream for this board, since the observer may not have replayed all events at the time of publish. As such, the version of the board which will be executed is defined by this field, and not necessarily the latest event on the stream. type: string listeners: type: array items: $ref: '#/components/schemas/BoardListener' createdAt: type: string format: date-time updatedAt: type: string format: date-time deletedAt: type: string format: date-time required: - id - taskId - lastEventId - listeners - createdAt - updatedAt BoardTagsBody: type: object x-go-type: map[string][]string BoardListener: description: > BoardListener provides information on where a board is listening for external events. type: object properties: id: type: string appNodeId: description: > AppNodeID is the identifier of the App Node to which this listener's operation belongs to. type: string operationNodeId: description: > OperationNodeID is the identifier of the Operation within the App Node, which is listening for data from an external source. type: string url: description: > URL is the address for where the Node specified by NodeID is listening. Downstream services (such as webhooks) should be configured with this URL. type: string contentType: description: > ContentType is the "content-type" header for which data should be sent with. Initially only "application/json" is supported but other content types may be added in the future. type: string security: description: > Security defines any parameters which external services must supply in order for Switchboard to acknowledge an incoming event. If this is defined but an external service does not supply matching information, the event will be ignored. type: object additionalHeaders: description: > AdditionalHeaders describes any other headers which the downstream service must supply with the request. type: object additionalProperties: type: array items: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time deletedAt: type: string format: date-time required: - id - appNodeId - operationNodeId - url - contentType - createdAt - updatedAt securitySchemes: apiKey: type: apiKey in: header name: Authorization ````