GET
/
api
/
v2
/
folders
cURL
curl --request GET \
  --url https://us.infisical.com/api/v2/folders \
  --header 'Authorization: Bearer <token>'
{
  "folders": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "version": 1,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z",
      "envId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "parentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "isReserved": false,
      "description": "<string>",
      "lastSecretModified": "2023-11-07T05:31:56Z",
      "relativePath": "<string>"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

An access token in Infisical

Query Parameters

​
projectId
string
required

The ID of the project to list folders from.

​
environment
string
required

The slug of the environment to list folders from.

​
lastSecretModified
string<date-time>

The timestamp used to filter folders with secrets modified after the specified date. The format for this timestamp is ISO 8601 (e.g. 2025-04-01T09:41:45-04:00)

​
path
string
required

The path to list folders from.

​
recursive
default:false

Whether or not to fetch all folders from the specified base path, and all of its subdirectories.

Response

Default Response

​
folders
object[]
required