This sample demonstrates the Http REST capabilities in Citrus where Citrus calls REST API on a todo web application. REST features are also described in detail in reference guide


The todo-list sample application provides a REST API for managing todo entries. Citrus is able to call the API methods as a client in order to validate the Http response messages.

We need a Http client component in the configuration:

public HttpClient todoClient() {
    return CitrusEndpoints.http()

In test cases we can reference this client component in order to send REST calls to the server.


As you can see we are able to send x-www-form-urlencoded message content as POST request. The response is then validated as Http 200 OK.



You can run the sample on your localhost in order to see Citrus in action. Read the instructions how to run the sample.