Service Proxy
Access Sapiom capabilities from any language using our REST API — no SDK required.
When to Use This
Section titled “When to Use This”The Service Proxy provides direct REST API access to Sapiom services. Use it when:
- You’re using Python, Go, Ruby, or another language without a Sapiom SDK
- You want Sapiom to handle provider selection and payment server-side
If you’re using Node.js, the SDK integration offers a better developer experience with automatic payment handling.
Authentication
Section titled “Authentication”All Service Proxy endpoints require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEYGet your API key from the Sapiom dashboard.
Available Services
Section titled “Available Services” Verify Users Send and check verification codes via SMS
Error Handling
Section titled “Error Handling”All Service Proxy endpoints return standard HTTP status codes:
| Status | Description |
|---|---|
| 400 | Invalid request (bad format, missing fields) |
| 401 | Unauthorized — check your API key |
| 404 | Resource not found |
| 410 | Resource expired |
| 422 | Unprocessable entity (e.g., invalid verification code) |
| 429 | Rate limit exceeded |
Error Response Format:
{ "message": "Description of the error", "statusCode": 400}Coming Soon
Section titled “Coming Soon”Additional services will be available through the Service Proxy:
- Search — currently available via SDK with provider endpoints
- AI Models — currently available via SDK with provider endpoints