Domain Renewal Status

Developing

GET

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

Maintainer:Not configured

Returns renewal status for purchased domains owned by the authenticated team. Optionally filter by domain names, UIDs, or renewal status.

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

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Example 1

{
    "error": false,
    "data": {
        "renewals": [
            {
                "uid": "string",
                "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-08 14:15:56

Domain Renewal

Connect Cloudflare Domains