Skip to main content
GET
/
v1
/
folders
/
contacts
List contact list folders
curl --request GET \
  --url https://openapi.enginy.ai/v1/folders/contacts \
  --header 'x-api-key: <api-key>'
{
  "status": "success",
  "message": "<string>",
  "data": [
    {
      "id": 123,
      "name": "<string>",
      "parentId": 123,
      "type": "CONTACTS",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "listsCount": 123,
      "subfoldersCount": 123,
      "totalSubfoldersCount": 123,
      "totalListsCount": 123
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
includeChildren
enum<string>

When true, includes nested folders instead of only root folders.

Available options:
true,
false
​
includeRecursiveCounts
enum<string>

When true, includes recursive subfolder and list counts.

Available options:
true,
false

Response

200 - application/json

Folders retrieved successfully

​
status
enum<string>
required
Available options:
success
​
message
string
required
​
data
object[]
required