OSS Tanbou

test REST APIs from Java with a DSL for requests, status, headers, and JSON/XML assertions

About these scores

OSS scale score is an unbounded metric that log-compresses and weights Stars, Watchers, Forks, and Contributors. Discovery score is the current OSS scale score minus the score at discovery. Update pace is commits in the last 30 days, growth momentum is the OSS scale score difference within the recent observation window, and OSS health is a 0–100 rating based on available recency, Community Health, and release data.

Stars
7,141
Primary language
Java
License
Apache-2.0
Repository last updated
Jul 22, 2026
On this page

Overview

REST Assured is a Java DSL for testing and validating REST services. Its given / when / then flow combines request setup, HTTP execution, and response assertions, including JSONPath, XmlPath, authentication, headers, cookies, and body validation.

Features and best fit

Based on official documentation; not hands-on tested · Content checked:

Key features

Express request setup and response assertions in one DSL

Tests can specify parameters, headers, cookies, bodies, and authentication, execute common HTTP methods, and then validate status codes or response content.

Sources: [2]

Validate JSON and XML through path expressions and Hamcrest matchers

JSONPath and XmlPath can select values from responses, while matchers such as equalTo and hasItems express API contract and business assertions.

Sources: [2]

Best fit

Fits Java and Kotlin API integration tests and HTTP-focused end-to-end checks

It is useful when a test suite needs to call real REST endpoints and keep request/response expectations readable. Separate modules support Spring-oriented testing scenarios.

Sources: [2][3]

Before adoption

REST Assured 6.x uses Java 17 as its baseline

The README states that 6.0.0 raised the baseline to Java 17+, and current documentation links target 6.0.1. Older JDK environments need an upgrade or an older supported line.

Sources: [2][3]

Align Spring and Jackson generations with the selected modules

Version 6.0.1 targets Spring 7 in its Spring modules and expands Jackson 3 support, so applications should verify framework-generation compatibility before upgrading.

Sources: [2]

Official sources

  1. [1]rest-assured/rest-assured repository(2026-09-30)
  2. [2]REST Assured README(2026-09-30)
  3. [3]REST Assured parent POM(2026-09-30)
  4. [4]REST Assured Apache-2.0 license(2026-09-30)
Supplemental curator note

The DSL keeps HTTP requests and response assertions readable in Java API integration tests. Version 6.x raises the runtime baseline and framework generations, so validate JDK, Spring, and Jackson compatibility before upgrading.

Try it in 3 steps

  1. 1

    Add REST Assured 6.0.1 as a test dependency

    Add the dependency to a Maven pom.xml with test scope. REST Assured 6.x requires Java 17 or newer.

    <dependency><groupId>io.rest-assured</groupId><artifactId>rest-assured</artifactId><version>6.0.1</version><scope>test</scope></dependency>
  2. 2

    Add the DSL static imports

    Make the request DSL and Hamcrest matchers directly available in the test class.

    import static io.restassured.RestAssured.*; import static org.hamcrest.Matchers.*;
  3. 3

    Validate a GET response

    Follow the README example to call an endpoint and assert a JSON body value. Replace the path and expected value with the target test service.

    get("/lotto").then().assertThat().body("lotto.lottoId", equalTo(5));
Check the official README

Growth

Growth trends · Last 30 days

7,141 Stars

Trend data is still being collected.

Development activity

Last 90 days · weekly

Commits (last 30 days)
0
Open PRs
29

Development activity is still being collected.

Built with

Categories and tags

GitHub data

GitHub dataView detailed GitHub data

GitHub Topics

  • rest
  • rest-api
  • java
  • groovy
  • test-automation
  • test
  • json
  • xml
  • http
  • kotlin
Stars
7,141
Forks
1,943
Watchers
324
Open issues
568
Contributors
159
Owner type
Organization
Primary language
Java
License
Apache-2.0
Repository last updated
Jul 22, 2026
Write a related article

Share a guide or use case for this OSS in Markdown. Articles are published after administrator approval.

Report incorrect information

Tell us if any listing information is incorrect or outdated.

After reading this page, do you know what to do next?