cURL

Make HTTP requests from the terminal. Test APIs, download files, send data, and debug network connections.

40 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

Requests

HTTP methods

12commands

Auth

Authentication

8commands

Headers

HTTP headers

7commands

Download

Download & upload

10commands

Check curl version

$ curl --version

Display curl version, protocols, and feature info

Install curl (Linux)

$ sudo apt install curl -y

Install curl using APT on Debian/Ubuntu Linux

Test a request with curl

$ curl -I https://example.com

Send a HEAD request to verify curl is working

DELETE request

$ curl -X DELETE https://api.example.com/resource/123

Make a DELETE request

Follow redirects

$ curl -L https://example.com

Follow HTTP redirects automatically

GET request

$ curl https://api.example.com/resource

Make a simple GET request

GET with verbose output

$ curl -v https://api.example.com/resource

GET request with detailed output

HEAD request

$ curl -I https://example.com

Get only response headers

PATCH request

$ curl -X PATCH -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/resource

Make a PATCH request with JSON body

POST request

$ curl -X POST https://api.example.com/resource

Make a POST request

POST form data

$ curl -X POST -d "key=value&key2=value2" https://api.example.com/resource

POST request with form-encoded data

POST JSON data

$ curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/resource

POST request with JSON body

PUT request

$ curl -X PUT -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/resource

Make a PUT request with JSON body

Silent mode

$ curl -s https://api.example.com/resource

Suppress progress meter and errors

Set timeout

$ curl --connect-timeout 5 -m 30 https://api.example.com/resource

Set connection and max timeout

API key in header

$ curl -H "X-API-Key: your-api-key" https://api.example.com/resource

Make request with API key header

Basic authentication

$ curl -u username:password https://api.example.com/resource

Make request with basic auth

Bearer token auth

$ curl -H "Authorization: Bearer TOKEN" https://api.example.com/resource

Make request with bearer token

Client certificate

$ curl --cert cert.pem --key key.pem https://api.example.com

Make request with client certificate

Send cookies

$ curl -b "session=abc123" https://example.com

Send cookies with request

Ignore SSL errors

$ curl -k https://self-signed.example.com

Allow insecure SSL connections

Save cookies to file

$ curl -c cookies.txt https://example.com/login

Save response cookies to file

Use cookies from file

$ curl -b cookies.txt https://example.com/protected

Load cookies from file for request

Set Accept header

$ curl -H "Accept: application/json" https://api.example.com

Set Accept header for response type

Set Content-Type

$ curl -H "Content-Type: application/json" https://api.example.com

Set Content-Type header

Add custom header

$ curl -H "X-Custom-Header: value" https://api.example.com

Add custom header to request

Show only headers

$ curl -s -o /dev/null -D - https://example.com

Show only response headers, no body

Set Referer

$ curl -e "https://google.com" https://example.com

Set Referer header

Show response headers

$ curl -i https://api.example.com/resource

Include response headers in output

Set User-Agent

$ curl -A "Mozilla/5.0" https://example.com

Set User-Agent header

Download file

$ curl -O https://example.com/file.zip

Download file keeping original name

Limit download speed

$ curl --limit-rate 1M -O https://example.com/file.zip

Limit download speed to 1 MB/s

Download with progress bar

$ curl -# -O https://example.com/file.zip

Download showing progress bar

Download with custom name

$ curl -o custom-name.zip https://example.com/file.zip

Download file with custom filename

Resume download

$ curl -C - -O https://example.com/largefile.zip

Resume interrupted download

FTP download

$ curl -u user:pass ftp://ftp.example.com/file.txt -o file.txt

Download file from FTP server

Get HTTP status code

$ curl -s -o /dev/null -w "%{http_code}" https://example.com

Get only the HTTP status code

Measure response time

$ curl -w "\nTime: %{time_total}s\n" -o /dev/null -s https://example.com

Measure total response time

Upload file

$ curl -F "file=@/path/to/file.txt" https://api.example.com/upload

Upload file via multipart form

Upload with PUT

$ curl -T file.txt https://api.example.com/upload

Upload file using PUT method

Discussion

Loading comments...

cURL

Make HTTP requests from the terminal. Test APIs, download files, send data, and debug network connections.

