Hurl, run and test HTTP requests with plain text.

★ 19,324⑂ 751👁 54⑃ 4,323● 995▤ 32
RustApache-2.0Created 2020-08-25hurl.dev
Download: 8.1.08.1.0 ↓8.1.02026-10-28
+1
Daily
19,324
stars
751
forks
54
watchers
4,323
prs
995
issues
32
releases

README

What's Hurl?

Hurl is a command line tool that runs HTTP requests defined in a simple plain text format.

It can chain requests, capture values and evaluate queries on headers and body response. Hurl is very
versatile: it can be used for both fetching data and testing HTTP sessions.

Hurl makes it easy to work with HTML content, REST / SOAP / GraphQL APIs, or any other XML / JSON based APIs. 

hurl
 Go home and capture token
GET https://example.org
HTTP 200
[Captures]
csrf_token: xpath "string(//meta[@name='_csrf_token']/@content)"


 Do login!
POST https://example.org/login
[Form]
user: toto
password: 1234
token: {{csrf_token}}
HTTP 302


Chaining multiple requests is easy:

hurl
GET https://example.org/api/health
GET https://example.org/api/step1
GET https://example.org/api/step2
GET https://example.org/api/step3


 Also an HTTP Test Tool

Hurl can run HTTP requests but can also be used to test HTTP responses.
Different types of queries and predicates are supported, from [XPath] and [JSONPath] on body response,
to assert on status code and response headers.




It is well adapted for REST / JSON APIs

hurl
POST https://example.org/api/tests
{
    "id": "4568",
    "evaluate": true
}
HTTP 200
[Asserts]
header "X-Frame-Options" == "SAMEORIGIN"
jsonpath "$.status" == "RUNNING"     Check the status code
jsonpath "$.tests" count == 25       Check the number of items
jsonpath "$.id" matches /\d{4}/      Check the format of the id


HTML content

hurl
GET https://example.org
HTTP 200
[Asserts]
xpath "normalize-space(//head/title)" == "Hello world!"


GraphQL 

~~~hurl
POST https://example.org/graphql
graphql
{
  human(id: "1000") {
    name
    height(unit: FOOT)
  }
}

HTTP 200
~~~

and even SOAP APIs

hurl
POST https://example.org/InStock
Content-Type: application/soap+xml; charset=utf-8
SOAPAction: "http://www.w3.org/2003/05/soap-envelope"


  
  
    
      GOOG
    
  

HTTP 200


Hurl can also be used to test the performance of HTTP endpoints

hurl
GET https://example.org/api/v1/pets
HTTP 200
[Asserts]
duration integrate in CI/CD, with text, JUnit, TAP and HTML reports


    
    
    


 Why Hurl?


    Text Format: for both devops and developers
    Fast CLI: a command line for local dev and continuous integration
    Single Binary: easy to install, with no runtime required


 Powered by curl

Hurl is a lightweight binary written in [Rust]. Under the hood, Hurl HTTP engine is
powered by [libcurl], one of the most powerful and reliable file transfer libraries.
With its text file format, Hurl adds syntactic sugar to run and test HTTP requests,
but it's still the [curl] that we love: __fast__, __efficient__ and __IPv6 / HTTP/3 ready__.

 Feedbacks

To support its development, [star Hurl on GitHub]!

[Feedback, suggestion, bugs or improvements] are welcome.

hurl
POST https://hurl.dev/api/feedback
{
  "name": "John Doe",
  "feedback": "Hurl is awesome!"
}
HTTP 200


 Resources

[License]

[Blog]

[Tutorial]

[Documentation] (download [HTML], [PDF]

Top issues

Discussions

Latest release

8.1.0 8.1.0 2026-10-28
8.1.0 (2026-10-27)
========================================================================================================================

Thanks to
@BillyLiou,
@Thomasdezeeuw,
@eyupcanakman,
@fubar-coder,
@ptwales,
@jgarte,
@brenordv,
@linkdd,
@jkellz-dev,
@josh-coderpad,
@qrn12580,
@1diot9,
@Hama1cco,

Take a tour of this version here!

Enhancements:

 Add --no-header option to remove specific HTTP header 4884
 Add --fail-with-body option to output response body when there are errors 4776
 Add no jsonpath coercion option 5077
 Add --proxy-header option to send head

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON