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

# Get all glossary entries

> Return alphabetised Learn glossary items.

Provides the Learn screen glossary entries. Responses are cached for 30 minutes.

### Authentication & headers

<ParamField header="Authorization" type="string" required>
  Bearer token issued by Auth0. Format: `Bearer YOUR_ACCESS_TOKEN` and must include the `wealthyhood:nbg` scope.
</ParamField>

### Example request

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://api.wealthyhood.com/learn/glossary' \
    -H 'Accept: application/json' \
    -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
  ```
</RequestExample>

### Example response

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "key": "compound-interest",
        "contentType": "glossary",
        "createdAt": "2023-08-31T11:00:00.000Z",
        "title": "Compound interest",
        "definitionHTML": "<body><p>The interest you earn on interest.</p></body>"
      }
    ]
  }
  ```
</ResponseExample>

### Response fields

<ResponseField name="data" type="GlossaryItem[]" required>
  Alphabetised list of glossary terms.

  <Expandable title="GlossaryItem">
    <ResponseField name="key" type="string" />

    <ResponseField name="title" type="string" />

    <ResponseField name="definitionHTML" type="string" />

    <ResponseField name="createdAt" type="date-time" />
  </Expandable>
</ResponseField>


## OpenAPI

````yaml GET /learn/glossary
openapi: 3.0.3
info:
  title: Wealthyhood Learn API
  version: 1.0.0
  description: >
    Machine-to-machine endpoints that power the Wealthyhood Learn screen.


    All routes require a bearer access token issued by Auth0 with the
    `wealthyhood:nbg` scope.
servers:
  - url: https://{host}
    variables:
      host:
        default: api.wealthyhood.com
        description: Wealthyhood API host.
security:
  - bearerAuth: []
tags:
  - name: Learn
    description: Investor education content surfaced in the Learn screen.
paths:
  /learn/glossary:
    get:
      tags:
        - Learn
      summary: Get all glossary entries
      description: >
        Provides the Learn screen glossary entries sorted alphabetically.
        Responses are cached for 30 minutes.
      parameters:
        - $ref: '#/components/parameters/XUserId'
      responses:
        '200':
          description: Glossary item collection.
          headers:
            Cache-Control:
              schema:
                type: string
              description: Response cached for 30 minutes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GlossaryResponse'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '403':
          $ref: '#/components/responses/ForbiddenError'
components:
  parameters:
    XUserId:
      name: x-user-id
      in: header
      required: true
      description: >-
        MongoDB identifier of the Wealthyhood user. Used to determine the
        language preference for localized content.
      schema:
        type: string
        pattern: ^[a-f0-9]{24}$
  schemas:
    GlossaryResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/GlossaryItem'
      required:
        - data
    GlossaryItem:
      type: object
      properties:
        key:
          type: string
        createdAt:
          type: string
          format: date-time
        title:
          type: string
        definitionHTML:
          type: string
          description: HTML rendering of the glossary definition.
      required:
        - key
        - createdAt
        - title
        - definitionHTML
    ApiErrorResponse:
      type: object
      properties:
        status:
          type: integer
        error:
          type: object
          properties:
            message:
              type: string
            description:
              type: string
              nullable: true
        responseId:
          type: string
          format: uuid
  responses:
    UnauthorizedError:
      description: Missing or invalid bearer token.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
    ForbiddenError:
      description: Token lacks the required scope.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ApiErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Auth0-issued access token that includes the `wealthyhood:nbg` scope.

````