# apiaryio/dredd

Language-agnostic HTTP API Testing Tool

Repository: https://github.com/apiaryio/dredd
Canonical: https://ross.abutalabs.com/products/dredd
Homepage: https://dredd.org
Language: JavaScript
License: MIT
License Family: permissive
Topics: api-blueprint, dredd, swagger, api, testing, http, tests, openapi, openapi-validation, validation, sjs-team, test-runner, unit-testing, integration-testing, testing-framework, test-framework, cli-app, openapi2, openapi3
Archived: true
Last push: 2024-05-11T13:19:25+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 4746, "days_push": 844, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4222, forks 276 (observed 2026-08-28T04:08:39.308656+00:00)

## What it is
Dredd is a language-agnostic command-line tool that validates an API's backend implementation against its API description document (API Blueprint, OpenAPI 2/Swagger, or experimental OpenAPI 3). It executes requests step by step and checks that responses match the documented specification, with hooks support in multiple languages.

## Use cases
- validate my API implementation against its OpenAPI spec
- contract-test a REST API from the command line
- run API documentation tests in CI
- check that API responses match Swagger definitions
- test an HTTP API described in API Blueprint
- add setup and teardown hooks to API tests in Python or Ruby

## When to choose
- you have an API Blueprint or OpenAPI 2 document and want spec-conformance testing
- you want a language-agnostic test runner driven by your API docs
- you need CI-friendly API validation across Linux, macOS, and Windows

## When to avoid
- you need first-class OpenAPI 3 support (still experimental)
- you want unit tests for business logic rather than spec validation
- your API is GraphQL or non-HTTP

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: testing, e2e-testing, cli, http-client, api-framework
- domain: testing, apis, developer-tools, web-development, documentation
- platform: cli, windows, cross-platform
- tags: api-testing, openapi, swagger, api-blueprint, contract-testing, test-runner, hooks, ci-cd, nodejs, linux, macos

## Member repositories
- apiaryio/dredd (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:39.308656+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:22:23.527570+00:00, confidence not recorded.
  - readme: https://github.com/apiaryio/dredd (fetched 2026-08-28T04:08:39.308656+00:00, sha 65f912d07cca)
- Data as of 2026-08-30T08:39:29.467469+00:00.