# Retrieve a list of tenders. ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /tenders: get: summary: Retrieve a list of tenders. deprecated: false description: >- 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. tags: - Tenders - Tenders parameters: - name: only_new_tenders in: query description: Filter only new tenders for account (de-duplication). schema: type: boolean - name: city_id in: query description: >- Filter tenders by one or more city IDs. Accepts a single city ID (for example, 1) or comma-separated city IDs (for example, 1,2,34). schema: type: string - name: region_id in: query description: >- Filter tenders by one or more region IDs. Accepts a single region ID (for example, 1) or comma-separated region IDs (for example, 1,2,34). schema: type: string - name: tender_activity_id in: query description: >- Filter tenders by one or more activity IDs. Accepts a single activity ID (for example, 1) or comma-separated activity IDs (for example, 1,2,34). schema: type: string - name: search in: query description: >- Search for tenders by keyword, reference number, titles, BoQ content. example: - '' schema: type: array items: type: string - name: include in: query description: >- Filter tenders by multiple keywords. Use comma-separated keywords (for example, construction,maintenance,supplies). schema: type: string - name: exclude in: query description: >- Filter out tenders by multiple keywords. Use comma-separated keywords (for example, cancelled,expired,training). schema: type: string - name: keyword_match_mode in: query description: >- Set the keyword matching mode for include and exclude filters. Allowed values are "and" or "or". schema: type: string - name: sub_tender_activity_id in: query description: >- Filter tenders by one or more sub-activity IDs. Accepts a single sub-activity ID (for example, 1) or comma-separated sub-activity IDs (for example, 1,2,34). schema: type: string - name: agency_id in: query description: >- Filter tenders by one or more agency IDs. Accepts a single agency ID (for example, 1) or comma-separated agency IDs (for example, 1,2,34). schema: type: string - name: tender_type_id in: query description: >- Filter tenders by one or more type IDs. Accepts a single type ID (for example, 1) or comma-separated type IDs (for example, 1,2,34). schema: type: string - name: last_enquiries_date_from in: query description: Filter tenders with enquiries from this date. schema: type: string - name: last_enquiries_date_to in: query description: Filter tenders with enquiries until this date. schema: type: string - name: last_offer_presentation_date_from in: query description: Filter tenders with presentations from this date. schema: type: string - name: last_offer_presentation_date_to in: query description: Filter tenders with presentations until this date. schema: type: string - name: offers_opening_date_from in: query description: Filter tenders with offer openings from this date. schema: type: string - name: offers_opening_date_to in: query description: Filter tenders with offer openings until this date. schema: type: string - name: submitted_from in: query description: Filter tenders submitted from this date. schema: type: string - name: submitted_to in: query description: Filter tenders submitted until this date. schema: type: string - name: offer_opening_date_from in: query description: Filter tenders with offer openings from this date. schema: type: string - name: offer_opening_date_to in: query description: Filter tenders with offer openings until this date. schema: type: string - name: offer_study_date_from in: query description: Filter tenders with offer studies from this date. schema: type: string - name: offer_study_date_to in: query description: Filter tenders with offer studies until this date. schema: type: string - name: tender_accept_date_from in: query description: Filter tenders with acceptance from this date. schema: type: string - name: tender_accept_date_to in: query description: Filter tenders with acceptance until this date. schema: type: string - name: exc_start_date_from in: query description: Filter tenders with execution start from this date. schema: type: string - name: exc_start_date_to in: query description: Filter tenders with execution start until this date. schema: type: string - name: insideKSA in: query description: Filter tenders inside Saudi Arabia. schema: type: boolean - name: only_available in: query description: Filter only available tenders. schema: type: boolean - name: only_active_tenders in: query description: Filter only active tenders. schema: type: boolean - name: only_tenders_with_no_initial_warranty in: query description: Filter tenders without initial warranty. schema: type: boolean - name: only_tenders_with_no_final_warranty in: query description: Filter tenders without final warranty. schema: type: boolean - name: hasInvitations in: query description: Filter tenders with invitations. schema: type: boolean - name: has_proposals in: query description: Returns only tenders that has been awarded schema: type: boolean - name: sort in: query description: Sort column for the tenders. schema: type: string - name: order in: query description: Sort order for the tenders (asc or desc). schema: type: string - name: page in: query description: Paginate through data schema: type: string - name: page_size in: query description: Number of tenders per page, defaults to 15 schema: type: string - name: Authorization in: header description: '' example: Bearer {{api-key}} schema: type: string default: Bearer {{api-key}} responses: '200': description: Successful response with tender data. content: application/json: schema: type: object properties: data: type: array items: type: object properties: tender_uid: type: string reference_number: type: string tender_name: type: string tender_number: type: string branch_name: type: string agency_name: type: string tender_status_name: type: string tender_type_name: type: string conditional_booklet_price: type: string offers_opening_date: type: 'null' inside_ksa: type: boolean submission_date: type: string has_invitations: type: integer remaining_days: type: integer remaining_hours: type: integer remaining_mins: type: number etimad_link: type: string submission_method: type: string tender_docs_fees_as_is: type: integer offer_opening_date: type: 'null' offer_study_date: type: string tender_accept_date: type: string exc_start_date: type: string tender_specifications: type: 'null' description: type: string submitted_at: type: string last_presentation_at: type: string inquires_opening_date: type: string inquires_answers_days: type: 'null' procurement: type: boolean construction: type: boolean maintenance: type: boolean tender_purpose: type: string contract_duration: type: string contract_days: type: integer insured_tender: type: integer required_warranty: type: string is_required_warranty: type: boolean required_warranty_amount: type: 'null' offers_opening_location: type: string contractor_category: type: string is_required_contractor_category: type: boolean is_local_prefered: type: boolean is_sme_prefered: type: boolean initial_warranty_location: type: 'null' region: type: object properties: text: type: string id: type: integer required: - text - id x-apidog-orders: - text - id city: type: object properties: text: type: string id: type: integer required: - text - id x-apidog-orders: - text - id activity: type: object properties: text: type: string id: type: integer required: - text - id x-apidog-orders: - text - id sub_activity: type: object properties: text: type: string id: type: integer required: - text - id x-apidog-orders: - text - id agency: type: object properties: text: type: string id: type: integer required: - text - id x-apidog-orders: - text - id tender_type: type: object properties: text: type: string id: type: integer required: - text - id x-apidog-orders: - text - id tender_source: type: string tender_tsd_data: type: object properties: id: type: integer tender_id: type: integer quantity_tables: type: array items: type: array items: type: array items: type: string contact_info: type: array items: type: array items: type: string required: - id - tender_id - quantity_tables - contact_info x-apidog-orders: - id - tender_id - quantity_tables - contact_info proposals: type: array items: type: object properties: vendor_name: type: string technical_match: type: boolean price: type: integer formatted_price: type: string awarding_value: type: integer formatted_awarding_value: type: string status: type: boolean x-apidog-orders: - vendor_name - technical_match - price - formatted_price - awarding_value - formatted_awarding_value - status tsd_url: type: string attachments: type: object properties: tender_id: type: integer files_count: type: integer urls: type: array items: type: object properties: original_name: type: string url: type: string required: - original_name - url x-apidog-orders: - original_name - url expires_in_minutes: type: integer required: - tender_id - files_count - urls - expires_in_minutes x-apidog-orders: - tender_id - files_count - urls - expires_in_minutes criteria: type: object properties: id: type: integer tender_id: type: integer simplified_data: type: array items: type: object properties: weight: type: integer criteria: type: array items: type: object properties: name: type: string weight: type: 'null' passScore: type: 'null' childCriteria: type: array items: type: object properties: name: type: string weight: type: integer passScore: type: integer nullable: true evaluationScore: type: 'null' required: - name - weight - passScore - evaluationScore x-apidog-orders: - name - weight - passScore - evaluationScore evaluationScore: type: 'null' required: - name - weight - passScore - childCriteria - evaluationScore x-apidog-orders: - name - weight - passScore - childCriteria - evaluationScore passScore: type: integer nullable: true criterionType: type: integer criterionTypeName: type: string required: - weight - criteria - passScore - criterionType - criterionTypeName x-apidog-orders: - weight - criteria - passScore - criterionType - criterionTypeName created_at: type: string updated_at: type: string required: - id - tender_id - simplified_data - created_at - updated_at x-apidog-orders: - id - tender_id - simplified_data - created_at - updated_at x-apidog-orders: - tender_uid - reference_number - tender_name - tender_number - branch_name - agency_name - tender_status_name - tender_type_name - conditional_booklet_price - offers_opening_date - inside_ksa - submission_date - has_invitations - remaining_days - remaining_hours - remaining_mins - etimad_link - submission_method - tender_docs_fees_as_is - offer_opening_date - offer_study_date - tender_accept_date - exc_start_date - tender_specifications - description - submitted_at - last_presentation_at - inquires_opening_date - inquires_answers_days - procurement - construction - maintenance - tender_purpose - contract_duration - contract_days - insured_tender - required_warranty - is_required_warranty - required_warranty_amount - offers_opening_location - contractor_category - is_required_contractor_category - is_local_prefered - is_sme_prefered - initial_warranty_location - region - city - activity - sub_activity - agency - tender_type - tender_source - tender_tsd_data - proposals - tsd_url - attachments - criteria required: - data x-apidog-orders: - data example: data: - tender_uid: '996114' reference_number: '250939007493' tender_name: J-MA-STAPLES STANDARD CHISEL POINT (BOX/5000)-JR704906 tender_number: JR704906 branch_name: إدارة المشتريات - مدينة الملك عبدالعزيز الطبية بجدة agency_name: الشؤون الصحیة بوزارة الحرس الوطني tender_status_name: معتمدة tender_type_name: شراء مباشر conditional_booklet_price: '0.00' offers_opening_date: null inside_ksa: true submission_date: '2025-09-14 12:49:49' has_invitations: 1 remaining_days: -1 remaining_hours: -5 remaining_mins: -49.56159146666687 etimad_link: >- https://tenders.etimad.sa/Tender/DetailsForVisitor?STenderId=pYt5AkG5mX7Bkh59a4hm%20A== submission_method: ملف واحد للعرض الفني والمالي معا tender_docs_fees_as_is: 200 offer_opening_date: null offer_study_date: '2025-09-18 00:00:00' tender_accept_date: '2025-12-14 00:00:00' exc_start_date: '2025-12-18 00:00:00' tender_specifications: null description: >- منافسة J-MA-STAPLES STANDARD CHISEL POINT (BOX/5000)-JR704906 برقم مرجعي "250939007493". تهدف إلى توريد مواد لصالح مدينة الملك عبدالعزيز الطبية بجدة. مكان التنفيذ هو في المملكة العربية السعودية، منطقة مكة المكرمة، جدة. ونشاط المنافسة هو تجارة الأدوات والآلات والأجهزة. حالة المنافسة هي معتمدة. نوع المنافسة هو شراء مباشر. وتصدر من الشؤون الصحیة بوزارة الحرس الوطني. وطريقة تقديم العروض هي ملف واحد للعرض الفني والمالي معا. سيتم فتح المجال لإرسال الأسئلة والإستفسارات بتاريخ 2025-09-14. وآخر موعد لاستلام الاستفسارات هو 2025-09-16T12:49:49.1448354. آخر موعد لتقديم العروض هو 2025-09-18T09:59:00. وسيتم فحص العروض في 2025-09-18. التاريخ المتوقع للترسية هو 2025-12-14. وتاريخ بدء الأعمال / الخدمات هو 2025-12-18. للتفاصيل الكاملة، يمكن الاطلاع عليها في الاسفل: submitted_at: '2025-09-14 12:49:49' last_presentation_at: '2025-09-18T09:59:00.000000Z' inquires_opening_date: '2025-09-14 00:00:00' inquires_answers_days: null procurement: false construction: false maintenance: false tender_purpose: توريد مواد لصالح مدينة الملك عبدالعزيز الطبية بجدة contract_duration: 1 سنة contract_days: 365 insured_tender: 0 required_warranty: لا يوجد ضمان is_required_warranty: false required_warranty_amount: null offers_opening_location: لا يوجد contractor_category: غير مطلوب is_required_contractor_category: false is_local_prefered: false is_sme_prefered: false initial_warranty_location: null region: text: منطقة مكة المكرمة id: 2 city: text: جدة id: 4 activity: text: التجارة id: 1 sub_activity: text: تجارة الأدوات والآلات والأجهزة id: 8 agency: text: الشؤون الصحیة بوزارة الحرس الوطني id: 27 tender_type: text: شراء مباشر id: 2 tender_source: https://tendersalerts.com tender_tsd_data: id: 296395 tender_id: 318641 quantity_tables: - - - الرقم التسلسلي - الفئة - البند - وحدة القياس - وصف البند - المواصفات - منتج من القائمة الإلزامية - الرمز الإنشائي - الكمية - - '1' - صناعي - JR704906 - Box - STAPLES STANDARD CHISEL POINT (BOX/5000) - STAPLES STANDARD CHISEL POINT (BOX/5000) - لا - null - '2000' - - - الفئة - البند - وحدة القياس - وصف البند - المواصفات - - صناعي - JR704906 - Box - STAPLES STANDARD CHISEL POINT (BOX/5000) - STAPLES STANDARD CHISEL POINT (BOX/5000) contact_info: - - معلومات اتصال ممثل الجهة - - الإسم - TEST - - الوظيفة - اخصائي مشتريات حكومية - - الهاتف - '0000000000' - - الفاكس - '0000000000' - - البريد اللكتروني - alamrima@TESTTEST proposals: - vendor_name: شركة الأمين للتجهيزات الطبية والعلمية technical_match: true price: 80000 formatted_price: 80 ألف awarding_value: 80000 formatted_awarding_value: 80 ألف status: true tsd_url: >- https://api.tendersalerts.com/api/tender-tsd/318641?signature=9f6f7bcccae7b2bb46a89e964ec65f2552460b27d5abe2c918984cfbcb493dd8 attachments: tender_id: 331099 files_count: 7 urls: - original_name: جدول الكميات.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/dyUNb2G1GdZuqkphpVGx7dWb2UG7D0ZjoeEs4F3S.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224424Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=a692cb665209fda1992f6075f9856b59b5b69e7a8c2da69bb21a23fb019cabb5 - original_name: معايير تقييم العروض.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/ywj1l5G4lgYkXD6Swl9jocXRCSHih5g6NxEP4d78.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224424Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=94215c872cb55a9c743524e8d83ed6c5ba3bfeee10348cce4c742bf9421108dd - original_name: معايير التأهيل اللاحق للمتنافسين.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/gH6LxqEpQMYQXqy9jnv0aMBGl5fusRZ7ikaWU90c.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224425Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=6b1106f5797a7a74226b58b54ddee6c2f80f8b7eb57cfe8ff133fb5e9a888988 - original_name: تقرير دراسة.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/KT8IF9ZyiV2sSc8b5K24IjUeBy3a51EgVSjR8tYH.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224425Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=dec957c99ee82b37bf8e1549951e83544f1080f99f00392642bef9c4799a7ce9 - original_name: نموذج شامل لتقييم الحالة الإنشائية للمبنى.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/pJi48sKJfKFDPO1G2eOm2jeZ6oxtEXSudIDFMt6d.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224425Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=c62cc3b545a52739b9696c8fc97e19837dcc2d1e8b3f299221e80ba9b68c262b - original_name: الدراسة الجيوتقنية.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/jUmvaQ7W5H34RTSObuOpxXE5078ifMcLRoLbOg15.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224425Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=b6c211628712d76c4cc0b74f861097234b8f9dde3addae79079ecd3ae915aeaf - original_name: مخططات.pdf url: >- https://hel1.your-objectstorage.com/tendersalerts/tender_attachments/w6W0AIMzMIMi3lHVYup5wLSZ2HeykYPLJchiIGmi.pdf?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ETZL2IT997EXG7REJ3FQ%2F20251217%2Fhel1%2Fs3%2Faws4_request&X-Amz-Date=20251217T224425Z&X-Amz-SignedHeaders=host&X-Amz-Expires=604800&X-Amz-Signature=2ebeb5239d2b3825d85f56d470e2f5b0fce55059f08136de9d3081e25d8d1aee expires_in_minutes: 10080 criteria: id: 10726 tender_id: 331099 simplified_data: - weight: 70 criteria: - name: >- الخبرات السابقة من خلال تقديم بيان بالأعمال المشابهة في نفس مجال عمل هذا العقد مع إرفاق المستندات المؤيدة لذلك weight: null passScore: null childCriteria: - name: >- الخبرات السابقة من خلال تقديم بيان بالأعمال المشابهة في نفس مجال عمل هذا العقد مع إرفاق المستندات المؤيدة لذلك weight: 30 passScore: null evaluationScore: null evaluationScore: null - name: >- خبرات فريق العمل وتشمل تقديم بيانات تفصيلية تتضمن الأسماء والمؤهلات والخبرات العملية التخصصية في مجال الأعمال المطلوبة. ( weight: null passScore: null childCriteria: - name: >- خبرات فريق العمل وتشمل تقديم بيانات تفصيلية تتضمن الأسماء والمؤهلات والخبرات العملية التخصصية في مجال الأعمال المطلوبة. ( weight: 30 passScore: null evaluationScore: null evaluationScore: null - name: مستندات التعامل مع الجهات الحكومية weight: null passScore: null childCriteria: - name: مستندات التعامل مع الجهات الحكومية weight: 20 passScore: null evaluationScore: null evaluationScore: null - name: شهادة تصنيف في مجال الأعمال المطلوبة. weight: null passScore: null childCriteria: - name: شهادة تصنيف في مجال الأعمال المطلوبة. weight: 10 passScore: null evaluationScore: null evaluationScore: null - name: منهجية إنجاز الخدمات weight: null passScore: null childCriteria: - name: منهجية إنجاز الخدمات weight: 10 passScore: null evaluationScore: null evaluationScore: null passScore: 70 criterionType: 1 criterionTypeName: التقييم الفني - weight: 30 criteria: - name: السعر weight: null passScore: null childCriteria: - name: التكلفة الكلية weight: 100 passScore: 0 evaluationScore: null evaluationScore: null passScore: null criterionType: 2 criterionTypeName: التقييم المالي created_at: '2025-12-17T21:38:40.000000Z' updated_at: '2025-12-17T21:38:40.000000Z' headers: {} x-apidog-name: OK '400': description: Bad request due to missing or invalid parameters. content: application/json: schema: type: object properties: {} x-apidog-orders: [] headers: {} x-apidog-name: Bad Request '401': description: Unauthorized. The API key is missing or invalid. content: application/json: schema: type: object properties: error: type: string required: - error x-apidog-orders: - error example: error: Unauthorized headers: {} x-apidog-name: Unauthorized '500': description: Internal server error. content: application/json: schema: type: object properties: {} x-apidog-orders: [] headers: {} x-apidog-name: Server Error security: [] x-apidog-folder: Tenders x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/772525/apis/api-12818631-run components: schemas: {} securitySchemes: Tenders Alerts: type: bearer scheme: bearer hmacSignature: type: apikey in: header name: X-Webhook-Signature description: >- HMAC SHA256 signature of the request body using your webhook secret. Format: sha256= servers: - url: https://api.tendersalerts.com/api/integration description: Prod Env security: [] ```