> ## Documentation Index > Fetch the complete documentation index at: https://developer.jobmojito.com/llms.txt > Use this file to discover all available pages before exploring further. # List coaching catalogue directories > Paginated list of the coaching-catalogue directories visible to you: your merchant's own, plus the platform-wide `public` ones unless you set include_public=false. Use it to find a directory id before updating one, to pick a `parent_tag`, or to walk the tree with `parent_tag`. The custom Markdown page is not included — fetch it per directory with catalogue-tag-get. ## OpenAPI ````yaml https://cool.jobmojito.com/functions/v1/openapi get /catalogue-tag-list openapi: 3.1.0 info: title: JobMojito API version: 1.0.0 description: >- Public API for JobMojito, served by Supabase Edge Functions. Authenticate with a Supabase JWT access token via the Authorization header. servers: - url: https://cool.jobmojito.com/functions/v1 description: Production security: [] tags: - name: Interviews description: >- Create, configure and manage interview / coaching / assessment definitions. - name: Coaching catalogue description: >- Directories (pages) of the coaching portal catalogue that group coaching sessions and carry custom content pages. - name: Results description: >- Interview results, transcripts, reports, re-attempt requests and analytics. - name: Candidates description: List and manage candidates. - name: Knowledge base description: Upload documents used to generate knowledge-base interviews. - name: Resume & Form verification description: Pre-screen candidates from resumes and forms. - name: Admin description: >- Account administration — invite team/coaching users, manage sub-merchants and avatar templates. paths: /catalogue-tag-list: get: tags: - Coaching catalogue summary: List coaching catalogue directories description: >- Paginated list of the coaching-catalogue directories visible to you: your merchant's own, plus the platform-wide `public` ones unless you set include_public=false. Use it to find a directory id before updating one, to pick a `parent_tag`, or to walk the tree with `parent_tag`. The custom Markdown page is not included — fetch it per directory with catalogue-tag-get. parameters: - schema: type: string format: uuid description: >- Optional merchant to scope to. Admins and sub-merchant operators only; other callers always use their token's merchant. example: 28106cba-1c27-4e53-b149-32113e5e8e31 required: false name: merchant_id in: query - schema: type: string enum: - draft - active - archived description: >- Filter by lifecycle status. Omit to include every status you can see (deleted directories are never returned). example: active required: false name: status in: query - schema: type: string enum: - public - merchant_public - merchant_invite - merchant_unlisted description: Filter by visibility. example: merchant_public required: false name: visibility in: query - schema: type: string description: >- Filter by the directory language (a platform-languages.json code, e.g. `en`). required: false name: mojito_language_code in: query - schema: type: string description: Case-insensitive search on the directory id, name and description. required: false name: filter_text in: query - schema: type: string description: >- Return only the directories nested directly under this one (its `tags_sub`), in the parent's own order. Combine with the other filters to narrow further. required: false name: parent_tag in: query - schema: type: string enum: - 'true' - 'false' default: 'true' description: >- Include the platform-wide `public` directories shared across merchants. example: 'true' required: false name: include_public in: query - schema: type: integer minimum: 1 maximum: 1000 default: 50 description: Maximum number of records to return (1–1000). example: 50 required: false name: limit in: query - schema: type: integer nullable: true minimum: 0 default: 0 description: Number of records to skip from the start of the result set. example: 0 required: false name: offset in: query responses: '200': description: A page of catalogue directories with pagination metadata. content: application/json: schema: $ref: '#/components/schemas/CatalogueTagListResponse' '401': description: Missing or invalid access token. content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Caller is not permitted to read this merchant. content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Validation error. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Server error. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: CatalogueTagListResponse: type: object properties: data: type: array items: type: object properties: id: type: string description: >- Directory id — also the catalogue URL segment and the value referenced in a parent's `tags_sub`. example: sales-coaching-en name: type: string nullable: true description: Display name. description: type: string nullable: true description: Short description shown on the directory card. mojito_language_code: type: string nullable: true description: Directory language. example: en visibility: type: string nullable: true description: >- Who can see it (public/merchant_public/merchant_invite/merchant_unlisted). status: type: string nullable: true description: Lifecycle status (draft/active/archived). coach_plan: type: string nullable: true description: Coaching-plan stage, when the directory belongs to one. cover_image_url: type: string nullable: true description: Cover image URL. merchant_id: type: string nullable: true description: Owning merchant id. Null for a platform-wide directory. tags_sub: type: array nullable: true items: type: string description: >- Ids of the directories nested under this one, in display order. tags_interview_set_filter: type: array nullable: true items: type: string description: >- Tag filter selecting the coaching sessions this directory lists: a session appears when its own `tags` contain every tag here. has_content_page: type: boolean description: >- True when the directory has a custom Markdown page. Read the Markdown itself with catalogue-tag-get. is_start_directory: type: boolean description: >- True for the directory the merchant's catalogue opens on — the root to navigate down from. created_at: type: string nullable: true description: Creation timestamp (ISO 8601). updated_at: type: string nullable: true description: Last update timestamp (ISO 8601). required: - id - has_content_page - is_start_directory additionalProperties: nullable: true description: The catalogue directories for this page, ordered by id. pagination: $ref: '#/components/schemas/Pagination' required: - data - pagination Error: type: object properties: error: type: string example: Field is required. name: type: string example: interview_result_id required: - error Pagination: type: object properties: total: type: integer description: Total matching records across all pages. example: 137 limit: type: integer description: Page size used for this response. example: 50 offset: type: integer description: Offset used for this response. example: 0 has_more: type: boolean description: >- True when more records exist beyond this page (offset + returned < total). example: true required: - total - limit - offset - has_more securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: 'Supabase JWT — `Authorization: Bearer `.' ````