cURL – POST request examples

cURL logo

Some cURL POST request examples for self reference.

1. Normal POST

1.1 To POST without data.

$ curl -X POST http://localhost:8080/api/login/

1.2 To POST with data.

$ curl -d "username=mkyong&password=abc" http://localhost:8080/api/login/

1.3 Spring REST to accept normal POST data.

    public ResponseEntity<?> login(@RequestParam("username") String username,
                                    @RequestParam("password") String password) {

    public ResponseEntity<?> login(@ModelAttribute Login login) {

2. POST + Multipart

To POST with a file, add this -F file=@"path/to/data.txt"

2.1 Upload a file

$ curl -F file=@"path/to/data.txt" http://localhost:8080/api/upload/

2.2 Upload multiple files, with extra fields :

$ curl -F extraField="abc" -F files=@"path/to/data.txt" -F files=@"path/to/data2.txt"  http://localhost:8080/api/upload/multi/

2.3 Spring REST to accept POST Multipart data.

    public ResponseEntity<?> uploadFile(
            @RequestParam("file") MultipartFile uploadfile) {
    public ResponseEntity<?> uploadFiles(
            @RequestParam("extraField") String extraField,
            @RequestParam("files") MultipartFile[] uploadfiles) {
    public ResponseEntity<?> uploadFiles2(
            @ModelAttribute UploadModel model) {


To POST with JSON data, add this -H "Content-Type: application/json"

3.1 On Windows, escape the double quotes

c:\> curl -H "Content-Type: application/json" -X POST -d {\"username\":\"mkyong\",\"password\":\"abc\"} http://localhost:8080/api/login/

3.2 For *nix or Mac OSX, add a single quote

$ curl -H "Content-Type: application/json" -X POST -d '{"username":"mkyong","password":"abc"}' http://localhost:8080/api/login/

3.3 Spring REST to accept POST JSON data.

    public ResponseEntity<?> login(@RequestBody Login login) {


  1. cURL official website
  2. Wikipedia – cURL
  3. Building REST services with Spring
  4. cURL – Post JSON data to Spring REST
  5. Spring Boot file upload example – Ajax and REST

About the Author

author image
Founder of, love Java and open source stuff. Follow him on Twitter, or befriend him on Facebook or Google Plus. If you like my tutorials, consider make a donation to these charities.


Leave a Reply

newest oldest most voted

hi kyong,

I am not a java developer but just testing a bit with REST API commands such us POST GET PUT and I wonder what should be the directives I need to modify/config in the http.conf file so I can enable/allow writing files to the webserver using the PUT command.. if you can please give me a example would be great… thanks in advance….

Borgy Manotoy
Borgy Manotoy

Nice! Is it possible to have a json POST with multiple files inside? Example: { “ticketId”: “1”, “ticketCode”: “ABC123”, “attachments”: [ FILES_HERE ] }? Thanks


alert(“awesome articles”)