Location Inquiry

Base URL

PROD: https://dms-gs.jtc.aljabr.com.sa/gs
TEST: https://dms-gs-test.jtc.aljabr.com.sa/gs

Send location inquiry SMS

Sends a location inquiry SMS using the configured Location_Inquiry communication template.

GET /v1/communications/location-inquiry

Request Body

{
  "companyId": 1,                           // Mandatory
  "brandId": 1,                             // Mandatory
  "companyHierarchyId": 1,                  // Mandatory
  "mobileNo": "568617083",                  // Mandatory
  "lang": "ar"                              // optional (default "en")
}

Response (200)

{
  "communicationId": 70001,
  "message": "Your request has been received."
}

Response (400)

{
  "applicationId": null,
  "status": 400,
  "errorCode": "DMS-Error-001",
  "operationError": "sms-send-failed",
  "error": "invalid-operation",
  "timeStamp": "2026-06-20T15:00:00"
}