# Search (/sourcing/reference/objects/search)

A search: one conversation with Kith about one role, holding its brief, the people Kith found and the decisions on them. A search belongs to the whole workspace.

```graphql
type Search {
  archiveVersion: Int!
  archivedAt: DateTime
  briefRevision: Int!
  candidateCount: Int!
  client: SearchClient
  company: String!
  depth: SearchDepth
  id: ID!
  lastMessage: String!
  lastMessageAt: DateTime
  location: String!
  origin: SearchOrigin
  peopleToReview: Int!
  seenVersion: Int!
  status: SearchStatus!
  title: String!
  updatedAt: DateTime!
}
```

### Fields [#fields]

#### [`Search.archiveVersion`](#archive-version) · [`Int!`](/sourcing/reference/scalars/int) `non-null` `scalar` [#archive-version]
Increases each time the search is archived or restored, so a caller holding two answers can tell which is newer.

#### [`Search.archivedAt`](#archived-at) · [`DateTime`](/sourcing/reference/scalars/date-time) `scalar` [#archived-at]
When the workspace archived the search. Null for one it has not. Archiving hides a search from everyday lists and changes nothing else about it.

#### [`Search.briefRevision`](#brief-revision) · [`Int!`](/sourcing/reference/scalars/int) `non-null` `scalar` [#brief-revision]
The number of the brief's current revision. 0 until Kith has read the brief.

#### [`Search.candidateCount`](#candidate-count) · [`Int!`](/sourcing/reference/scalars/int) `non-null` `scalar` [#candidate-count]
How many people Kith has delivered in the search so far.

#### [`Search.client`](#client) · [`SearchClient`](/sourcing/reference/objects/search-client) `object` [#client]
The client the search is for, when one is set.

#### [`Search.company`](#company) · [`String!`](/sourcing/reference/scalars/string) `non-null` `scalar` [#company]
The hiring company, as the brief names it.

#### [`Search.depth`](#depth) · [`SearchDepth`](/sourcing/reference/enums/search-depth) `enum` [#depth]
How deep the search goes.

#### [`Search.id`](#id) · [`ID!`](/sourcing/reference/scalars/id) `non-null` `scalar` [#id]
The search's id, as in its URL in the app.

#### [`Search.lastMessage`](#last-message) · [`String!`](/sourcing/reference/scalars/string) `non-null` `scalar` [#last-message]
The text of the latest message in the search.

#### [`Search.lastMessageAt`](#last-message-at) · [`DateTime`](/sourcing/reference/scalars/date-time) `scalar` [#last-message-at]
When the latest message was sent. Searches are listed by it, newest first.

#### [`Search.location`](#location) · [`String!`](/sourcing/reference/scalars/string) `non-null` `scalar` [#location]
Where the role is based, as the brief says it.

#### [`Search.origin`](#origin) · [`SearchOrigin`](/sourcing/reference/objects/search-origin) `object` [#origin]
The site the search was opened from. Null for a search opened in Kith.

#### [`Search.peopleToReview`](#people-to-review) · [`Int!`](/sourcing/reference/scalars/int) `non-null` `scalar` [#people-to-review]
How many people in the search's delivered shortlists the caller has not seen yet. Counted for each member separately.

#### [`Search.seenVersion`](#seen-version) · [`Int!`](/sourcing/reference/scalars/int) `non-null` `scalar` [#seen-version]
Orders the caller's own marks of what they have seen: the latest mark `peopleToReview` takes in. A count with a lower version was read before a later mark. 0 before any mark.

#### [`Search.status`](#status) · [`SearchStatus!`](/sourcing/reference/enums/search-status) `non-null` `enum` [#status]
Where the search stands.

#### [`Search.title`](#title) · [`String!`](/sourcing/reference/scalars/string) `non-null` `scalar` [#title]
The search's name: the role and company once Kith has read the brief, a working title before.

#### [`Search.updatedAt`](#updated-at) · [`DateTime!`](/sourcing/reference/scalars/date-time) `non-null` `scalar` [#updated-at]
When anything about the search last changed.

### Member Of [#member-of]

[`SearchEdge`](/sourcing/reference/objects/search-edge)  `object`