REST Assured
Java DSL for API testing. The standard choice in Java/Spring Boot projects with fluent syntax and seamless JUnit integration.
Overview
REST Assured is a Java domain-specific language (DSL) for testing REST APIs. Created by Johan Haleby in 2010 and now maintained by an active open-source community, it transforms verbose Java HTTP client code into readable, fluent assertions. A simple GET request with validation becomes a one-liner: given().when().get("/users").then().statusCode(200).body("name", equalTo("Alice"));
REST Assured is the de facto standard for API testing in Java projects. It integrates natively with JUnit, TestNG, Maven, and Gradle, making it a natural fit for Spring Boot microservices.
What it's used for
REST Assured is the right choice when:
- Java/Spring Boot stack: Your team already writes Java — REST Assured fits naturally.
- API tests should live in version control: Tests are Java code, reviewed in PRs, and executed in CI like any other test.
- Complex JSON/XML validation needed: Hamcrest matchers, JSONPath, and XPath support enable sophisticated assertions.
- Authentication flows: Built-in support for OAuth 2.0, basic auth, digest auth, and custom auth schemes.
Pros & Cons
Pros
- Fluent, readable syntax that makes Java feel like a scripting language
- Deep JSON/XML validation with Hamcrest, JSONPath, and XPath
- Native integration with JUnit, TestNG, Maven, and Gradle
- Supports OAuth, basic auth, and custom authentication
- Free and open source (Apache 2.0)
Cons
- Java only — not useful for JavaScript, Python, or C# teams
- Requires Java knowledge, creating a barrier for non-technical testers
- No GUI — everything is code
- Less intuitive for quick exploratory API testing than Postman
- Community is smaller than Postman's
Platforms & Integrations
REST Assured runs anywhere Java runs (Windows, macOS, Linux). It integrates with any JVM-based build tool and test framework.
Pricing
| Tier | Cost | Includes |
|---|---|---|
| Open Source | Free | Full library, all features, community support |
NZ Context
REST Assured is standard in NZ enterprise Java shops. Banks (ANZ, ASB), government agencies (IRD, ACC), and telcos (Spark, Vodafone NZ) frequently use REST Assured for microservices testing. NZ Java developer job postings almost always list REST Assured or similar API testing experience. For NZ teams on the Microsoft stack, REST Assured is irrelevant — they use RestSharp or HttpClient instead.
Alternatives
- Postman + Newman — GUI-first approach. Better for mixed teams and quick debugging.
- Karate — BDD-style API testing with built-in mocks and performance testing.
- HTTP Client (IntelliJ) — Lightweight IDE-integrated requests for quick testing.