---
title: graphSearchJob query | Wartiva GraphQL API
description: Retrieves a graph search job started by graphSearch: its state (RUNNING, DONE, FAILED, USER_CANCEL, SYSTEM_INTERRUPT, or EXPIRED), result count, timing.
url: https://wartiva.com/api-docs/queries/graph-search-job.html
updated: 2026-10-07
---

Graph search · GraphQL query

# `graphSearchJob` query

Retrieves a graph search job started by [graphSearch](https://wartiva.com/api-docs/queries/graph-search.html): its state (RUNNING, DONE, FAILED, USER_CANCEL, SYSTEM_INTERRUPT, or EXPIRED), result count, timing, and any errors it recorded. Poll it until the state leaves RUNNING, then read rows with [graphSearchResults](https://wartiva.com/api-docs/queries/graph-search-results.html). Any member of the job's organization can read it.

## Response

Returns a [`GraphSearchJobPayload!`](https://wartiva.com/api-docs/types/graph-search-job-payload.html)

## Arguments

| Name | Description |
|---|---|
| `input` - [`GraphSearchJobInput!`](https://wartiva.com/api-docs/types/graph-search-job-input.html) | Identifies the search job to load. |

## Example

### Query

```graphql
query graphSearchJob($input: GraphSearchJobInput!) {
  graphSearchJob(input: $input) {
    searchJob {
      id
      orgId
      requestedInput {
        ...GraphSearchInputPayloadFragment
      }
      effectiveInput {
        ...GraphSearchInputPayloadFragment
      }
      hash
      user {
        ...UserFragment
      }
      state
      errors
      resultsCount
      hasResults
      startedAt
      endedAt
      running
      duration
      updatedAt
      accessedAt
      winningTrace {
        ...SearchTraceStageFragment
      }
      unselectedTraces {
        ...SearchTraceStageFragment
      }
    }
  }
}

```

### Variables

```json
{"input": GraphSearchJobInput}

```

### Response

```json
{
  "data": {
    "graphSearchJob": {"searchJob": GraphSearchJob}
  }
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt