Apply bulk margin

POST

/tld-pricing/margin

Apply a margin percentage across all TLDs.

Request

Authorization

API Key

Add parameter in header

rs-x-api-key

Example:

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

Body Params application/json

Examples

Responses

🟢200

application/json

Bulk margin applied

Bodyapplication/json

🟠401

🟠403

Request Example

Shell

JavaScript

Java

Swift

curl --location '/tld-pricing/margin' \
--header 'rs-x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "marginPercentage": 22.5
}'

Response Example

{
    "status": 200,
    "message": "Bulk margin applied",
    "data": [
        {
            "tld": "com",
            "cost": 16.96,
            "renewCost": 16.96,
            "transferCost": 14.13,
            "costRegistrar": null,
            "costAsOf": null,
            "srp": 20.35,
            "marginPercentage": "20.00",
            "defaultMarginPercentage": "20.00",
            "isOverridden": false,
            "marginOverridePercentage": null,
            "marginOverrideEnabled": true,
            "roundOffEnding": null,
            "promoPrice": null,
            "promoExpiresAt": null,
            "promoLabel": null,
            "featuredOnStorefront": false,
            "sortOrder": null,
            "sponsoredPayoutPerRegistration": null,
            "fixedRetailPrice": null,
            "fixedRenewalPrice": null,
            "category": "popular",
            "trend": "rising"
        },
        {
            "tld": "io",
            "cost": 32.98,
            "renewCost": 32.98,
            "transferCost": 32.98,
            "costRegistrar": null,
            "costAsOf": null,
            "srp": 41.23,
            "marginPercentage": "25.00",
            "defaultMarginPercentage": "20.00",
            "isOverridden": true,
            "marginOverridePercentage": 25,
            "marginOverrideEnabled": true,
            "roundOffEnding": 0.99,
            "promoPrice": 29.99,
            "promoExpiresAt": "2026-09-30T00:00:00.000Z",
            "promoLabel": "Labor Day Sale",
            "featuredOnStorefront": true,
            "sortOrder": 1,
            "sponsoredPayoutPerRegistration": null,
            "fixedRetailPrice": null,
            "fixedRenewalPrice": null,
            "category": "tech",
            "trend": "stable"
        }
    ]
}

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

Set TLD featured

Reorder TLD pricing