---
url: /docs/5.x/reference/commands/validate.md
description: >-
  The validate command checks that a Swagger/OpenAPI document is valid without
  running the full pipeline.
---

# `kubb validate`

Run `kubb validate` to check that a Swagger/OpenAPI document is valid without running the pipeline. Use it to catch errors early in CI or before you commit a spec change.

```terminal
command: kubb validate ./petStore.yaml
output:
  - ✅ Validation success
```

## Usage

Validate a local OpenAPI file:

```shell [Terminal]
kubb validate ./petStore.yaml
```

Validate a remote document:

```shell [Terminal]
kubb validate https://petstore3.swagger.io/api/v3/openapi.json
```

## Arguments

| Argument  | Required | Description                                              |
| --------- | -------- | -------------------------------------------------------- |
| `<input>` | `true`   | Path or URL to the Swagger/OpenAPI document to validate. |

> \[!TIP]
> `kubb validate` exits with a non-zero status code when the spec is invalid. Use it as a pre-commit hook or CI step to fail the build.

## See also

* [Adapters](/adapters): OAS adapter that parses the validated spec
* [Basic usage](/docs/5.x/getting-started/basic-usage): end-to-end walkthrough