REST v SOAP - A few perspectives

Image Image

In this article, we look at the major differences between SOAP and REST. OOPS.. actually, comparing the two is a little like comparing apples to oranges, as SOAP is a protocol format based on XML, whereas REST is an architectural approach.

You will Learn

  • What is REST?
  • What is SOAP?
  • How are REST and SOAP different?

Free Courses - Learn in 10 Steps


This is the second article in a series of articles on REST APIs:


REST vs SOAP are not really comparable. REST is an architectural style. SOAP is a message exchange format.

Let’s compare the popular implementations of REST and SOAP styles.

  • RESTful Sample Implementation : JSON over HTTP
  • SOAP Sample Implementation : XML over SOAP over HTTP

At a high level, SOAP is about restrictions on your message structures while REST is an architectural approach focused on using HTTP Transport.

  • SOAP is particular about the Data Exchange Format. With SOAP, this is always SOAP-XML, which is an XML with envelope, header and body. Both the request and response should adhere to the SOAP structure.
  • REST is very particular about using HTTP as the transport protocol. It intends to make the best use of the features provided by HTTP - Request methods, Request headers, Response, Response headers etc.

Message interchange format

  • With SOAP, you use SOAP XML format for Request and Response
  • With REST, there is no such fixed format. You could exchange messages based on XML, JSON or any other convenient format. JSON is the most popular among the used formats.

Service Definitions

  • SOAP makes use of Web Service Definition Language (WSDL).
  • REST does not have a standard service definition language. Even though WADL was one of the first standards to be proposed, it is not very popular. Swagger or Open API is another popular approach.


  • SOAP does not place any restrictions on the kind of transport protocol. You could either use Web (which is HTTP), or MQ.
  • REST intends to make the best use of HTTP Transport Protocol

Ease of Implementation

RESTFful services are typically a lot easier to implement than SOAP based web services.

  • REST typically uses JSON, which is easier to parse and process. In addition to that, REST does not require you to have a service definition in place to provide a web service.
  • However with SOAP, you are needed to define your service using WSDL, and greater overhead is involved in processing and parsing the SOAP-XML messages.

Do check out our video on this:

image info


In this article, we broadly looked the differences between REST and SOAP.

Best Selling Udemy Courses

Image Image Image Image Image Image Image Image Image Image Image Image

Join 450,000 Learners and 30+ Amazing Courses

350,000 Learners are learning everyday with our Best Selling Courses : Spring Boot Microservices, Spring, Spring Boot, Web Services, Hibernate, Full Stack React, Full Stack Angular, Python, Spring Interview Guide, Java Interview, Java Functional Programming, AWS, Docker, Kubernetes, PCF, AWS Fargate and Azure

Do not know where to start your learning journey? Check out our amazing learning paths:
Learning Path 01 - Spring and Spring Boot Web Applications and API Developer,
Learning Path 02 - Full Stack Developer with Spring Boot, React & Angular,
Learning Path 03 - Cloud Microservices Developer with Docker and Kubernetes,
Learning Path 04 - Learn Cloud with Spring Boot, AWS, Azure and PCF and
Learning Path 05 - Learn AWS with Microservices, Docker and Kubernetes



Related Posts

Understanding jwt token

Let us understand the json web tokens

Single sign-on workflow

Let us understand the single sign-on workflow

Oauth2.0 - Resource Owner Password Credentials grant workflow

Let us understand the Oauth2.0 Resource Owner Password Credentials grant workflow

Oauth2.0 - Implicit grant workflow

Let us understand the Oauth2.0 implicit grant workflow

Oauth2.0 - Client Credentials grant workflow

Let us understand the Oauth2.0 client credentials grant workflow

Oauth2.0 - Authorization grant workflow

Let us understand the Oauth2.0 authorization grant workflow

Writing Integration Tests for Rest Services with Spring Boot

Setting up a basic REST Service with Spring Boot is a cake walk. We will go one step further and add great integration tests!

Integrating Spring Boot and Spring JDBC with H2 and Starter JDBC

Learn using Spring Boot Starter JDBC to connect Spring Boot to H2 (in memory database) using Spring JDBC. You will create a simple project with Spring Boot. You will add code to the project to connect to a database using Spring JDBC. You will learn to implement the basic CRUD methods.

JUnit Tutorial for Beginners in 5 Steps

JUnit Tutorial for Beginners in 5 Steps. Setting up a basic JUnit example and understanding the basics of junit.

JPA and Hibernate Tutorial For Beginners - 10 Steps with Spring Boot and H2

JPA and Hibernate in 10 Steps with H2 - Setting up a basic project example with Spring Boot and in memory database H2. Its a cake walk.