Get a folder

Preview

gethttps://api.expiryedge.com/v2/folders/{id}

any member of the folder's organization60/min

Request

curl 'https://api.expiryedge.com/v2/folders/fol_123' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY"

Response

{
  "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"
}

Deleted folders are 404.

Path parameters

idstringrequired

Returns

200

The folder.

idstring
namestring
parent_folder_idstring | null
folder_pathstring
organization_idstring
user_idstring
is_deletedboolean
Always false in v2 (deleted folders are 404).
created_atstring
UTC timestamp, ISO 8601. Every v1 response uses this form, never a raw Firestore Timestamp ({_seconds, _nanoseconds}).
format: date-time
updated_atstring
UTC timestamp, ISO 8601. Every v1 response uses this form, never a raw Firestore Timestamp ({_seconds, _nanoseconds}).
format: date-time

Errors

`401`	Missing, invalid or expired token (`UNAUTHORIZED`).
`403`	Your role can't do this, or your account has no organization (`FORBIDDEN`).
`404`	No such record in your organization (records in other organizations are also 404).
`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.