Domain Renewal

POST

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

Maintainer:Not configured

Request renewal for one or more purchased domains. Only domains eligible for renewal (due within 30 days, with active mailboxes) can be renewed.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

🟠400

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.inboxkit.com/v1/api/domains/renewals/request' \
--header 'X-Workspace-Id: ws_abc123...' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "domains": [
        "example.com",
        "mydomain.io"
    ],
    "uids": [
        "ABC-123-DEF-...."
    ]
}'

Response Example

200 - Example 1

{
    "error": false,
    "message": "Renewal request processed: 2 requested, 1 failed",
    "data": {
        "results": [
            {
                "domain_name": "example.com",
                "success": true,
                "reason": "Renewal requested successfully"
            }
        ],
        "total_requested": 2,
        "total_failed": 1
    }
}

Modified at 2026-04-08 13:01:57

Regenerate Domain Nameservers

Domain Renewal Status