---
title: "Gets analysis request information"
method: GET
path: "/api/v2/analysis"
tags: ["Datapipe", "Community", "Enterprise"]
---

# Gets analysis request information

`GET /api/v2/analysis`

Returns the current analysis request information. Always returns 200 OK with
the request details. When no request is pending, returns a zero-valued response
with empty strings, false booleans, null arrays, and zero timestamp.

## Response `200`

OK. Returns analysis request details if one exists, or a zero-valued
response if no request is pending (requested_by and request_type will be
empty strings, requested_at will be "0001-01-01T00:00:00Z", booleans will
be false, and arrays will be null).

- object
  - `data` object
    - `requested_by` string
    - `request_type` string
    - `requested_at` string, date-time
    - `delete_all_graph` boolean
    - `delete_sourceless_graph` boolean
    - `delete_source_kinds` string[]
    - `delete_relationships` string[]

## Other responses

- `401` — **Unauthorized** This endpoint failed an authentication requirement. Either the client tried to access a protected endpoint without being authenticated, or an auth validation failed (ex- invalid credentials or expired token).
- `403` — **Forbidden** This is most commonly caused by an authenticated client trying to access a resource that it does not have permission for.
- `429` — **Too Many Requests** The client has sent too many requests within a certain time window and tripped the rate limiting middleware.
- `500` — **Internal Server Error** This is usually the result of either an unexpected database or application error. The client may try modifying or resending the request, but the error is likely not related to the client doing something wrong.

---

[API](https://skmtc.net/specterops/apis/bloodhound-api.md) · [All operations](https://skmtc.net/specterops/apis/bloodhound-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/specterops/bloodhound-api/revisions/b7bbf50b77e7/schema)