Get an expiry's renewal history

posthttps://api.expiryedge.com/v1/getRenewalHistory

any role in the expiry's organization60/minAny method

Request

curl -X POST 'https://api.expiryedge.com/v1/getRenewalHistory?id=exp_4Tq9sLm2' \
  -H "Authorization: Bearer $EXPIRYEDGE_API_KEY"

Response

{
  "data": [
    {
      "from_expiry_id": "exp_4Tq9sLm2",
      "to_expiry_id": "exp_7Pn2xQa8",
      "occurrence_number": 2,
      "renewed_at": "2026-10-15T09:00:12.000Z",
      "renewal_type": "automatic",
      "renewal_mode": "renew_as_copy",
      "previous_date": "2026-10-15",
      "new_date": "2027-10-15",
      "timestamp": "2026-10-15T09:00:12.000Z"
    }
  ],
  "count": 1
}

Returns the renewals recorded on this expiry (the original of a recurring series). Unbounded.

Query parameters

idstringrequired
Expiry id.

Returns

200

Renewal history entries, oldest first.

dataarray of objectsrequired
countintegerrequired

Errors

`400`	The request is missing required fields or contains invalid values.
`401`	Missing, expired or invalid bearer token.
`403`	Authenticated, but your role or organization does not allow this action.
`404`	The record does not exist or is not in your organization.
`429`	Too many requests for this endpoint from your IP. Wait `Retry-After` seconds.