---
title: "GET /v1/searches/{id}"
method: GET
path: "/v1/searches/{id}"
tags: ["Search"]
---

# GET /v1/searches/{id}

`GET /v1/searches/{id}`

## Request

- Base URL: `https://usefind.ai/found`
- URL: `https://usefind.ai/found/v1/searches/{id}`
- Auth: API key in header `Authorization`

The endpoint to poll to check the latest results of a search.

## Path parameters

- `id` string, required

## Response `200`

The final response is available and is returned.

- SearchResult[]
  - `criteria_and_reasons` object[]
    - `criteria` string: Match criteria
    - `reason` string: Reason for the match
    - `match` boolean: Whether it's a match
  - `name` string, required
  - `title` string: Returned only for a person.
  - `linkedin_url` string, required
  - `company` string: Returned only for a person.
  - `domain` string: Returned only for a company.

## Other responses

- `202`: We're still processing your initial request.
- `410`: Something went wrong and your request has expired. You won't be billed for expired requests.

## Changes

- **2024-10-08** `f1e4b85be4f9`: 8 breaking, 3 warning, 2 info
  - the `items/company` response's property type changed from `object` to `string` for status `200`
  - removed the required property `items/company/name` from the response with the `200` status
  - removed the required property `items/company/slug` from the response with the `200` status
  - removed the required property `items/company/website` from the response with the `200` status
  - …9 more
- **2024-09-25** `f45934597cf4`: 1 info
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/find-ai/apis/usefind-ai-params-in-body/changes/v1/searches/:id/get.md)

---

[API](https://skmtc.dev/find-ai/apis/usefind-ai-params-in-body.md) - [All operations](https://skmtc.dev/find-ai/apis/usefind-ai-params-in-body/llms.txt) - [OpenAPI document](https://skmtc.dev/find-ai/apis/usefind-ai-params-in-body/revisions/f1e4b85be4f9?raw)
