API Reference

# Domain Marketplace

Browse aged, pre-warmed domains and lease them for your account. Each lease comes with pre-warmed mailboxes and renews monthly with your subscription.

## Overview

| Method | Endpoint                                | Description                                 |
| ------ | --------------------------------------- | ------------------------------------------- |
| GET    | /api/marketplace/access                 | Whether the marketplace is available to you |
| GET    | /api/marketplace/domains                | Browse domains for sale                     |
| GET    | /api/marketplace/domains/facets         | TLD counts and lease terms                  |
| GET    | /api/marketplace/domains/:domain        | One domain for sale                         |
| GET    | /api/marketplace/eligibility            | Whether you can lease right now             |
| POST   | /api/marketplace/checkout               | Lease one or more domains, all or nothing   |
| GET    | /api/marketplace/leases                 | Your leases and setup progress              |
| POST   | /api/marketplace/domains/:domain/cancel | Stop a lease renewing                       |
| POST   | /api/marketplace/domains/:domain/resume | Withdraw a scheduled cancellation           |

A typical flow: check `eligibility`, browse, check out, then poll `leases` until each domain is `active`.

Checkout charges the default card on your subscription immediately, prorated to the end of the current billing period. If your bank requires card confirmation (3-D Secure), the charge fails and you will need to confirm the card in the app's Billing page before retrying.

GET`/api/marketplace/access`

## Check Access

Whether the marketplace is available to your account at all. When `visible` is `false`, every other `/marketplace` route returns `404`.

cURL

```bash
curl "https://api.v4.missioninbox.com/api/marketplace/access" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

Response

```json
{
  "visible": true
}
```

GET`/api/marketplace/domains`

## Browse Domains

Paginated list of domains for sale, oldest first by default. `warmedDays` keeps climbing while a domain is listed — warmup only stops once it is leased. Use `GET /api/marketplace/domains/:domain` for a single domain (`404` if it is not for sale), and `GET /api/marketplace/domains/facets` for available TLDs with counts and the current price.

| Query param   | Description                                  |
| ------------- | -------------------------------------------- |
| page, limit   | Pagination                                   |
| search        | Substring match on the domain name           |
| tld           | Top-level domain without the dot, e.g. 'com' |
| minAgeYears   | Only domains at least this many years old    |
| sortBy        | 'age' (default), 'domain' or 'listedAt'      |
| sortDirection | 'asc' or 'desc'                              |

cURL

```bash
curl "https://api.v4.missioninbox.com/api/marketplace/domains?tld=com&minAgeYears=5&sortBy=age&sortDirection=desc&limit=20" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

Response

```json
{
  "data": [
    {
      "domain": "coastsidetech.com",
      "tld": "com",
      "ageYears": 13.4,
      "registeredAt": "2013-05-11T00:00:00.000Z",
      "warmedDays": 34,
      "listedAt": "2026-09-19T10:30:00.000Z",
      "monthlyPriceCents": 8500,
      "includedMailboxes": 5
    }
  ],
  "total": 31,
  "page": 1,
  "limit": 20,
  "totalPages": 2
}
```

GET`/api/marketplace/eligibility`

## Check Eligibility

Whether a lease would be accepted now, how many of your lease slots are used, and what one domain would cost today (`proratedCentsPerDomain`, an estimate — checkout returns the amount actually charged). Pass `requested` to check room for several domains at once. When `eligible` is false, `reason` is one of:

| reason                 | Meaning                                       |
| ---------------------- | --------------------------------------------- |
| purchasing\_disabled   | Leasing is temporarily switched off           |
| wrong\_product         | Leasing is only available on Cold Outreach    |
| no\_subscription       | No subscription to bill the monthly charge to |
| subscription\_inactive | The subscription is not active                |
| subscription\_ending   | The subscription is scheduled to cancel       |
| plan\_not\_eligible    | Your plan does not include domain leasing     |
| sending\_disabled      | Sending is suspended on your account          |
| cap\_reached           | No lease slots left                           |

cURL

