---
title: "Get Investigation Readiness"
method: GET
path: "/organization/investigation-readiness"
tags: ["investigation-readiness"]
---

# Get Investigation Readiness

`GET /organization/investigation-readiness`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/organization/investigation-readiness`
- Auth: none declared

Whether the caller's organization may start investigations. Writes nothing.

Answered by the same check that gates a start, so a client showing this can never
disagree with the refusal it would get. The organization comes from the caller's
credentials, not the request.

## Response `200`

Successful Response

- InvestigationReadinessResponse: What the caller's organization is missing before it may start investigations.
  - `unmet_requirements` UnmetRequirement[], required: Every unmet requirement; empty means investigations may start.
    - `requirement` 'logs' | 'metrics' | 'code', required: A kind of data an investigation needs before it can start.
    - `code` 'LOGS_INTEGRATION_MISSING' | 'LOGS_DATASET_MISSING' | 'LOGS_LABEL_VALUES_NOT_READY' | 'METRICS_INTEGRATION_MISSING' | 'METRICS_DATASET_MISSING' | 'CODE_INTEGRATION_MISSING' | 'CODE_DATASET_MISSING', required: Stable, additive codes naming the first step a requirement failed at.
    - `reason` 'no_tjc_instance' | 'never_succeeded', required: Why an integration's label-values job has not succeeded yet.
    - `message` string, required
    - `accepted_integration_types` IntegrationType[], required

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-10-06** `31e1a8b7cf89`: 1 warning
  - added the new `azure` enum value to the `unmet_requirements/items/accepted_integration_types/items/` response property for the response status `200`
- **2026-09-30** `4fa2a4911e01`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/organization/investigation-readiness/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)