Get company list folder
curl --request GET \
--url https://openapi.enginy.ai/v1/folders/companies/{folderId} \
--header 'x-api-key: <api-key>'import requests
url = "https://openapi.enginy.ai/v1/folders/companies/{folderId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://openapi.enginy.ai/v1/folders/companies/{folderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://openapi.enginy.ai/v1/folders/companies/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openapi.enginy.ai/v1/folders/companies/{folderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://openapi.enginy.ai/v1/folders/companies/{folderId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://openapi.enginy.ai/v1/folders/companies/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"name": "<string>",
"parentId": 123,
"appUrl": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"listsCount": 123,
"subfoldersCount": 123,
"children": [
{
"id": 123,
"name": "<string>",
"_count": {
"children": 123,
"leadsGroup": 123,
"companyGroup": 123
}
}
],
"parent": {
"id": 123,
"name": "<string>"
},
"ancestors": [
{
"id": 123,
"name": "<string>",
"parentId": 123
}
],
"totalSubfoldersCount": 123,
"totalListsCount": 123,
"leadsGroup": [
{
"id": 123,
"name": "<string>",
"appUrl": "<string>",
"description": "<string>",
"folderId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": {
"id": 123,
"name": "<string>"
},
"_count": {
"leadsGroupLeads": 123
}
}
],
"companyGroup": [
{
"id": 123,
"name": "<string>",
"appUrl": "<string>",
"description": "<string>",
"folderId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": {
"id": 123,
"name": "<string>"
},
"_count": {
"companyGroupCompany": 123
}
}
]
}
}Lists
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_READRate limit: 100 requests per minute
GET
/
v1
/
folders
/
companies
/
{folderId}
Get company list folder
curl --request GET \
--url https://openapi.enginy.ai/v1/folders/companies/{folderId} \
--header 'x-api-key: <api-key>'import requests
url = "https://openapi.enginy.ai/v1/folders/companies/{folderId}"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://openapi.enginy.ai/v1/folders/companies/{folderId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://openapi.enginy.ai/v1/folders/companies/{folderId}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://openapi.enginy.ai/v1/folders/companies/{folderId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://openapi.enginy.ai/v1/folders/companies/{folderId}")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://openapi.enginy.ai/v1/folders/companies/{folderId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "<string>",
"data": {
"id": 123,
"name": "<string>",
"parentId": 123,
"appUrl": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"listsCount": 123,
"subfoldersCount": 123,
"children": [
{
"id": 123,
"name": "<string>",
"_count": {
"children": 123,
"leadsGroup": 123,
"companyGroup": 123
}
}
],
"parent": {
"id": 123,
"name": "<string>"
},
"ancestors": [
{
"id": 123,
"name": "<string>",
"parentId": 123
}
],
"totalSubfoldersCount": 123,
"totalListsCount": 123,
"leadsGroup": [
{
"id": 123,
"name": "<string>",
"appUrl": "<string>",
"description": "<string>",
"folderId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": {
"id": 123,
"name": "<string>"
},
"_count": {
"leadsGroupLeads": 123
}
}
],
"companyGroup": [
{
"id": 123,
"name": "<string>",
"appUrl": "<string>",
"description": "<string>",
"folderId": 123,
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"createdBy": {
"id": 123,
"name": "<string>"
},
"_count": {
"companyGroupCompany": 123
}
}
]
}
}⌘I