List expiries (cursor-paginated)

Preview

gethttps://api.expiryedge.com/v2/expiries

any member of an organization60/min

Request

curl 'https://api.expiryedge.com/v2/expiries?status=all&type=License&updated_since=2026-09-01T00%3A00%3A00Z' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY"

Response

{
  "data": [
    {
      "id": "exp_4Tq9sLm2",
      "name": "Northwind Dental - State Dental License",
      "type": "License",
      "expiry_date": "2026-10-15",
      "state": "todo",
      "is_done": false,
      "is_archive": false,
      "contacts": [
        "c_8Hk2pQ"
      ],
      "organization_id": "org_northwind",
      "user_id": "u_71bXq",
      "has_share_password": false,
      "created_at": "2026-09-27T14:05:00.000Z",
      "updated_at": "2026-09-27T15:10:00.000Z"
    }
  ],
  "next_cursor": "WyJleHBpcnlfZGF0ZSIsIjIwMjYtMTAtMTUiLCJleHBfNFRxOXNMbTIiXQ",
  "has_more": true
}

Returns { data, next_cursor, has_more }, up to 100 per page (default 50). Pass next_cursor back as cursor with the same sort. Records missing the sort field are not returned. share_password is never returned.

Query parameters

statusstring
open = not done and not archived; done = is_done; archived = is_archive. Default all.
AllowedopendonearchivedallDefault all
typestring
Exact expiry type.
updated_sincestring
ISO 8601 timestamp; only records with updated_at at or after it.
format: date-time
sortstring
expiry_date (default), -expiry_date, updated_at, -updated_at (- = descending).
Allowedexpiry_date-expiry_dateupdated_at-updated_at
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 expiries.

dataarray of objectsrequired
next_cursorstring | nullrequired
Null on the last page.
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.