List folders (flat, cursor-paginated)

Preview
gethttps://api.expiryedge.com/v2/folders
any member of an organization60/min
Request
curl 'https://api.expiryedge.com/v2/folders?limit=50' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY"
Response
{
  "data": [
    {
      "id": "fol_123",
      "name": "Example name",
      "parent_folder_id": "fol_123",
      "folder_path": "/Licenses/Dental",
      "organization_id": "org_123",
      "user_id": "use_123",
      "is_deleted": true,
      "created_at": "2026-09-27T14:05:00.000Z",
      "updated_at": "2026-09-27T14:05:00.000Z"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Folders that are not deleted, ordered by id, as stored (parent_folder_id, folder_path) - not the nested tree v1 getAllFolders returns.

Query parameters

  • parent_folder_idstring
    Only children of this folder; root = top-level folders.
  • sortstring
    Allowedid
  • cursorstring
    Opaque next_cursor from the previous page. Only valid with the same sort.
  • limitinteger
    Page size, 1-100 (values above 100 are clamped; default 50).
    Default 50min: 1 · max: 100

Returns

200
A page of folders.
  • dataarray of objectsrequired
  • next_cursorstring | nullrequired
  • has_morebooleanrequired

Errors

400
Invalid parameters or body (VALIDATION_FAILED; details names the fields).
401
Missing, invalid or expired token (UNAUTHORIZED).
403
Your role can't do this, or your account has no organization (FORBIDDEN).
405
Wrong HTTP method for this path; the Allow header lists the valid ones.
429
Too many requests for this endpoint from your IP. Wait Retry-After seconds.