# curl

> A command that sends a web request. It prints the reply.

**Field:** Software Development  
**Category:** APIs  
**Also known as:** cURL, curl command

## Think of it like

Think of it like a walkie-talkie for the web. One line out, and the answer comes back.

## Definition

curl is a command that sends a request to a web address and prints the reply. It comes with Linux, macOS and Windows 10 and later. Flags pick the method, add headers and send a body, so it can reach almost any API. API docs often show their examples as curl commands. It is also handy for checking if a site is up from a server with no browser.

## Example

Jack checks his site from a server with curl -I. The first line says HTTP/2 200, so the site is up.

## Example code

```console
$ curl -I https://example.com
HTTP/2 200
content-type: text/html; charset=utf-8
```

-I asks for the headers only. 200 means the page is fine.

## Why it matters

It is on nearly every machine, and most API docs use it. That makes it the fastest way to try a request.

## Common mistake

Pasting a curl line with a real token into a shared chat or a ticket. Anyone who reads it can use your key.

## Three principles

- **From the terminal.** One line per request.
- **Flags set it up.** -X, -H, -d, -I.
- **On almost every machine.** Linux, macOS, Windows.

## Related terms

- [HTTP Client](https://learn.benibix.com/term/development/http-client)
- [Postman](https://learn.benibix.com/term/development/postman)
- [Command Line](https://learn.benibix.com/term/infrastructure/command-line)
- [HTTP Request](https://learn.benibix.com/term/infrastructure/http-request)
- [HTTPie](https://learn.benibix.com/term/development/httpie)

---

Source: https://learn.benibix.com/term/development/curl
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