40 commands

Browse by Topic

Getting Started

Quick setup and installation

3commands

Requests

HTTP methods

12commands

Auth

Authentication

8commands

Headers

HTTP headers

7commands

Download

Download & upload

10commands

Check curl version

$ curl --version

Display curl version, protocols, and feature info

Install curl (Linux)

$ sudo apt install curl -y

Install curl using APT on Debian/Ubuntu Linux

Test a request with curl

$ curl -I https://example.com

Send a HEAD request to verify curl is working

DELETE request

$ curl -X DELETE https://api.example.com/resource/123

Make a DELETE request

Follow redirects

$ curl -L https://example.com

Follow HTTP redirects automatically

GET request

$ curl https://api.example.com/resource

Make a simple GET request

GET with verbose output

$ curl -v https://api.example.com/resource

GET request with detailed output

HEAD request

$ curl -I https://example.com

Get only response headers

PATCH request

$ curl -X PATCH -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/resource

Make a PATCH request with JSON body

POST request

$ curl -X POST https://api.example.com/resource

Make a POST request

POST form data

$ curl -X POST -d "key=value&key2=value2" https://api.example.com/resource

POST request with form-encoded data

POST JSON data

$ curl -X POST -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/resource

POST request with JSON body

PUT request

$ curl -X PUT -H "Content-Type: application/json" -d '{"key":"value"}' https://api.example.com/resource

Make a PUT request with JSON body

Silent mode

$ curl -s https://api.example.com/resource

Suppress progress meter and errors

Set timeout

$ curl --connect-timeout 5 -m 30 https://api.example.com/resource

Set connection and max timeout

API key in header

$ curl -H "X-API-Key: your-api-key" https://api.example.com/resource

Make request with API key header

Basic authentication

$ curl -u username:password https://api.example.com/resource

Make request with basic auth

Bearer token auth

$ curl -H "Authorization: Bearer TOKEN" https://api.example.com/resource

Make request with bearer token

Client certificate

$ curl --cert cert.pem --key key.pem https://api.example.com

Make request with client certificate

Send cookies

$ curl -b "session=abc123" https://example.com

Send cookies with request

Ignore SSL errors

$ curl -k https://self-signed.example.com

Allow insecure SSL connections

Save cookies to file

$ curl -c cookies.txt https://example.com/login

Save response cookies to file

Use cookies from file

$ curl -b cookies.txt https://example.com/protected

Load cookies from file for request

Set Accept header

$ curl -H "Accept: application/json" https://api.example.com

Set Accept header for response type

Set Content-Type

$ curl -H "Content-Type: application/json" https://api.example.com

Set Content-Type header

Add custom header

$ curl -H "X-Custom-Header: value" https://api.example.com

Add custom header to request

Show only headers

$ curl -s -o /dev/null -D - https://example.com

Show only response headers, no body

Set Referer

$ curl -e "https://google.com" https://example.com

Set Referer header

Show response headers

$ curl -i https://api.example.com/resource

Include response headers in output

Set User-Agent

$ curl -A "Mozilla/5.0" https://example.com

Set User-Agent header

Download file

$ curl -O https://example.com/file.zip

Download file keeping original name

Limit download speed

$ curl --limit-rate 1M -O https://example.com/file.zip

Limit download speed to 1 MB/s

Download with progress bar

$ curl -# -O https://example.com/file.zip

Download showing progress bar

Download with custom name

$ curl -o custom-name.zip https://example.com/file.zip

Download file with custom filename

Resume download

$ curl -C - -O https://example.com/largefile.zip

Resume interrupted download

FTP download

$ curl -u user:pass ftp://ftp.example.com/file.txt -o file.txt

Download file from FTP server

Get HTTP status code

$ curl -s -o /dev/null -w "%{http_code}" https://example.com

Get only the HTTP status code

Measure response time

$ curl -w "\nTime: %{time_total}s\n" -o /dev/null -s https://example.com

Measure total response time

Upload file

$ curl -F "file=@/path/to/file.txt" https://api.example.com/upload

Upload file via multipart form

Upload with PUT

$ curl -T file.txt https://api.example.com/upload

Upload file using PUT method

Discussion

Loading comments...