7x Developer Portal & API Documentation

Request builder

Authenticate — Get DET Token · EPG → DET

Reference details

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/auth/authenticate" \  -H "Content-Type: application/json" \  -d '{    "clientId": "det_idep_client",    "clientSecret": "{{DET_ClientSecret}}"  }'

{  "accessToken": "eyJhbGciOiJSUzI1Ni...<redacted>"}

{  "status": 401,  "desc": {    "en": "Invalid client credentials",    "ar": "بيانات اعتماد غير صالحة",    "code": "401"  }}

Request builder

Get Salesforce Token (username Password) · DET → EPG

Reference details

Request Body

application/x-www-form-urlencoded

Response Body

`application/json`

curl -X POST "https://example.com/services/oauth2/token" \  -H "Content-Type: application/x-www-form-urlencoded" \  -d 'grant_type=password&client_id=%7B%7BSF_ConsumerKey%7D%7D&client_secret=%7B%7BSF_ConsumerSecret%7D%7D&username=%7B%7BSF_Integration_User%7D%7D&password=%7B%7BSF_Password%2BSecurityToken%7D%7D'

{  "access_token": "00D58000000arpq!ARsAQ...<redacted>",  "instance_url": "https://epro.my.salesforce.com",  "token_type": "Bearer",  "issued_at": "1609942615640",  "signature": "<redacted>"}

{  "error": "invalid_grant",  "error_description": "authentication failure"}

Request builder

Reference Lookup (regions Emirates) · DET → EPG

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Query Parameters

type*string

emirate?string

Header Parameters

X-Request-Id?string

Response Body

`application/json`

curl -X GET "https://example.com/services/apexrest/referencelookup?type=region&emirate=dubai"

{  "Updated_Region__c": [    {      "ValueAr": "الوحيدة",      "ValueEn": "Al Waheda",      "Code": "35"    },    {      "ValueAr": "البراحة",      "ValueEn": "Al Baraha",      "Code": "36"    }  ]}

