Update TLD pricing

PATCH

/tld-pricing/{tld}

Set a per-TLD pricing/margin override.

Request

Authorization

API Key

Add parameter in header

rs-x-api-key

Example:

rs-x-api-key: ********************

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

TLD pricing updated - the single upserted row, not the full book

Bodyapplication/json

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PATCH '/tld-pricing/' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "marginOverridePercentage": -100,
    "marginOverrideEnabled": true,
    "roundOffEnding": 0,
    "promoPrice": 0,
    "promoExpiresAt": "2019-08-24T14:15:22.123Z",
    "promoLabel": "string",
    "fixedRetailPrice": 0,
    "fixedRenewalPrice": 0,
    "featuredOnStorefront": true
}'

Response Example

{
    "status": 200,
    "message": "TLD pricing updated",
    "data": {
        "id": "6f1b6b0a-6e2b-4e0a-9b7a-2f7b0a1c9d3e",
        "partnerId": "3c9a7e10-4b21-4a9f-9d0f-1e2c3b4a5d6f",
        "tld": "io",
        "marginOverridePercentage": 25,
        "marginOverrideEnabled": true,
        "roundOffEnding": 0.99,
        "sortOrder": null,
        "promoPrice": 29.99,
        "promoExpiresAt": "2026-09-30T00:00:00.000Z",
        "promoLabel": "Labor Day Sale",
        "fixedRetailPrice": null,
        "fixedRenewalPrice": null,
        "featuredOnStorefront": true,
        "createdAt": "2026-08-20T10:15:00.000Z",
        "updatedAt": "2026-08-27T09:00:00.000Z",
        "deletedAt": null
    }
}

Modified at 2026-08-28 11:33:21

List TLD pricing

Set TLD featured