# search-status (/docs/api/endpoints/search-status)



`POST /api/v1/search-status`

Poll a search. Returns results once `status` is `completed`.

**Request**

```json
{ "searchId": "k1709..." }
```

**Response**

```json
{
  "status": "completed",
  "results": [
    {
      "email": "jane@acme.com",
      "name": "Jane Doe",
      "title": "Chief Executive Officer",
      "score": 95,
      "source": "verified"
    }
  ],
  "creditsUsed": 0
}
```

`status` progresses through `pending` → `searching` → `validating` → `completed` or `failed`.

Prefer push over poll? See [Webhooks](/docs/api/webhooks).