---
title: "Active promo codes with the price after the code"
method: GET
path: "/api/v1/promos"
tags: ["Promos"]
---

# Active promo codes with the price after the code

`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`

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

## Query parameters

- `registrars` string
- `tlds` string
- `type` 'register' | 'renew' | 'transfer'
- `verified` boolean
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `data` Promo[]
    - `code` string
    - `discountType` 'percentage' | 'fixed' | 'price'
    - `discountValue` number
    - `discountLabel` string
    - `appliesTo` 'register' | 'renew' | 'transfer' | 'all'
    - `usageLimit` integer, nullable: Uses per customer; null = unlimited
    - `isVerified` boolean
    - `lastVerifiedAt` string, date-time, nullable
    - `startsAt` string, date-time, nullable
    - `expiresAt` string, date-time, nullable
    - `registrar` object
      - `name` string
      - `slug` string
      - `logoUrl` string
    - `tld` string, nullable: null = registrar-wide
    - `priceTld` string, nullable: The TLD the prices are for
    - `priceType` 'register' | 'renew' | 'transfer'
    - `regularPrice` number, nullable
    - `priceAfterCode` number, nullable
    - `savingPercent` integer, nullable

## Other responses

- `400`: A required parameter is missing or invalid
- `401`: Missing, invalid or revoked API key
- `402`: Endpoint needs a paid plan (free keys: 100 requests/month, no bulk /prices)
- `429`: Daily request limit exceeded (see Retry-After)

---

[API](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api.md) · [All operations](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api/revisions/d24ebbcf6fd2?raw)