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

category

String

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

Tribal Experience

Consultancy ,Digital Marketing ,Enterprise Solutions ,Managed Services ,Mobile App Development ,Web and software development

We are highly experienced strategists, researchers, UX Designer and Data scientist with a collective drive to make a dif...

Security and Identity

QlqzzNwr

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

Algorythma

Mobile App Development ,Web and software development

Owner and operator of a technology company intended to build mobile applications and Web-based platforms. The company's ...

Security and Identity

Alfan Group

Digital Marketing

Developer of an advertising platform designed to provide services for online businesses and brands. The company's platfo...

Security and Identity

Beam Portal

Web and software development

developer of an online mobile payments application intended to promote cashless transactions in United Arab Emirates.The...

Security and Identity

Almentor.net

Web and software development

Developer of an e-learning platform intended to develop human skills and abilities. The company's platform offers online...

Security and Identity

Clicksco

Digital Marketing

Developer of a SaaS-based digital marketing platform designed to offer performance marketing services to business organi...

Security and Identity

Code Brew Labs

Mobile App Development

Provider of mobile application development services created to provide technological solutions for businesses. The compa...

Security and Identity

Clicksco Financial Services

Digital Marketing

Provider of digital marketing services. The company focuses on performance marketing within which it operates consumer w...

Collabration

National Qualifications Authority

Collabration

National Emergency Crisis and Disaster Managemens

Collabration

Prime Ministers Office

Infrastructure as a services

Ministry of Economy

Collabration

United Arab Emirates Ministry of interior

Security and Identity

Tribal Experience

Consultancy ,Digital Marketing ,Enterprise Solutions ,Managed Services ,Mobile App Development ,Web and software development

We are highly experienced strategists, researchers, UX Designer and Data scientist with a collective drive to make a dif...

Security and Identity

QlqzzNwr

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

Algorythma

Mobile App Development ,Web and software development

Owner and operator of a technology company intended to build mobile applications and Web-based platforms. The company's ...

Security and Identity

Alfan Group

Digital Marketing

Developer of an advertising platform designed to provide services for online businesses and brands. The company's platfo...

Security and Identity

Beam Portal

Web and software development

developer of an online mobile payments application intended to promote cashless transactions in United Arab Emirates.The...

Security and Identity

Almentor.net

Web and software development

Developer of an e-learning platform intended to develop human skills and abilities. The company's platform offers online...

Security and Identity

Clicksco

Digital Marketing

Developer of a SaaS-based digital marketing platform designed to offer performance marketing services to business organi...

Security and Identity

Code Brew Labs

Mobile App Development

Provider of mobile application development services created to provide technological solutions for businesses. The compa...

Security and Identity

Clicksco Financial Services

Digital Marketing

Provider of digital marketing services. The company focuses on performance marketing within which it operates consumer w...

Collabration

National Qualifications Authority

Collabration

National Emergency Crisis and Disaster Managemens

Collabration

Prime Ministers Office

Infrastructure as a services

Ministry of Economy

Collabration

United Arab Emirates Ministry of interior