Accessibility

Accessibility

Text size

العربية

Integrate with us and get more leads

Introduction

The TRA digital services marketplace is a platform that links buyers, such as governments and enterprises, with sellers offering tested and proven solutions.

By making the API extensible through the website, it enables the UAE’s largest companies to post project tenders directly from their procurement portal on the TRA digital services marketplace.

 

How do you connect?

to connect with API, please follow the below steps:

  1. Go to this URL http://marketplace.gov.ae/add opportunity key
  2. Fill out your company information
  3. Once we receive your data, our team will review and approve the information
  4. Upon approval, you will receive an email with the secret key and the API end-point
  5. You can then use the API URL (https://marketplace.gov.ae/myapi/opportunitiesApi) along with the secret key to connect with us and post your project opportunities / tenders directly on the digital services marketplace website.

 

Authentication

In order to connect to the API, you must include the supplied secret key in your header.

The secret key will be emailed you by us once your registration information is approved

Below is a sample format of how you will receive the secret key in your email.

Key

Sample value

secret_key

f807f416c225bb96f6010b334d5455ae5ca6016771f2c2e33169df5t47f6yg6o

Endpoints

CreateOpportunity

Http method: Post

Field

Type

Description

Min length

Max length

Format

Mandatory

organizationName

String

Your organization name

1

100


Yes

firstName

String

First name of the contact person

1

100


Yes

lastName

String

Last name of the contact person

1

100


Yes

contactNumber

Number

Contact number of the person

10

20


Yes

emailAddress

String

Email address of the contact person



Email address

Yes

title

String

The title of your opportunity

3

100


Yes

categories

String Array

Category of the opportunity



7 options as Guid:


Consultancy: {6F863725-2590-4703-B46A-AB08170A75AF}

Digital Marketing: {730C4213-D167-4D4D-83D1-7085032A8A27}

 

Information Security solutions: {66D86824-9508-4DC7-B6CF-A8512ECFE2CE}

 

Information Technology Solutions: {BE02A780-044D-498D-BEC7-6EF225594E5D}

 

Managed Services: {80185881-6DAE-4BF4-83A5-24BEFE186CB7}

 

Mobile App Development: {D77A3575-FA43-4211-9E3D-951FCD050062}

 

Web and Software Development: {FD872032-32B0-4105-AAC2-6F790CFB312D}

Yes

description

String

Description of the opportunity



html or plain text

Yes

expiryDate

Number

The duration for which the opportunity will be displayed on the website. The 3 options are:
7 days
14 days
28 days


Expiry date can be from the following values: 7,14 or 28

Yes

hasProcurementLink

Boolean

External URL to your procurement portal, if one exists




Yes

procurementLink

String

Physical URL of your procurement portal



http/https url

i.e.

http://www.google.com

https://www.google.com

Yes if hasProcurementLink value equal to true

procurementEmailAddress

String

Procurement contact email address

Email address

Yes, if hasProcurementLink value equal to false

stringFiles

Array

Files associated with the opportunity that you want to submit. Could be files such as tender information, deviations, exceptions, financial documentation etc.

5 files

The array contains two fields

fileName: your file name with extension


fileString:base64string file

 

allowed extensions:

.pdf, .doc, .docx, .xls, .xlsx


Error codes

Error

Description

400

  • API key not provided
  • Invalid API key with message "Unauthorized"
  • Invalid data

 

Sample code

Sample http request:

POST /myapi/OpportunitiesApi/CreateOpportunity HTTP/1.1

Host: marketplace.gov.ae

secret_key: 5871bd537387d969e82889eab40d1b6f88b8b0120271e4dddd58280414af4a99

Content-Type: application/json

                        
    
        {
            "organizationName":"Marketplace",
            "firstName":"Michael",
            "lastName":  "Wilson",
            "emailAddress":  "m.w@marketplace.com",
            "contactNumber": "0505555659",
            "title":  "Supply and Implementation of Website Files Upload Scanning Solution",
            "category": "{FD872032-32B0-4105-AAC2-6F790CFB312D}",
            "description": "Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an      unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
            "expiryDate":7,
            "hasProcurementLink": true,
            "procurementLink": "https://marketplace.gov.ae/",
            "agreeToTermsAndConditions": true
            
        }
                            
                        

 

Sample http response:

Cache-Controlno-cache
Pragmano-cache
Content-Typeapplication/json; charset=utf-8
Expires-1
ServerMicrosoft-IIS/10.0
DateThu, 22 Oct 2020 14:00:57 GMT
Content-Length11
Response Body : "Succeeded"

 

Sample C# code:

                        
        static void Main(string[] args)
        {
            var files = GetFile();
            var model = new CreateOpportunity
            {
                OrganizationName = "Marketplace",
                FirstName = "Michael",
                LastName = "Wilson",
                AgreeToTermsAndConditions = true,
                Category = "{FD872032-32B0-4105-AAC2-6F790CFB312D}",
                ContactNumber = "0505555659",
                Description = "What is Lorem Ipsum?Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum.",
                EmailAddress = "m.w@marketplace.com",
                ExpiryDate = 7,
                HasProcurementLink = true,
                ProcurementLink = "https://marketplace.gov.ae/",
                Title = "Supply and Implementation of Website Files Upload Scanning Solution",
                StringFiles = new OpportunityFiles[]
                {
                    files
                }
            };
            var json = JsonConvert.SerializeObject(model);
            StringContent theContent = new StringContent(json.ToString(), System.Text.Encoding.UTF8, "application/json");
            using (var client = new HttpClient())
            {
                client.DefaultRequestHeaders.Add("secret_key", "0c37d6ef2d7b22245df03c87d3ff1590106e967653f88549712a0a31bb56608f");
                var verify = client.PostAsync("http://marketplace.gov.ae/myapi/OpportunitiesApi/CreateOpportunity", theContent).Result;
                var response = verify.Content.ReadAsStringAsync().Result;
            }
        }
        public static OpportunityFiles GetFile()
        {
            string path = @"C:\sample.xlsx";
            // Calling the ReadAllBytes() function 
            byte[] readText = File.ReadAllBytes(path);
            var stringFile = Convert.ToBase64String(readText);
            return new OpportunityFiles { FileName = "sample.xlsx", FileString = stringFile };
        }
    
                            
                        
illustration-bg

List your agency and become a member of TRA Place NOW!

GET listed now
close
Security and Identity

Asset Technology Group

Read More
(1)
Security and Identity

BNSights

Read More
(1)
Security and Identity

Creative Technology Solutions

IT Infrastructure

Provider of turnkey technology services based in Dubai, United Arab Emirates. The company provides hardware, software, m...

Security and Identity

MidChains

Web and software development

Developer of a financial platform built to offer assistance in institutional crypto asset trading. The company's platfor...

Security and Identity

Nybl

Web and software development

Developer of a machine learning platform designed to provide real-time analytics of business workflow. The company's pla...

Security and Identity

OjaBox

Web and software development

Provider of a cloud-based platform designed to host and manage 3D projects. The company's platform offers creation and a...

Security and Identity

Omnix International

Enterprise Solutions

Operator of a diversified information technology company. The company offers information technology (IT) and services, p...

Security and Identity

Paramount Computer Systems

Information Security solutions

provider of cybersecurity solutions intended to offer comprehensive cybersecurity measures. The company offers cloud sec...

Security and Identity

Potential.com

Enterprise Solutions

Operator of an e-learning platform intended to offer customized online learning solutions. The company's platform provid...

Security and Identity

Reinsurance Mart

Web and software development

Developer of Internet-based applications for the reinsurance market. The company focuses on providing an online platform...

Infrastructure as a services

Ministry of Economy

Collabration

Prime Ministers Office

Collabration

United Arab Emirates Ministry of interior

Collabration

National Emergency Crisis and Disaster Managemens

Collabration

National Qualifications Authority

Security and Identity

Asset Technology Group

Read More
(1)
Security and Identity

BNSights

Read More
(1)
Security and Identity

Creative Technology Solutions

IT Infrastructure

Provider of turnkey technology services based in Dubai, United Arab Emirates. The company provides hardware, software, m...

Security and Identity

MidChains

Web and software development

Developer of a financial platform built to offer assistance in institutional crypto asset trading. The company's platfor...

Security and Identity

Nybl

Web and software development

Developer of a machine learning platform designed to provide real-time analytics of business workflow. The company's pla...

Security and Identity

OjaBox

Web and software development

Provider of a cloud-based platform designed to host and manage 3D projects. The company's platform offers creation and a...

Security and Identity

Omnix International

Enterprise Solutions

Operator of a diversified information technology company. The company offers information technology (IT) and services, p...

Security and Identity

Paramount Computer Systems

Information Security solutions

provider of cybersecurity solutions intended to offer comprehensive cybersecurity measures. The company offers cloud sec...

Security and Identity

Potential.com

Enterprise Solutions

Operator of an e-learning platform intended to offer customized online learning solutions. The company's platform provid...

Security and Identity

Reinsurance Mart

Web and software development

Developer of Internet-based applications for the reinsurance market. The company focuses on providing an online platform...

Infrastructure as a services

Ministry of Economy

Collabration

Prime Ministers Office

Collabration

United Arab Emirates Ministry of interior

Collabration

National Emergency Crisis and Disaster Managemens

Collabration

National Qualifications Authority