# SOAP (Simple Object Access Protocol)

> An older kind of web API. Every message is strict XML in an envelope.

**Field:** Software Development  
**Category:** APIs  
**Also known as:** SOAP, SOAP API, SOAP Web Service

## Think of it like

Think of it like a formal letter with a fixed layout. Every part must be in its place.

## Definition

SOAP is an older kind of web API where every message is strict XML. Each message has an envelope, an optional header and a body. A WSDL file lists every call the service offers. It has its own rules for safety and errors, which banks and big firms liked. Most new APIs use REST or gRPC instead. But many SOAP services are still running.

## Example

Lucy's bank still sends payment files over a SOAP service. Each request is a long XML envelope, even to fetch one balance.

## Why it matters

Many banks, airlines and government systems still speak SOAP. You may need to call one.

## Common mistake

Building a SOAP request by gluing strings together. Use a SOAP library that reads the WSDL file for you.

## Three principles

- **Strict XML.** Envelope, header, body.
- **Described by WSDL.** Every call listed.
- **Still in big systems.** Banks and government.

## Related terms

- [REST API](https://learn.benibix.com/term/development/rest-api)
- [Extensible Markup Language (XML)](https://learn.benibix.com/term/development/xml)
- [Application Programming Interface (API)](https://learn.benibix.com/term/development/api)
- [Remote Procedure Call (RPC)](https://learn.benibix.com/term/development/remote-procedure-call)

---

Source: https://learn.benibix.com/term/development/soap
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.
