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

# List units (Preview)

> Search the learning units in your organization. Requires the `units:read` scope.

By default, returns standalone units only (not sections inside a course). Returns up to 1,000 units per request; use `skip` to page.



## OpenAPI

````yaml /api-reference/openapi.yaml post /api/v1/public-api/units/.search
openapi: 3.1.0
info:
  title: Juno Journey API
  version: 1.0.0
  description: >-
    The Juno public API. See the [API
    overview](https://docs.junojourney.com/integrations/api-overview) for
    authentication, scopes and limits.
servers:
  - url: https://api.the-juno.com
security:
  - BearerAuth: []
paths:
  /api/v1/public-api/units/.search:
    post:
      tags:
        - Units
      summary: List units (Preview)
      description: >-
        Search the learning units in your organization. Requires the
        `units:read` scope.


        By default, returns standalone units only (not sections inside a
        course). Returns up to 1,000 units per request; use `skip` to page.
      operationId: listUnits
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SearchRequest'
            example:
              filters: {}
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  dataLength:
                    type: integer
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        _id:
                          type: string
                        standalone:
                          type: boolean
                        creator:
                          type: string
                        title:
                          type: string
                        type:
                          type: string
                        tid:
                          type: string
                        createdAt:
                          type: string
                          format: date-time
                        updatedAt:
                          type: string
                          format: date-time
              examples:
                List Units - without filters:
                  value:
                    dataLength: 1000
                    data:
                      - _id: 64f0c0ffee00000000000003
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Course Reviews
                        type: module
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-30T08:50:47.357Z'
                        updatedAt: '2025-04-30T09:20:15.021Z'
                      - _id: 64f0c0ffee00000000000004
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Course Reviews
                        type: module
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-30T08:50:47.457Z'
                        updatedAt: '2025-04-30T09:20:15.021Z'
                List Units - by creator ID:
                  value:
                    dataLength: 148
                    data:
                      - _id: 64f0c0ffee00000000000003
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Course Reviews
                        type: module
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-30T08:50:47.357Z'
                        updatedAt: '2025-04-30T09:20:15.021Z'
                      - _id: 64f0c0ffee00000000000004
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Course Reviews
                        type: module
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-30T08:50:47.457Z'
                        updatedAt: '2025-04-30T09:20:15.021Z'
                List Units-  by training type (course):
                  value:
                    dataLength: 262
                    data:
                      - _id: 64f0c0ffee00000000000005
                        standalone: true
                        title: Security & Data Protection
                        photoUrl: https://images.example.com/unit-cover.png
                        type: learning
                        tid: 64f0c0ffee00000000000002
                        creator: 64f0c0ffee00000000000001
                        createdAt: '2023-07-12T11:28:29.662Z'
                        updatedAt: '2025-04-08T14:52:30.636Z'
                        catalog: 2
                      - _id: 64f0c0ffee00000000000006
                        standalone: true
                        title: Inclusion & Diversity In The Workplace
                        photoUrl: https://images.example.com/unit-cover.png
                        type: learning
                        tid: 64f0c0ffee00000000000002
                        creator: 64f0c0ffee00000000000001
                        createdAt: '2023-07-12T11:28:42.696Z'
                        updatedAt: '2025-04-08T14:52:30.638Z'
                        catalog: 2
                List Units - created after date:
                  value:
                    dataLength: 304
                    data:
                      - _id: 64f0c0ffee00000000000003
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Course Reviews
                        type: module
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-30T08:50:47.357Z'
                        updatedAt: '2025-04-30T09:20:15.021Z'
                      - _id: 64f0c0ffee00000000000004
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Course Reviews
                        type: module
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-30T08:50:47.457Z'
                        updatedAt: '2025-04-30T09:20:15.021Z'
                List Units - all filters combined:
                  value:
                    dataLength: 4
                    data:
                      - _id: 64f0c0ffee00000000000007
                        photoUrl: >-
                          https://images.unsplash.com/photo-1553356084-58ef4a67b2a7?ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&ixlib=rb-1.2.1&auto=format&fit=crop&w=687&q=80
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: test for eran
                        type: learning
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-03-17T12:56:38.484Z'
                        updatedAt: '2025-04-22T16:24:03.276Z'
                      - _id: 64f0c0ffee00000000000008
                        photoUrl: >-
                          https://images.unsplash.com/photo-1553356084-58ef4a67b2a7?ixid=MnwxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8&ixlib=rb-1.2.1&auto=format&fit=crop&w=687&q=80
                        standalone: true
                        creator: 64f0c0ffee00000000000001
                        title: Untitled Course
                        type: learning
                        tid: 64f0c0ffee00000000000002
                        createdAt: '2025-04-14T18:28:45.826Z'
                        updatedAt: '2025-04-14T18:30:38.476Z'
      security:
        - BearerAuth: []
components:
  schemas:
    SearchRequest:
      type: object
      properties:
        filters:
          type: object
          description: >-
            MongoDB-style filters. The endpoint description lists the supported
            fields.
        limit:
          type: integer
          minimum: 1
          maximum: 1000
          default: 1000
          description: Maximum number of results to return.
        skip:
          type: integer
          minimum: 0
          default: 0
          description: Number of results to skip before returning.
        sort:
          type: object
          description: 'MongoDB-style sort, for example `{ "createdAt": -1 }`.'
        select:
          type: object
          description: >-
            Fields to return, MongoDB projection style, for example `{
            "primaryEmail": 1 }`.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Personal access token. Create one in Admin → Security → Developer
        Settings → Generate Personal Access Token.

````

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