Promos

Active promo codes with the price after the code

Registrar-wide codes (tld = null) are priced on .com as an example; priceTld says which TLD the prices are for.

get/api/v1/promos

Request

  • Base URL: https://www.tlders.com
  • URL: https://www.tlders.com/api/v1/promos
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

registrarsstring
Example:namecheap,spaceship

Comma-separated registrar slugs

tldsstring
Example:com,io

Comma-separated TLDs; registrar-wide codes always match

type'register' | 'renew' | 'transfer'

Only codes for register, renew or transfer

verifiedboolean

Only codes we have verified recently

limitinteger

Maximum number of results to return

offsetinteger

Number of results to skip, for paging

Response

OK

Example response

{
  "data": [
    {
      "code": "COM67",
      "discountLabel": "$3.60 with code",
      "tld": "com",
      "regularPrice": 10.28,
      "priceAfterCode": 3.6,
      "savingPercent": 65
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.