Retrieve a list of tenders.

This endpoint retrieves detailed information about available tenders. It allows filtering by various criteria, such as city, region, agency, activity, and multiple date ranges, to refine the results. Sorting and ordering parameters can be applied to customize the output. This endpoint provides essential data, including submission deadlines, tender statuses, and related agency details. It is designed to support comprehensive queries for tenders in a structured and efficient manner.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

only_new_tenders

boolean

optional

Filter only new tenders for account (de-duplication).

Example:

true

city_id

integer

optional

Filter tenders by city ID.

Example:

region_id

integer

optional

Filter tenders by region ID.

Example:

tender_activity_id

integer

optional

Filter tenders by activity ID.

Example:

string

optional

Search for tenders by keyword.

Example:

risk management

sub_tender_activity_id

integer

optional

Filter tenders by sub-activity ID.

Example:

agency_id

integer

optional

Filter tenders by agency ID.

Example:

816

tender_type_id

integer

optional

Filter tenders by type ID.

Example:

last_enquiries_date_from

string <date>

optional

Filter tenders with enquiries from this date.

Example:

2024-12-01

last_enquiries_date_to

string <date>

optional

Filter tenders with enquiries until this date.

Example:

2024-12-10

last_offer_presentation_date_from

string <date>

optional

Filter tenders with presentations from this date.

Example:

2024-12-01

last_offer_presentation_date_to

string <date>

optional

Filter tenders with presentations until this date.

Example:

2024-12-10

offers_opening_date_from

string <date>

optional

Filter tenders with offer openings from this date.

Example:

2025-01-01

offers_opening_date_to

string <date>

optional

Filter tenders with offer openings until this date.

Example:

2025-01-15

submitted_from

string <date>

optional

Filter tenders submitted from this date.

Example:

2024-11-01

submitted_to

string <date>

optional

Filter tenders submitted until this date.

Example:

2024-12-01

offer_opening_date_from

string <date>

optional

Filter tenders with offer openings from this date.

Example:

2025-01-01

offer_opening_date_to

string <date>

optional

Filter tenders with offer openings until this date.

Example:

2025-01-15

offer_study_date_from

string <date>

optional

Filter tenders with offer studies from this date.

Example:

2025-01-16

offer_study_date_to

string <date>

optional

Filter tenders with offer studies until this date.

Example:

2025-01-31

tender_accept_date_from

string <date>

optional

Filter tenders with acceptance from this date.

Example:

2025-02-01

tender_accept_date_to

string <date>

optional

Filter tenders with acceptance until this date.

Example:

2025-02-15

exc_start_date_from

string <date>

optional

Filter tenders with execution start from this date.

Example:

2025-03-01

exc_start_date_to

string <date>

optional

Filter tenders with execution start until this date.

Example:

2025-03-15

insideKSA

boolean

optional

Filter tenders inside Saudi Arabia.

Example:

true

only_available

boolean

optional

Filter only available tenders.

Example:

true

only_active_tenders

boolean

optional

Filter only active tenders.

Example:

true

only_tenders_with_no_initial_warranty

boolean

optional

Filter tenders without initial warranty.

Example:

true

only_tenders_with_no_final_warranty

boolean

optional

Filter tenders without final warranty.

Example:

true

hasInvitations

boolean

optional

Filter tenders with invitations.

Example:

true

sort

string

optional

Sort column for the tenders.

Example:

submission_date

order

enum<string>

optional

Sort order for the tenders (asc or desc).

Allowed values:

ascdesc

Example:

desc

Header Params

Authorization

string

optional

Default:

Bearer {{api-key}}

Responses

🟢200OK

application/json

Successful response with tender data.

Body

data

array[object (TenderItem) {49}]

optional

tender_uid

string

optional

The unique identifier for the tender.

Example:

878910

reference_number

string

optional

The reference number of the tender.

Example:

241239003005

tender_name

string

optional

The name of the tender.

Example:

تشغيل وتنفيذ إدارة المخاطر المؤسسية

branch_name

string

optional

The branch handling the tender.

Example:

إدارة المشتريات والعقود

agency_name

string

optional

The agency issuing the tender.

Example:

وزارة العدل - الديوان العام

tender_status_name

string

optional

The status of the tender.

Example:

معتمدة

tender_type_name

string

optional

The type of the tender.

Example:

منافسة عامة

conditional_booklet_price

string

optional

The price for the booklet if conditional.

Example:

0.00

offers_opening_date

string <date-time>

optional

The date and time for opening offers.

Example:

2025-01-27T10:00:00Z

inside_ksa

boolean

optional

Indicates if the tender is inside Saudi Arabia.

Example:

true

submission_date

string <date-time>

optional

The submission deadline for the tender.

Example:

2024-12-27T10:21:49Z

has_invitations

integer

optional

Indicates whether the tender has invitations.

Example:

remaining_days

integer

optional

Remaining days to submit the tender.

Example:

remaining_hours

integer

optional

Remaining hours to submit the tender.

Example:

remaining_mins

number

optional

Remaining minutes to submit the tender.

Example:

19.08527

etimad_link

string

optional

The Etimad link for the tender details.

Example:

https://tenders.etimad.sa/Tender/DetailsForVisitor?STenderId=iDRHuS8M%20I9B5G6cjMQ*@@**5g==

submission_method

string

optional

The method of submission for the tender.

Example:

ملفين منفصلين ( فني ومالي)

tender_docs_fees_as_is

integer

optional

