Renew Clock REST API
Manage renewal items from your own scripts. JSON over HTTPS. API access is on the Business plan.
Authentication
Create a key in Settings. It is shown once; we store only a hash. Send it as a bearer token:
curl -H "Authorization: Bearer rnc_..." https://www.renewclock.com/api/v1/itemsRevoke a key in Settings at any time. Keys act on the account they were created in.
Rate limits
Keep to 60 requests per minute per key. Every response carries X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over the limit you may get 429 with Retry-After; back off and retry.
Endpoints
| Method | Path | What it does |
|---|---|---|
| GET | /api/v1/items | List items. |
| POST | /api/v1/items | Add an item. Body {"name":"City license","type":"license","expiresAt":"2027-01-14","ownerEmail":"ops@example.com"}. Returns 201, 402 over the plan limit. |
| GET | /api/v1/items/{id} | One item. |
| POST | /api/v1/items/{id}/renew | Mark renewed and roll the date forward. |
| DELETE | /api/v1/items/{id} | Remove an item. Returns 204. |
Item object
{
"id": "...", "name": "City license", "type": "license",
"expiresAt": "2027-01-14", "status": "active",
"ownerEmail": "ops@example.com", "archived": false
}Errors
Errors return {"error": "code", "message": "..."} with codes unauthorized, invalid_json, plan_limit, not_found, forbidden_plan and rate_limited.