> For the complete documentation index, see [llms.txt](https://docs.does.qa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.does.qa/test-steps/check/check-json-value.md).

# Check JSON Value

Check JSON Value reads a [Value](/values/value-store.md) that holds JSON and compares part of it against what you expect. Use it after API or data steps that store a response body.

![Check JSON Value Test Step](https://app.does.qa/screenshots/node/check_json_value.png)

## When to use it

* Confirm a field in an API response matches the expected string or number.
* Verify nested JSON from a previous step without writing custom parsing logic.
* Pair with [Check JSON Schema](/test-steps/check/check-json-schema.md) when the shape of the JSON matters too.

## Configure

### Basics

| Field                | What to set                                                  |
| -------------------- | ------------------------------------------------------------ |
| **Input Item**       | [Value](/values/value-store.md) that holds the JSON to check |
| **Match Mode**       | `Equals` (default) or `Contains`                             |
| **Value Type**       | `Custom` (default) or `Value Store`                          |
| **Value Store Item** | Value to compare against when Value Type is `Value Store`    |
| **Custom JSON**      | JSON fragment to compare against when Value Type is `Custom` |

### Advanced

| Field                                 | What to set                                                          |
| ------------------------------------- | -------------------------------------------------------------------- |
| **Status on fail**                    | [Failed Status](/test-step-options/failed-status.md)                 |
| **When should screenshots be taken?** | `Always` or `On Failures` (default)                                  |
| **Value Standardization**             | [Value Standardization](/test-step-options/value-standardization.md) |

## Related

* [Check JSON Schema](/test-steps/check/check-json-schema.md)
* [Value Store](/values/value-store.md)
* [Check](/test-steps/check.md)

**Tags:** `check`, `json`, `value`, `test`, `expect`, `assert`