---
title: "Retrieve a Graph Query"
method: GET
path: "/graph-queries/{graph-query-id}"
tags: ["graph"]
---

# Retrieve a Graph Query

`GET /graph-queries/{graph-query-id}`

## Request

- Base URL: `https://api.withpersona.com/api/v1`
- URL: `https://api.withpersona.com/api/v1/graph-queries/{graph-query-id}`
- Auth: HTTP bearer

Retrieve a Graph Query

## Path parameters

- `graph-query-id` string, required

## Query parameters

- `include` string
- `fields` object

## Response `200`

This endpoint returns a Graph Query object.

- GraphRetrieveAGraphQueryResponse200
  - `data` GraphQuery, required: A Graph Query object
    - `type` 'graph-query'
    - `id` string
    - `attributes` GraphQueryAttributes
      - `status` string: Possible values: - submitted - completed - errored - cancelled - timed_out Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update.
      - `params` object: Dynamic query parameters
      - `created-at` string, date-time
      - `updated-at` string, date-time, nullable
      - `errored-at` string, date-time, nullable
      - `completed-at` string, date-time, nullable
      - `redacted-at` string, date-time, nullable: This will be set to the time when the graph query results were redacted. In this case, nodes will also be an empty array.
      - `stats` GraphQueryAttributesStats
      - `explorer-url` string, nullable
      - `node-limit-reached` boolean, nullable
      - `nodes` GraphQueryAttributesNodesItems[]
        - `type` string
        - `value` string
    - `relationships` GraphQueryRelationships
      - `accounts` GraphQueryRelationshipsAccounts
        - `data` GraphQueryRelationshipsAccountsDataItems[]
          - `id` string
          - `type` 'account'
  - `included` unknown[]: Excluded from the response by default. Will be an empty array when the `include` query parameter in the request was explicitly set to empty.
    - unknown

## Other responses

- `400`: The request was unacceptable, often due to invalid parameters.
- `401`: An invalid API key was provided.
- `403`: The given API key doesn’t have permissions to perform the request or a quota has been exceeded.
- `404`: The requested resource doesn’t exist.
- `429`: Your organization’s rate limit has been exceeded. We recommend an exponential backoff on requests.

---

[API](https://skmtc.dev/withpersona/apis/withpersona-6.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-6/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-6/revisions/b2a170061bd9?raw)