---
raw: true
search:
  tags:
    - Domains
    - POST
seo:
  description: >-
    Find domain names with the dashboard's search workflow. A single keyword
    returns… Reference for the POST /v1/domains/search endpoint in the Spacefast
    API.
sidebar:
  label: Search domain names with the operator in a conversation
  badge: POST
title: Search domain names with the operator in a conversation
type: openapi-operation
---
Find domain names with the dashboard's search workflow. A single keyword returns exact domain matches and domain hacks. A naming brief generates suggestions. Each search checks availability and Jev scores. The workflow replaces unavailable generated names. Refine the search with messages, likes, dislikes and selections. Carry the returned session unchanged into the next call. Use stable suggestion IDs for feedback. Display prices include the same fees as the dashboard. If complete is false, inspect problems. To resume, send the returned session without a new message. Confirm availability again before registration.

`POST /v1/domains/search`

**Request body** (`application/json`, required)

- `analytics` (object)
- `teamId` (string)
- `message` (string) — The operator's naming brief or follow-up. Omit to apply feedback or resume incomplete work.
- `session` (object) — Carry the complete returned session unchanged between turns.
- `feedback` (object[])

Request body example:

```json
{
  "analytics": {
    "sessionId": "f6567dd8-e069-418e-8893-7d22fcf12459",
    "traceId": "729bb1bf-882d-483b-89d3-5855dc5af3aa",
    "anonymousId": "string",
    "path": "string"
  },
  "teamId": "string",
  "message": "string",
  "session": {
    "version": 1,
    "teamId": "string",
    "intent": "conversation",
    "messages": [
      {
        "role": "user",
        "content": "string",
        "local": true,
        "kind": "feedback"
      }
    ],
    "suggestions": [
      {
        "domain": "string",
        "reason": "string",
        "score": 0,
        "id": "string",
        "number": 1,
        "selected": true,
        "taste": "neutral",
        "availability": "unchecked",
        "sellable": true,
        "jev": {
          "score": 0,
          "confidence": 0
        },
        "retired": true,
        "source": "instant",
        "hideDescription": true,
        "checkedAt": "2019-08-24T14:15:22Z",
        "availabilitySource": "dsapi",
        "availabilityMode": "zone",
        "price": {
          "amount": 0,
          "formatted": "string",
          "currency": "string"
        },
        "ranking": "pending"
      }
    ],
    "pending": {
      "body": {
        "teamId": "string",
        "phase": "initial",
        "automatic": true,
        "poolPolicy": "ranked-available",
        "messages": [
          {
            "role": "user",
            "content": "string"
          }
        ],
        "suggestions": [
          {
            "domain": "string",
            "reason": "string",
            "score": 0,
            "id": "string",
            "number": 1,
            "selected": true,
            "taste": "neutral",
            "availability": "unchecked",
            "sellable": true,
            "jev": {
              "score": 0,
              "confidence": 0
            },
            "retired": true,
            "source": "instant",
            "hideDescription": true
          }
        ]
      },
      "acceptedIds": [
        "string"
      ],
      "baselineIds": [
        "string"
      ],
      "slots": [
        "string"
      ]
    },
    "replacement": {
      "body": {
        "teamId": "string",
        "phase": "initial",
        "automatic": true,
        "poolPolicy": "ranked-available",
        "messages": [
          {
            "role": "user",
            "content": "string"
          }
        ],
        "suggestions": [
          {
            "domain": "string",
            "reason": "string",
            "score": 0,
            "id": "string",
            "number": 1,
            "selected": true,
            "taste": "neutral",
            "availability": "unchecked",
            "sellable": true,
            "jev": {
              "score": 0,
              "confidence": 0
            },
            "retired": true,
            "source": "instant",
            "hideDescription": true
          }
        ]
      },
      "acceptedIds": [
        "string"
      ],
      "baselineIds": [
        "string"
      ],
      "slots": [
        "string"
      ]
    }
  },
  "feedback": [
    {
      "id": "string",
      "taste": "neutral",
      "selected": true
    }
  ]
}
```