```bash
curl "https://api.v4.missioninbox.com/api/marketplace/eligibility?requested=2" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

Response

```json
{
  "eligible": true,
  "activeLeases": 1,
  "leaseCap": 3,
  "remaining": 2,
  "monthlyPriceCents": 8500,
  "includedMailboxes": 5,
  "proratedCentsPerDomain": 3290,
  "periodEndsAt": "2026-11-01T00:00:00.000Z",
  "remainingDays": 12
}
```

POST`/api/marketplace/checkout`

## Checkout

Leases every domain in `domains` in one transaction and charges your card once. To lease a single domain, send a one-item list. **All or nothing:** if any domain is unavailable, nothing is leased or charged and the `409` names each failing domain with a `reason` A `409` with an empty `unavailable` list means the cart does not fit under your lease cap.

| reason          | Meaning                                                                   |
| --------------- | ------------------------------------------------------------------------- |
| not\_listed     | Sold or unlisted since you browsed                                        |
| just\_taken     | Another buyer committed first                                             |
| already\_yours  | You already lease it — usually a repeated request                         |
| payment\_failed | The card was refused; set on every row because it is not about one domain |

Leases come back as `provisioning`: the domains are reserved but not usable yet. Setup takes a few minutes per domain, one at a time. `chargedNowCents` is what was actually charged.

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/marketplace/checkout" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["coastsidetech.com", "harborlinedata.com"]
  }'
```

Response

```json
{
  "purchased": [
    { "domain": "coastsidetech.com",  "leaseId": "c1f0…", "status": "provisioning", "monthlyPriceCents": 8500, "includedMailboxes": 5 },
    { "domain": "harborlinedata.com", "leaseId": "9a42…", "status": "provisioning", "monthlyPriceCents": 8500, "includedMailboxes": 5 }
  ],
  "activeLeases": 3,
  "leaseCap": 3,
  "monthlyCentsTotal": 17000,
  "chargedNowCents": 6580,
  "nextChargeAt": "2026-11-01T00:00:00.000Z"
}
```

409 Response

```json
{
  "statusCode": 409,
  "error": "cart_unavailable",
  "message": "1 of the domains in your cart is no longer available. Nothing was leased.",
  "unavailable": [
    { "domain": "coastsidetech.com", "reason": "just_taken", "message": "coastsidetech.com has just been leased by someone else." }
  ]
}
```

A `503` means the payment could not be confirmed either way. The domains stay reserved while it settles — call `GET /api/marketplace/leases` before retrying, or a retry becomes a second purchase.

GET`/api/marketplace/leases`

## List Leases

Every lease your account holds or has held, newest first. `status` is `provisioning`, `active`, `ending`, `ended` or `failed`; `provisionStage` shows setup progress while provisioning. `needsAttention: true` means setup stopped and our support team will follow up.

cURL

```bash
curl "https://api.v4.missioninbox.com/api/marketplace/leases" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

Response

```json
[
  {
    "domain": "coastsidetech.com",
    "status": "provisioning",
    "provisionStage": "push_dns",
    "needsAttention": false,
    "monthlyPriceCents": 8500,
    "includedMailboxes": 5,
    "purchasedAt": "2026-10-01T10:30:00.000Z",
    "activatedAt": null,
    "endsAt": null,
    "canResume": false,
    "renews": true
  }
]
```

POST`/api/marketplace/domains/:domain/cancel`

POST`/api/marketplace/domains/:domain/resume`

## Cancel or Resume a Lease

`cancel` stops a lease renewing. It is scheduled, never immediate: the domain keeps working until the end of the billing period you have paid for (`endsAt`), and still counts against your lease cap until then. `resume` withdraws the cancellation any time before `endsAt`. A lease ending because your subscription is ending cannot be resumed here (`canResume: false`) — fix the subscription and the lease follows. Both return the updated lease.

cURL

```bash
curl -X POST "https://api.v4.missioninbox.com/api/marketplace/domains/coastsidetech.com/cancel" \
  -H "X-Server-API-Key: miacme_4eC8vKmN2pQrStUwXyZaB6dEfGhIjLoPqRsT9uVwX1b"
```

[PreviousDomain Warmup](https://doc.v4.missioninbox.com/sales/api/domain-warmup.md)[NextEmail](https://doc.v4.missioninbox.com/sales/api/email.md)
