Orange-OpenSource /hurl
Hurl, run and test HTTP requests with plain text.
★ 19,324⑂ 751👁 54⑃ 4,323● 995▤ 32
+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
#366Add Hurl to official Debian repository30 comments · 2021-11-23#983Syntax highlighting plugin for editor18 comments · 2022-11-11#831plan for pre-scripting or post-scripting?18 comments · 2022-09-17#1096Websocket support and documentation? 15 comments · 2022-12-12#1067Feature Request: Allow tests to have names and display them on failure15 comments · 2022-12-06#317An easy way to reuse requests14 comments · 2021-10-22#3690Testcase Id Prefix12 comments · 2025-02-03#543Add support for JSON Schema validation assert?12 comments · 2022-04-21
Discussions
#5257hurl syntax highlighting for bat/sublime-text2 comments · 2026-09-01#5193Skill for Hurl1 comments · 2026-08-06#5084Is there a way to transform a Hurl file into its "already replaced variables" version ?2 comments · 2026-06-10#4990GRPC Support and Roadmap?2 comments · 2026-04-26#4824Clear headers from specific requests in hurl file3 comments · 2026-02-25#4675Assert no response1 comments · 2026-01-06#4638Is there a way to mark a test as "expected failure"?1 comments · 2025-12-17#4244Implementing rendering of array and object variables1 comments · 2025-07-23
Latest release
8.1.0 8.1.0 2026-10-288.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