Skip to content
DEVELOPER DOCUMENTATION
/
/
/
Check service health (adm...

Namirial SMS Gateway API (27.1.0.4)

Send SMS messages worldwide with enterprise-grade reliability and delivery tracking.

Complete SMS Gateway Documentation
Download OpenAPI description
openapi.json
openapi.yaml
Languages
Servers
Production environment

https://sms.namirialtsp.com/

Pre-production staging environment (coming soon)

https://sms.preprod.namirialtsp.com/

Development and testing environment

https://sms.test.namirialtsp.com/

SmsServices

Send SMS messages using your account credentials.

Authentication: HTTP Basic Auth required

Operations

SmsAdmin

Send SMS with administrative privileges on behalf of other accounts.

Authentication: HTTP Basic Auth required

Operations

Check service health (admin)

Request

Admin health check endpoint

Security
basicAuth
curl -i -X POST \
  -u <username>:<password> \
  https://sms.namirialtsp.com/api/Admin/checkServiceStatus

Responses

Service is operational.

Bodyapplication/json
globalStatusbooleanrequired

Overall service availability.

dbStatusbooleanrequired

Database connectivity status.

servicesStatusbooleanrequired

Internal services availability.

errorMessagestring

Error message if any component is unavailable. Empty string when all systems are operational.

versionNumberstringrequired

Current API version.

Example: "27.1.0.2"
Response
application/json
{
  "globalStatus": true,
  "dbStatus": true,
  "servicesStatus": true,
  "errorMessage": "",
  "versionNumber": "27.1.0.2"
}

Send SMS with admin privileges

Request

Send an SMS message on behalf of another account using admin credentials.

Use case: Send SMS for other accounts without their credentials

Additional parameters: account and lra (Local Registration Authority)

Security
basicAuth
Bodyapplication/json

Send parameters

destinationstring^\+[1-9]\d{6,14}$required

Destination phone number in E.164 international format.

Format: +[country code][number] (e.g., +393401234567)

Example: "+390000000000"
textstring[ 1 .. 1600 ] charactersrequired

Message text to send.

Character limits:

  • GSM-7: 160 chars (single), 153 chars (multi-part)
  • UCS-2: 70 chars (single), 67 chars (multi-part)

Encoding: Automatically detected

Special characters: Emojis trigger UCS-2 (higher cost)

referenceobject(ReferenceService)

Tracking reference to correlate SMS with your business logic. If any field is specified, service is required.

detailedboolean

Return detailed response including provider name.

  • true: Response includes provider
  • false: Response without provider
Default false
businessRelationIdstring<= 255 characters

Business Relation Identifier for One Platform integration.

Overrides default business relation settings.

webhookobject
accountstring

Target account username to send SMS on behalf of

lrainteger(int32)

Local Registration Authority identifier

attemptCountinteger(int32)Deprecated

DEPRECATED: No longer used. Retry logic is handled automatically.

curl -i -X POST \
  -u <username>:<password> \
  https://sms.namirialtsp.com/api/Admin/send \
  -H 'Content-Type: application/json' \
  -d '{
    "destination": "+390000000000",
    "text": "Your verification code is: 123456",
    "account": "account-username",
    "lra": 123456,
    "reference": {
      "service": "DIGITALSIGN",
      "action": "AUTH",
      "key": "dfg6hwrt356hd"
    },
    "businessRelationId": "123456789",
    "webhook": {
      "url": "https://example.com/webhook"
    },
    "detailed": true
  }'

Responses

SMS accepted for delivery.

Bodyapplication/json
idstringrequired

Unique message identifier (UUID). Use to query status via Message Status API.

messagestringrequired

Status message. Format: <code>: <description>. Code 0 = accepted.

providerstring or null

SMS provider used (only when detailed=true).

Response
application/json
{
  "id": "7b8ef313-f1f2-4c4f-bffa-438c287ba9d8",
  "message": "0: Accepted for delivery"
}

Get admin service status

Request

Get detailed admin service status information

Security
basicAuth
curl -i -X GET \
  -u <username>:<password> \
  https://sms.namirialtsp.com/api/Admin/status

Responses

Service is operational.

Bodyapplication/json
globalStatusbooleanrequired

Overall service availability.

dbStatusbooleanrequired

Database connectivity status.

servicesStatusbooleanrequired

Internal services availability.

errorMessagestring

Error message if any component is unavailable. Empty string when all systems are operational.

versionNumberstringrequired

Current API version.

Example: "27.1.0.2"
Response
application/json
{
  "globalStatus": true,
  "dbStatus": true,
  "servicesStatus": true,
  "errorMessage": "",
  "versionNumber": "27.1.0.2"
}