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

# Get company list folder

> Get a company list folder with its child folders, lists, and breadcrumb ancestors.

Responses include direct Enginy app URLs when available. The folder and embedded lists include direct Enginy app URLs. MCP agents should return those URLs to users whenever they are present in the response.

    > **Required scope:** `LISTS_READ`
    >
    > **Rate limit:** 100 requests per minute



## OpenAPI

````yaml https://openapi.enginy.ai/definitions.json get /v1/folders/companies/{folderId}
openapi: 3.1.0
info:
  title: Enginy API
  version: 1.0.0
  description: Public API for Enginy platform
servers:
  - url: https://openapi.enginy.ai
    description: Configured server
security: []
tags:
  - name: AI Variables
    description: >-
      Manage AI variables and discover the entity fields you can reference in
      prompts and entity requests.
  - name: Inbox
    description: >-
      Inbox endpoints for listing contact threads, reading thread messages,
      managing tags, and sending manual replies.
  - name: Workflows
    description: >-
      Build, validate, publish, run, and inspect advanced (graph) workflows,
      plus the block/condition catalog needed to author a workflow plan.
paths:
  /v1/folders/companies/{folderId}:
    get:
      tags:
        - Lists
      summary: Get company list folder
      description: >-
        Get a company list folder with its child folders, lists, and breadcrumb
        ancestors.


        Responses include direct Enginy app URLs when available. The folder and
        embedded lists include direct Enginy app URLs. MCP agents should return
        those URLs to users whenever they are present in the response.

            > **Required scope:** `LISTS_READ`
            >
            > **Rate limit:** 100 requests per minute
      parameters:
        - schema:
            type: string
            description: Folder ID
          required: true
          description: Folder ID
          name: folderId
          in: path
      responses:
        '200':
          description: Folder retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: number
                      name:
                        type: string
                      parentId:
                        type:
                          - number
                          - 'null'
                      type:
                        type: string
                        enum:
                          - CONTACTS
                          - COMPANIES
                      appUrl:
                        type: string
                        format: uri
                      createdAt:
                        type: string
                        format: date-time
                      updatedAt:
                        type: string
                        format: date-time
                      listsCount:
                        type: number
                      subfoldersCount:
                        type: number
                      totalSubfoldersCount:
                        type: number
                      totalListsCount:
                        type: number
                      children:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: number
                            name:
                              type: string
                            _count:
                              type: object
                              properties:
                                leadsGroup:
                                  type: number
                                companyGroup:
                                  type: number
                                children:
                                  type: number
                              required:
                                - children
                          required:
                            - id
                            - name
                            - _count
                      parent:
                        type:
                          - object
                          - 'null'
                        properties:
                          id:
                            type: number
                          name:
                            type: string
                        required:
                          - id
                          - name
                      leadsGroup:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: number
                            name:
                              type: string
                            appUrl:
                              type: string
                              format: uri
                            description:
                              type:
                                - string
                                - 'null'
                            folderId:
                              type:
                                - number
                                - 'null'
                            createdAt:
                              type: string
                              format: date-time
                            updatedAt:
                              type: string
                              format: date-time
                            createdBy:
                              type:
                                - object
                                - 'null'
                              properties:
                                id:
                                  type: number
                                name:
                                  type: string
                              required:
                                - id
                                - name
                            _count:
                              type: object
                              properties:
                                leadsGroupLeads:
                                  type: number
                              required:
                                - leadsGroupLeads
                          required:
                            - id
                            - name
                            - appUrl
                            - description
                            - folderId
                            - createdAt
                            - updatedAt
                            - createdBy
                            - _count
                      companyGroup:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: number
                            name:
                              type: string
                            appUrl:
                              type: string
                              format: uri
                            description:
                              type:
                                - string
                                - 'null'
                            folderId:
                              type:
                                - number
                                - 'null'
                            createdAt:
                              type: string
                              format: date-time
                            updatedAt:
                              type: string
                              format: date-time
                            createdBy:
                              type:
                                - object
                                - 'null'
                              properties:
                                id:
                                  type: number
                                name:
                                  type: string
                              required:
                                - id
                                - name
                            _count:
                              type: object
                              properties:
                                companyGroupCompany:
                                  type: number
                              required:
                                - companyGroupCompany
                          required:
                            - id
                            - name
                            - appUrl
                            - description
                            - folderId
                            - createdAt
                            - updatedAt
                            - createdBy
                            - _count
                      ancestors:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: number
                            name:
                              type: string
                            parentId:
                              type:
                                - number
                                - 'null'
                          required:
                            - id
                            - name
                            - parentId
                    required:
                      - id
                      - name
                      - parentId
                      - type
                      - appUrl
                      - createdAt
                      - updatedAt
                      - listsCount
                      - subfoldersCount
                      - children
                      - parent
                      - ancestors
                required:
                  - status
                  - message
                  - data
        '404':
          description: Folder not found
      security:
        - apiKey: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key

````