Skip to content
bynhDocs
Log in

List expiry reminders

GET/workspaces/{workspace}/certificates/{certificate}/reminders

Shows the 90, 30 and 7-day expiry reminders for the certificate’s current expiry date: sent (when and to whom), skipped, missed, upcoming or not scheduled.

Authentication

Send an API token as a bearer token. This endpoint needs a read token, made by any member of the workspace. Create one in My account → API tokens; see scopes and roles.

Authorization: Bearer 42|bynh_pat_•••••••Header

Path parameters

  • workspacestringRequired

    Your workspace slug, e.g. dokan.

  • certificateintegerRequired

    Certificate id.

Response

200 OK

Always three rows, in the order 90, 30, 7.

  • days_beforeenumDays before expiry. One of 90, 30, 7.
  • stateenumskipped: the certificate was added inside a later window. not_scheduled: no expiry date, or in audit. missed: expiry already past and nothing was sent. One of sent, skipped, missed, upcoming, not_scheduled.
  • datestring|nullISO 8601 time it was sent (sent or skipped), otherwise the planned date YYYY-MM-DD; null without an expiry date.
  • recipientsarray<{id: integer, name: string}>Members emailed; empty unless sent.

Rate limits

This endpoint counts toward your general limit of 120 requests a minute. When you go over, wait for the number of seconds in Retry-After.

Errors

401The token is missing, wrong, revoked or expired.
404The token belongs to another workspace, or its owner is no longer a member. Or: No certificate with that id in this workspace.

Every error is JSON with a message. See Errors.

Next →Download a document
curl "https://api.bynh.io/api/v1/workspaces/dokan/certificates/1/reminders" \
  -H "Authorization: Bearer $BYNH_TOKEN" \
  -H "Accept: application/json"

Response200 OK

application/json
{
  "data": [
    {
      "days_before": 90,
      "state": "sent",
      "date": "2026-07-21T06:00:04+00:00",
      "recipients": [
        {
          "id": 14,
          "name": "Sara Alqahtani"
        },
        {
          "id": 21,
          "name": "Faisal Alharbi"
        }
      ]
    },
    {
      "days_before": 30,
      "state": "sent",
      "date": "2026-09-19T06:00:02+00:00",
      "recipients": [
        {
          "id": 14,
          "name": "Sara Alqahtani"
        }
      ]
    },
    {
      "days_before": 7,
      "state": "upcoming",
      "date": "2026-10-12",
      "recipients": []
    }
  ]
}

Examples use Dokan, a sample workspace. Responses are shortened where lists are long.