{  "status": 400,  "desc": {    "en": "Invalid or missing 'type'",    "ar": "نوع غير صالح",    "code": "400"  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Overview

Creates the applicant Account + related records in one transactional composite call (allOrNone=true). Body abbreviated.

Request builder

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/services/apexrest/CompositeHandler" \  -H "Content-Type: application/json" \  -d '{    "allOrNone": true,    "compositeRequest": [      {        "method": "POST",        "referenceId": "NewAccount",        "url": "/services/data/v60.0/sobjects/Account",        "body": {          "Name": "Try To Test For Documents Delivery EST.",          "EPG_Company_Name_Arabic__c": "مؤسسة تراي طه تست لنقل الوثائق",          "EPG_Company_Status__c": "Active",          "EPG_Trade_license_no__c": "2028223"        }      }    ]  }'

{  "compositeResponse": [    {      "referenceId": "NewAccount",      "httpStatusCode": 200,      "httpHeaders": {        "Location": "/services/data/v60.0/sobjects/Account/001FV000008pgivYAA"      },      "body": {        "success": true,        "id": "001FV000008pgivYAA",        "errors": []      }    }  ]}

{  "compositeResponse": [    {      "referenceId": "NewAccount",      "httpStatusCode": 400,      "httpHeaders": {},      "body": {        "success": false,        "id": null,        "errors": [          "Rolled back due to allOrNone=true: Insert failed. CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY: ..."        ]      }    }  ]}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Overview

Submits the new licence application to DET. Body abbreviated.

Request builder

Create License (submit Application) · EPG → DET

Reference details

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/License/createLicense" \  -H "Content-Type: application/json" \  -d '{    "appAttr": {      "documents": [        "supportingDocuments"      ]    },    "appData": {      "accountId": "784199325925487",      "company": {        "address": {          "emirate": "Dubai",          "line1": "610,1",          "region": "Jumeriah"        },        "dulLicenseDULNumber": "CC7275",        "dulLicenseEmail": "[email protected]",        "dulLicenseExpiryDate": "2027-02-10",        "dulLicenseIssueAuthorityEn": "Department of Economy and Tourism - DET",        "dulLicenseIssueAuthorityLicenceNumber": "2031257",        "dulLicenseIssueDate": "2026-02-11"      }    }  }'

{  "status": 200,  "applicationId": "A-CC7275-S-EPG-000002-1782109885",  "desc": {    "en": "Success",    "ar": "نجاح",    "code": "200"  }}

{  "status": 400,  "desc": {    "en": "Invalid appData: dulLicenseDULNumber is required",    "ar": "بيانات غير صالحة",    "code": "400"  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Overview

Alternate DET application-submission endpoint. Same appAttr/appData shape as Create License.

Request builder

Submit Application (s360, Alternate) · EPG → DET

Reference details

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/s360/v1/application" \  -H "Content-Type: application/json" \  -d '{    "appAttr": {      "documents": [        "supportingDocuments"      ]    },    "appData": {      "accountId": "784199325925487",      "company": {        "address": {          "emirate": "Dubai",          "line1": "610,1",          "region": "Jumeriah"        },        "dulLicenseDULNumber": "CC7275",        "dulLicenseIssueAuthorityLicenceNumber": "2031257"      }    }  }'

{  "status": 200,  "applicationId": "A-CC7275-S-EPG-000002-1782109885",  "desc": {    "en": "Success",    "ar": "نجاح",    "code": "200"  }}

{  "status": 400,  "desc": {    "en": "Invalid application payload",    "ar": "حمولة غير صالحة",    "code": "400"  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Get Application Status · DET → EPG

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Query Parameters

applicationId*string

Header Parameters

X-Request-Id?string

Response Body

`application/json`

curl -X GET "https://example.com/services/apexrest/getApplicationStatus?applicationId=A-CC4033-S-EPG-000002-1782109885"

{  "status": 200,  "desc": {    "en": "Success",    "code": "RTA-S-0000",    "ar": "نجاح"  },  "decision": {    "status": {      "en": "Approved",      "ar": "موافقة"    },    "remarks": [      {        "en": "Application is waiting for decision",        "createdOn": "2026-01-29T14:03:52.000Z",        "code": "EPG"      }    ]  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Notify Application Decision · EPG → DET

Reference details

Path Parameters

providerCode*string

serviceId*string

applicationId*string

Request Body

application/json

Response Body

`application/json`

curl -X PUT "https://example.com/application/EPG/S-EPG-000002/1/A-CS2857-S-EPG-000002-1779257348/decision" \  -H "Content-Type: application/json" \  -d '{    "status": {      "en": "More Info Required",      "ar": "مطلوب معلومات إضافية"    },    "remarks": [      {        "en": "Document Unclear",        "createdOn": "2026-05-20T06:33:14.000Z",        "code": "EPG",        "ar": "مطلوب مستندات إضافية"      }    ],    "code": "2"  }'

{  "status": 200,  "desc": {    "en": "Success",    "ar": "نجاح",    "code": "200"  },  "correlationId": "75be3872-da72-4325-9957-36ddc708588a"}

{  "status": 400,  "desc": {    "en": "Invalid decision code",    "ar": "رمز قرار غير صالح",    "code": "400"  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Payment Pricing (quotation) · DET → EPG

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/services/apexrest/payment/pricing" \  -H "Content-Type: application/json" \  -d '{    "entityId": "Department of Economy and Tourism - DET",    "quotationRequest": {      "requestOn": "2026-01-30T12:00:00.000Z",      "appIdentifier": {        "applicationId": "A-CC4033-S-EPG-000002-1782109885",        "serviceId": "S-RTA-0002",        "serviceName": {          "en": "Business Licensing Fees",          "ar": "رسوم ترخيص الأعمال"        },        "serviceType": {          "code": "NOC",          "en": "NOC",          "ar": "شهادة عدم الممانعة"        }      }    }  }'

{  "status": 200,  "responseDesc": {    "en": "Success",    "code": "200",    "ar": "نجاح"  },  "quotationResponse": {    "refInvoiceId": "P7689",    "quotedOn": "2026-01-30T14:03:52.000Z",    "quotationStatus": "Approved",    "pricedBy": "EPG",    "items": [      {        "totalAmount": 100000,        "responseCurrency": {          "en": "AED",          "ar": "درهم"        }      }    ]  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Payment Notification · DET → EPG

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/services/apexrest/paymentNotification" \  -H "Content-Type: application/json" \  -d '{    "entityId": "DET",    "notifyPayment": {      "applicationId": "A-CC4033-S-EPG-000002-1782109885",      "payment": {        "invoiceId": "INV-EPG-0000000011",        "paymentId": "P-CS2973-1780564354568",        "payOn": "2026-06-04T13:13:19+00:00",        "payThru": "noqodi",        "paymentMethod": "CCD",        "paymentStatus": "completed",        "transactions": [          {            "transactionId": "T-CS2973-...-1",            "itemId": "1141",            "beneficiaryId": "EPG",            "amount": 100000          }        ]      }    }  }'

{  "status": 200,  "desc": {    "en": "Success",    "code": "43020",    "ar": "نجاح"  },  "message": {    "en": "Success",    "code": "83250-8635",    "ar": "نجاح"  },  "correlationId": "75be3872-da72-4325-9957-36ddc708588a"}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Service Provisioning Request · DET → EPG

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Request Body

application/json

Response Body

`application/json`

curl -X POST "https://example.com/services/apexrest/ServiceProvisioningRequest" \  -H "Content-Type: application/json" \  -d '{    "applicationId": "A-CC4033-S-EPG-000002-1782109885",    "serviceId": "S-RTA-0001",    "providerCode": "RTA",    "serviceName": "Safari Permit by RTA",    "serviceVersion": "1",    "requestType": "Provision"  }'

{  "status": 200,  "desc": {    "en": "Success",    "code": "200",    "ar": "نجاح"  },  "correlationId": "75be3872-da72-4325-9957-36ddc708588a"}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Overview

Provisions the issued licence/permit (with the signed document) back to DET.

Request builder

Notify Service Provisioning · EPG → DET

Reference details

Path Parameters

providerCode*string

serviceId*string

applicationId*string

Request Body

application/json

Response Body

`application/json`

curl -X PUT "https://example.com/v1/service/provisioning/RTA/S-RTA-0001/1/A-DUL0001-S-RTA-0001-17297409693/status" \  -H "Content-Type: application/json" \  -d '{    "code": "Provisioned",    "desc": {      "code": "S-ESB-000001",      "en": "Success",      "ar": "نجاح"    },    "referenceId": "4b02872b-0012-4b0e-b48b-83b9f179c1a7",    "documents": [      {        "docType": "Permit",        "fileName": "permit.pdf",        "fileType": "pdf",        "content": "QFRfQ2pJOnZdQw=="      }    ],    "data": [      {        "label": {          "en": "MOHRE Establishment Card Number",          "ar": "رقم بطاقة منشأة"        },        "value": "1234567"      }    ]  }'

{  "status": 200,  "desc": {    "en": "Success",    "ar": "نجاح",    "code": "200"  },  "correlationId": "75be3872-da72-4325-9957-36ddc708588a"}

{  "status": 400,  "desc": {    "en": "Invalid document content",    "ar": "محتوى مستند غير صالح",    "code": "400"  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Get Provisioning Status · DET → EPG

Reference details

Authorization

sfBearer

AuthorizationBearer <token>

Salesforce OAuth token from POST /services/oauth2/token

In: header

Query Parameters

applicationId*string

Header Parameters

X-Request-Id?string

Response Body

`application/json`

curl -X GET "https://example.com/services/apexrest/serviceprovisioningstatus?applicationId=A-CC4033-S-EPG-000002-1782109885"

{  "status": 200,  "provisioning": {    "referenceId": "a0vFV000001JMkDYAW",    "lastUpdatedOn": "2026-01-02T14:05:10.000Z",    "expiredOn": "2027-01-03T14:05:00.000Z",    "documents": [      {        "fileType": "docx",        "fileName": "Postal License (1).docx",        "docType": "Permit",        "content": "UEsDBBQABgAIAAAAI...=="      }    ]  }}

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "Failure: No License Request found",    "ar": "فشل",    "code": "404"  },  "correlationId": null}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

Request builder

Get File · EPG → DET

Reference details

Path Parameters

fileId*string

Response Body

`application/json`

curl -X GET "https://example.com/documents/v1/file/55196d60-340b-4c5f-872a-e81b8bd7e039"

"string"

{  "status": 401,  "desc": {    "en": "Unauthorized",    "ar": "غير مصرح",    "code": "401"  }}

{  "status": 404,  "desc": {    "en": "File not found",    "ar": "الملف غير موجود",    "code": "404"  }}

{  "status": 500,  "desc": {    "en": "Internal server error",    "ar": "خطأ في الخادم",    "code": "500"  }}

200application/json

401application/json

200application/json

400application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

400application/json

401application/json

500application/json

200application/json

401application/json

404application/json

500application/json

200application/json

400application/json

401application/json

404application/json

500application/json

200application/json

401application/json

404application/json

500application/json

200application/json

401application/json

404application/json

500application/json

200application/json

401application/json

404application/json

500application/json

200application/json

400application/json

401application/json

404application/json

500application/json

200application/json

401application/json

404application/json

500application/json

200application/json

401application/json

404application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`