The fees for the tender documents.

Example:

1000

offer_opening_date

string <date-time>

optional

The date and time for opening offers.

Example:

2025-01-27T00:00:00Z

offer_study_date

string <date-time>

optional

The date for studying the offers.

Example:

null

tender_accept_date

string <date-time>

optional

The date for accepting the tender.

Example:

2025-02-16T00:00:00Z

exc_start_date

string <date-time>

optional

The date for starting execution of the tender.

Example:

2025-03-09T00:00:00Z

tender_specifications

string

optional

Specifications of the tender.

Example:

null

description

string

optional

Detailed description of the tender.

Example:

منافسة تشغيل وتنفيذ...

submitted_at

string <date-time>

optional

The submission time of the tender.

Example:

2024-12-27T10:21:48Z

last_presentation_at

string <date-time>

optional

The last presentation time for the tender.

Example:

2025-01-27T09:59:00.000000Z

inquires_opening_date

string <date-time>

optional

The date for opening inquiries.

Example:

2024-12-27T00:00:00Z

inquires_answers_days

integer

optional

Number of days to answer inquiries.

Example:

procurement

boolean

optional

Indicates if the tender is for procurement.

Example:

false

construction

boolean

optional

Indicates if the tender is for construction.

Example:

false

maintenance

boolean

optional

Indicates if the tender is for maintenance.

Example:

false

tender_purpose

string

optional

The purpose of the tender.

Example:

لاحقا للقرار الصادر...

contract_duration

string

optional

The contract duration of the tender.

Example:

36 شهر

contract_days

integer

optional

The contract duration in days.

Example:

1080

insured_tender

integer

optional

Indicates if the tender is insured.

Example:

required_warranty

string

optional

The type of warranty required.

Example:

ضمان إبتدائى

is_required_warranty

boolean

optional

Indicates if a warranty is required.

Example:

true

required_warranty_amount

string

optional

The amount of the warranty required.

Example:

5.00

offers_opening_location

string

optional

The location for opening offers.

Example:

الرياض

contractor_category

string

optional

The category of contractors required.

Example:

غير مطلوب

is_required_contractor_category

boolean

optional

Indicates if a contractor category is required.

Example:

false

is_local_prefered

boolean

optional

Indicates if local contractors are preferred.

Example:

false

is_sme_prefered

boolean

optional

Indicates if SMEs are preferred.

Example:

true

initial_warranty_location

string

optional

The location for submitting the initial warranty.

Example:

شارع الجامعة ديوان الوزارة الدور الخامس

region

object

optional

The region related to the tender.

city

object

optional

The city related to the tender.

activity

object

optional

The activity related to the tender.

agency

object

optional

The agency related to the tender.

tender_source

string

optional

The source of the tender.

Example:

https://tendersalerts.com

Example

{
  "data": [
    {
      "tender_uid": "878910",
      "reference_number": "241239003005",
      "tender_name": "تشغيل وتنفيذ إدارة المخاطر المؤسسية",
      "branch_name": "إدارة المشتريات والعقود",
      "agency_name": "وزارة العدل - الديوان العام",
      "tender_status_name": "معتمدة",
      "tender_type_name": "منافسة عامة",
      "conditional_booklet_price": "0.00",
      "offers_opening_date": "2025-01-27T10:00:00Z",
      "inside_ksa": true,
      "submission_date": "2024-12-27T10:21:49Z",
      "has_invitations": 0,
      "remaining_days": 29,
      "remaining_hours": 12,
      "remaining_mins": 19.08527,
      "etimad_link": "https://tenders.etimad.sa/Tender/DetailsForVisitor?STenderId=iDRHuS8M%20I9B5G6cjMQ*@@**5g==",
      "submission_method": "ملفين منفصلين ( فني ومالي)",
      "tender_docs_fees_as_is": 1000,
      "offer_opening_date": "2025-01-27T00:00:00Z",
      "offer_study_date": null,
      "tender_accept_date": "2025-02-16T00:00:00Z",
      "exc_start_date": "2025-03-09T00:00:00Z",
      "tender_specifications": null,
      "description": "منافسة تشغيل وتنفيذ...",
      "submitted_at": "2024-12-27T10:21:48Z",
      "last_presentation_at": "2025-01-27T09:59:00.000000Z",
      "inquires_opening_date": "2024-12-27T00:00:00Z",
      "inquires_answers_days": 7,
      "procurement": false,
      "construction": false,
      "maintenance": false,
      "tender_purpose": "لاحقا للقرار الصادر...",
      "contract_duration": "36 شهر",
      "contract_days": 1080,
      "insured_tender": 0,
      "required_warranty": "ضمان إبتدائى",
      "is_required_warranty": true,
      "required_warranty_amount": "5.00",
      "offers_opening_location": "الرياض",
      "contractor_category": "غير مطلوب",
      "is_required_contractor_category": false,
      "is_local_prefered": false,
      "is_sme_prefered": true,
      "initial_warranty_location": "شارع الجامعة ديوان الوزارة الدور الخامس",
      "region": {
        "text": "منطقة الرياض",
        "id": 1
      },
      "city": {
        "text": "الرياض",
        "id": 3
      },
      "activity": {
        "text": "المهن الاستشارية",
        "id": 16
      },
      "agency": {
        "text": "وزارة العدل - الديوان العام",
        "id": 816
      },
      "tender_source": "https://tendersalerts.com"
    }
  ]
}

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Retrieve a list of tenders.

Request

Request samples

Responses