**Responses**

- `200` — Response for status 200
- `default` — Problem details (RFC 9457). Any 4xx/5xx response is one \`application/problem+json\` document.

Response example, 200:

```json
{
  "$schema": "http://example.com",
  "data": {
    "intent": "conversation",
    "message": "string",
    "session": {
      "version": 1,
      "teamId": "string",
      "intent": "conversation",
      "messages": [
        {
          "role": "user",
          "content": "string",
          "local": true,
          "kind": "feedback"
        }
      ],
      "suggestions": [
        {
          "domain": "string",
          "reason": "string",
          "score": 0,
          "id": "string",
          "number": 1,
          "selected": true,
          "taste": "neutral",
          "availability": "unchecked",
          "sellable": true,
          "jev": {
            "score": 0,
            "confidence": 0
          },
          "retired": true,
          "source": "instant",
          "hideDescription": true,
          "checkedAt": "2019-08-24T14:15:22Z",
          "availabilitySource": "dsapi",
          "availabilityMode": "zone",
          "price": {
            "amount": 0,
            "formatted": "string",
            "currency": "string"
          },
          "ranking": "pending"
        }
      ],
      "pending": {
        "body": {
          "teamId": "string",
          "phase": "initial",
          "automatic": true,
          "poolPolicy": "ranked-available",
          "messages": [
            {
              "role": "user",
              "content": "string"
            }
          ],
          "suggestions": [
            {
              "domain": "string",
              "reason": "string",
              "score": 0,
              "id": "string",
              "number": 1,
              "selected": true,
              "taste": "neutral",
              "availability": "unchecked",
              "sellable": true,
              "jev": {
                "score": 0,
                "confidence": 0
              },
              "retired": true,
              "source": "instant",
              "hideDescription": true
            }
          ]
        },
        "acceptedIds": [
          "string"
        ],
        "baselineIds": [
          "string"
        ],
        "slots": [
          "string"
        ]
      },
      "replacement": {
        "body": {
          "teamId": "string",
          "phase": "initial",
          "automatic": true,
          "poolPolicy": "ranked-available",
          "messages": [
            {
              "role": "user",
              "content": "string"
            }
          ],
          "suggestions": [
            {
              "domain": "string",
              "reason": "string",
              "score": 0,
              "id": "string",
              "number": 1,
              "selected": true,
              "taste": "neutral",
              "availability": "unchecked",
              "sellable": true,
              "jev": {
                "score": 0,
                "confidence": 0
              },
              "retired": true,
              "source": "instant",
              "hideDescription": true
            }
          ]
        },
        "acceptedIds": [
          "string"
        ],
        "baselineIds": [
          "string"
        ],
        "slots": [
          "string"
        ]
      }
    },
    "suggestions": [
      {
        "domain": "string",
        "reason": "string",
        "score": 0,
        "id": "string",
        "number": 1,
        "selected": true,
        "taste": "neutral",
        "availability": "unchecked",
        "sellable": true,
        "jev": {
          "score": 0,
          "confidence": 0
        },
        "retired": true,
        "source": "instant",
        "hideDescription": true,
        "checkedAt": "2019-08-24T14:15:22Z",
        "availabilitySource": "dsapi",
        "availabilityMode": "zone",
        "price": {
          "amount": 0,
          "formatted": "string",
          "currency": "string"
        },
        "ranking": "pending",
        "reference": 1,
        "displayPrice": {
          "amount": 0,
          "formatted": "string",
          "currency": "string"
        }
      }
    ],
    "topPick": "string",
    "complete": true,
    "problems": [
      {
        "stage": "intent",
        "code": "string",
        "message": "string",
        "retryAfterSeconds": 0
      }
    ]
  }
}
```