---
title: "Inspect stub matching decision path"
method: POST
path: "/stubs/inspect"
tags: ["stubs"]
---

# Inspect stub matching decision path

`POST /stubs/inspect`

Returns detailed matching stages/candidates for a query without consuming stub times.

## Request body

- InspectRequest
  - `id` string, uuid
  - `service` string, required
  - `method` string, required
  - `session` string
  - `headers` object
  - `input` object[]

## Response `200`

Successful operation

- InspectReport
  - `service` string, required
  - `method` string, required
  - `session` string, required
  - `matchedStubId` string, required
  - `similarStubId` string, required
  - `fallbackToMethod` boolean, required
  - `error` string, required
  - `stages` InspectStage[], required
    - `name` string, required
    - `before` integer, required
    - `after` integer, required
    - `removed` integer, required
  - `candidates` InspectCandidate[], required
    - `id` string, required
    - `service` string, required
    - `method` string, required
    - `session` string, required
    - `priority` integer, required
    - `times` integer, required
    - `used` integer, required
    - `specificity` integer, required
    - `score` number, double, required
    - `visibleBySession` boolean, required
    - `withinTimes` boolean, required
    - `headersMatched` boolean, required
    - `inputMatched` boolean, required
    - `matched` boolean, required
    - `excludedBy` string[], required
    - `events` InspectCandidateEvent[], required
      - `stage` string, required
      - `result` string, required
      - `reason` string

## Other responses

- `400` — Invalid inspect criteria
- `422` — Validation error
- `500` — Internal Server Error

---

[API](https://skmtc.net/bavix/apis/gripmock-api-schema.md) · [All operations](https://skmtc.net/bavix/apis/gripmock-api-schema/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bavix/gripmock-api-schema/versions/b6e2357aa9c3/schema)