Check Renewal Status

GET

https://api.inboxkit.com/v1/api/domains/renewals/status

Maintainer:Not configured

Returns renewal status for purchased domains owned by the authenticated team. Supports filtering by domain names, domain UIDs, and renewal status. Use this to check whether a domain has been renewed, is processing, eligible for renewal, or failed.

The renewal_status field uses a simplified 7-value public enum (not_eligible, due_soon, overdue, expired, processing, completed, failed). Internal operational states and vendor terminology are abstracted away.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Responses

🟢200Success

application/json

Renewal status retrieved successfully.

Body

🟠400Bad Request

🟠401Unauthorized

🔴502Bad Gateway

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.inboxkit.com/v1/api/domains/renewals/status?domains=example.com,mydomain.io&uids=abc-123,def-456&status=due_soon&page=1&limit=50' \
--header 'X-Workspace-Id: 9c8f0ef8-68f7-48c9-afdf-cb2e151c343f' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "error": false,
    "data": {
        "renewals": [
            {
                "uid": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
                "domain_name": "example.com",
                "tld": "com",
                "renewal_status": "due_soon",
                "renewal_date": "2026-05-15T00:00:00.000Z",
                "days_until_renewal": 25,
                "grace_period_days_remaining": null,
                "is_eligible_for_renewal": true,
                "eligibility_reason": "Purchased domain, Due in 25 days, 3 active mailbox(es)",
                "renewal_requested": false,
                "renewal_requested_at": null,
                "renewal_price": 15,
                "active_mailboxes": 3,
                "total_mailboxes": 5,
                "registration_date": "2025-05-15T00:00:00.000Z",
                "connection_type": "purchased"
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 50,
            "total": 12,
            "totalPages": 1
        },
        "summary": {
            "total": 12,
            "total_eligible": 3,
            "total_due_soon": 2,
            "total_overdue": 1,
            "total_already_requested": 1
        }
    }
}

Modified at 2026-04-10 13:24:33

Request Domain Renewal

Connect Cloudflare Domains