Approvals

Changes waiting for an approver.

Base URL https://api.zilomail.in

Get an approval#

GET/v1/approvals/{id}

any valid token

Where a change that waits for approval stands. Only the person who asked (or their approvers) can see it. The approval.decided webhook says the same when it's decided.

Path

idstringrequired

An id this API gave out. Up to 64 characters.

Answer · 200 OK

idstring

statusenum

One of pending, approved, rejected.

modulestring

actionstring

recordIdstring | null

summarystring | null

currentLevelinteger

levelsinteger

reasonstring | null

createdAtstring

ISO 8601 date and time, UTC, e.g. 2026-10-17T09:30:00.000Z.

decidedAtstring | null

curl "https://api.zilomail.in/v1/approvals/ID" \
  -H "Authorization: Bearer $ZILO_TOKEN"

Answer · 200 OK

{
  "id": "string",
  "status": "pending",
  "module": "string",
  "action": "string",
  "recordId": "string",
  "summary": "string",
  "currentLevel": 0,
  "levels": 0,
  "reason": "string",
  "createdAt": "2026-10-17T09:30:00.000Z",
  "decidedAt": "2026-10-17T09:30:00.000Z"
}

Try it