> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plazza.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Get roadmap facets

> The tags, plans and areas a board's published items use, to filter on.



## OpenAPI

````yaml /openapi/backend.json get /v1/roadmapBoards/{board}/facets
openapi: 3.0.0
info:
  title: Plazza API
  description: >-
    The Plazza REST API. Errors follow AIP-193 and carry a message in the
    language of Accept-Language, French or English.
  version: v1
servers:
  - url: https://api.plazza.ca
security:
  - bearer: []
paths:
  /v1/roadmapBoards/{board}/facets:
    get:
      tags:
        - Roadmap
      summary: Get roadmap facets
      description: The tags, plans and areas a board's published items use, to filter on.
      operationId: RoadmapItems.facets
      parameters:
        - name: board
          required: true
          in: path
          description: 'The board: `hire` for employers, `talents` for job seekers.'
          schema:
            type: string
            enum:
              - hire
              - talents
            description: 'The board: `hire` for employers, `talents` for job seekers.'
            example: hire
      responses:
        '200':
          description: >-
            The values a board's published items use, sorted, to filter on: up
            to 500 of each.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RoadmapFacets'
        default:
          description: An AIP-193 error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security: []
components:
  schemas:
    RoadmapFacets:
      type: object
      properties:
        name:
          type: string
          description: The facets' resource name.
          example: roadmapBoards/hire/facets
        tags:
          type: array
          items:
            type: string
          description: Every tag in use.
          example:
            - Mobile
        plans:
          type: array
          items:
            type: string
          description: Every plan in use.
          example:
            - Pro
        areas:
          type: array
          items:
            type: string
          description: Every area in use.
          example:
            - Scheduling
      required:
        - name
        - tags
        - plans
        - areas
      additionalProperties: false
      description: >-
        The values a board's published items use, sorted, to filter on: up to
        500 of each.
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
              minimum: -9007199254740991
              maximum: 9007199254740991
            message:
              type: string
            status:
              type: string
              enum:
                - INVALID_ARGUMENT
                - FAILED_PRECONDITION
                - OUT_OF_RANGE
                - UNAUTHENTICATED
                - PERMISSION_DENIED
                - NOT_FOUND
                - ABORTED
                - ALREADY_EXISTS
                - RESOURCE_EXHAUSTED
                - INTERNAL
                - UNIMPLEMENTED
                - UNAVAILABLE
                - DEADLINE_EXCEEDED
            details:
              type: array
              items:
                oneOf:
                  - type: object
                    properties:
                      '@type':
                        type: string
                        enum:
                          - type.googleapis.com/google.rpc.ErrorInfo
                      reason:
                        type: string
                      domain:
                        type: string
                      metadata:
                        type: object
                        additionalProperties:
                          type: string
                    required:
                      - '@type'
                      - reason
                      - domain
                    additionalProperties: false
                  - type: object
                    properties:
                      '@type':
                        type: string
                        enum:
                          - type.googleapis.com/google.rpc.LocalizedMessage
                      locale:
                        type: string
                      message:
                        type: string
                    required:
                      - '@type'
                      - locale
                      - message
                    additionalProperties: false
                  - type: object
                    properties:
                      '@type':
                        type: string
                        enum:
                          - type.googleapis.com/google.rpc.BadRequest
                      fieldViolations:
                        type: array
                        items:
                          type: object
                          properties:
                            field:
                              type: string
                            description:
                              type: string
                          required:
                            - field
                            - description
                          additionalProperties: false
                    required:
                      - '@type'
                      - fieldViolations
                    additionalProperties: false
                  - type: object
                    properties:
                      '@type':
                        type: string
                        enum:
                          - type.googleapis.com/google.rpc.RetryInfo
                      retryDelay:
                        type: string
                        pattern: ^\d+s$
                    required:
                      - '@type'
                      - retryDelay
                    additionalProperties: false
          required:
            - code
            - message
            - status
            - details
          additionalProperties: false
      required:
        - error
      additionalProperties: false
      description: An AIP-193 error.
      example:
        error:
          code: 401
          message: Unauthorized
          status: UNAUTHENTICATED
          details:
            - '@type': type.googleapis.com/google.rpc.ErrorInfo
              reason: MISSING_CREDENTIALS
              domain: api.plazza.ca
            - '@type': type.googleapis.com/google.rpc.LocalizedMessage
              locale: en
              message: Sign in to continue.
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: >-
        The session token of a signed-in Plazza account, sent as `Authorization:
        Bearer <token>`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.