---
title: SOAP client proxy documentation
summary: Entry point for the SimpleCertifiedMail consumed SOAP service proxy documentation.
status: draft
owner: SAIF.Core documentation
last_reviewed: 2026-09-24
---

# SOAP client proxy documentation

`SimpleCertifiedMail` is a svcutil-generated proxy for the **third-party** SimpleCertifiedMail ADS API (`https://api.simplecertifiedmail.com/v3.2/ADS.asmx`), consumed through the authored `SimpleCertifiedMailServiceProxy` wrapper in `SAIF.Services.Web.Proxies`. Unlike the other proxies carried in this library, its generated types are **public**, not `internal`, so the wrapper's own public surface leaks the generated `ModeOptions` enum. One of eight contract operations, `getCertifiedLabel`, is actually called, reached through `SAIF.Services.Legal.Subpoenas.SubpoenaLabelService`.

| Field | Value |
| --- | --- |
| **Proxy name** | `SimpleCertifiedMail` |
| **Mechanism** | Service Reference (svcutil) |
| **Generated namespace** | `SAIF.Services.Web.Proxies.SimpleCertifiedMail` |
| **Generated artifacts** | `Services/SAIF.Services.Web.Proxies/Service References/SimpleCertifiedMail/` |
| **WSDL document** | `Services/SAIF.Services.Web.Proxies/Service References/SimpleCertifiedMail/ADS.wsdl` |
| **Proxy base type** | `System.ServiceModel.ClientBase<T>` (**`public`** — `GenerateInternalTypes=false`, unlike the other proxies in this library) |
| **Hand-written wrapper** | `SimpleCertifiedMailServiceProxy` (`Services/SAIF.Services.Web.Proxies/SimpleCertifiedMailServiceProxy.cs`) |
| **Consuming project** | `SAIF.Services.Web.Proxies` |
| **Target service** | `SimpleCertifiedMail ADS API`† (third party) |
| **Endpoint source** | Environment setting `SimpleCertifiedMailService.Url`, read through `IEnvironmentService`; the generated `<client><endpoint>` in `app.config` is bypassed |
| **Binding** | `BasicHttpBinding(BasicHttpSecurityMode.Transport)` constructed in code, with `MaxReceivedMessageSize`, `MaxBufferSize`, and `MaxArrayLength` raised to `int.MaxValue` |
| **Operations present** | 8 |
| **Operations called** | 1 |

## Documentation sections

| Section | Description |
| --- | --- |
| [Overview](overview.md) | Which service is called, who consumes the proxy, and capability summary |
| [Architecture](architecture.md) | How the proxy is constructed, configured, and invoked |
| [Contract](contract.md) | The WSDL-declared operations, messages, faults, and binding |
| [Operation map](operation-map.md) | Operations present in the proxy versus operations actually called |
| [Client reference](reference.md) | One section per operation called from repository source |
| [Consumption](consumption.md) | Construction, disposal, resilience, and endpoint configuration |
| [Dependencies](dependencies.md) | Packages, framework components, and the called service |
| [Business rules](business-rules.md) | Rules enforced around the call |
| [Tech debt](tech-debt.md) | CRITICAL and HIGH severity findings |

## Called service

| Attribute | Value |
| --- | --- |
| Service name | `SimpleCertifiedMail ADS API`† |
| Documented by this run | No |
| Service documentation | `SimpleCertifiedMail ADS API`† |
| Endpoint address | Unresolved** — the environment setting `SimpleCertifiedMailService.Url` is not defined anywhere in this repository's configuration |
| Address source | `Services/SAIF.Services.Web.Proxies/SimpleCertifiedMailServiceProxy.cs:42`; generation-time address `https://api.simplecertifiedmail.com/v3.2/ADS.asmx` recorded in `Service References/SimpleCertifiedMail/Reference.svcmap:21` |
| SOAP namespace | `https://simplecertifiedmail.com/` |

## Related documentation
- [Overview](overview.md)
- [Architecture](architecture.md)
- [Contract](contract.md)
- [Operation map](operation-map.md)
- [Client reference](reference.md)
- [Consumption](consumption.md)
- [Dependencies](dependencies.md)
- [Business rules](business-rules.md)
- [Tech debt](tech-debt.md)

> **Note:** Statements marked with `†` are derived from dependency library
> documentation via the Legends CLI. Statements marked with `**` could
> not be confirmed; treat as unknown until verified.

## Sources
- `Services/SAIF.Services.Web.Proxies/SAIF.Services.Web.Proxies.csproj`
- `Services/SAIF.Services.Web.Proxies/SimpleCertifiedMailServiceProxy.cs`
- `Services/SAIF.Services.Web.Proxies/Service References/SimpleCertifiedMail/ADS.wsdl`
- `Services/SAIF.Services.Web.Proxies/Service References/SimpleCertifiedMail/Reference.svcmap`
- `Services/SAIF.Services/Legal/Subpoenas/SubpoenaLabelService.cs`