{"openapi": "3.1.0", "info": {"title": "SMSRiver Developer REST API", "description": "Programmatic API for phone number intelligence, temporary SMS inboxes, message verification, and segment calculations.", "version": "1.0.0", "contact": {"name": "SMSRiver Support", "email": "mgmt@adstim.net", "url": "https://smsriver.com/contact/"}}, "servers": [{"url": "https://smsriver.com", "description": "Production Edge Cloudflare Worker"}], "paths": {"/api/v1/lookup/": {"get": {"summary": "Inspect Phone Number", "description": "Normalize a phone number to E.164, detect country, validate numbering plan, and classify line type.", "parameters": [{"name": "phone", "in": "query", "required": true, "schema": {"type": "string"}, "description": "Raw or international phone number"}, {"name": "country", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Optional ISO 3166-1 alpha-2 country code"}], "responses": {"200": {"description": "Phone number intelligence details"}, "400": {"description": "Missing phone parameter"}}}}, "/api/v1/lookup/batch/": {"post": {"summary": "Batch Inspect Phone Numbers", "description": "Inspect and validate up to 100 phone numbers simultaneously.", "responses": {"200": {"description": "Batch lookup results array"}, "400": {"description": "Malformed request payload"}}}}, "/api/v1/inbox/{phone_number}/messages/": {"get": {"summary": "Retrieve Inbox Messages", "description": "Fetch recent inbound SMS verification codes and OTP messages for the specified phone number.", "parameters": [{"name": "phone_number", "in": "path", "required": true, "schema": {"type": "string"}, "description": "Phone number digits in E.164 format without plus"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 20}}], "responses": {"200": {"description": "List of received SMS messages"}, "404": {"description": "Phone number not found or inactive"}}}}, "/api/v1/countries/": {"get": {"summary": "List Supported Countries", "description": "Get all supported countries, active number counts, and calling codes.", "responses": {"200": {"description": "List of supported countries"}}}}, "/api/v1/tools/segment-calc/": {"post": {"summary": "Calculate SMS Segments", "description": "Compute encoding (GSM-7 or UCS-2), segment count, character count, and billable parts.", "responses": {"200": {"description": "Segment calculation details"}}}}}}