Tenders API Documentation

Overview:

The TendersOnTime API is a REST-based service that allows users to retrieve tender data strictly based on the tender posting date.

This API is designed for daily data synchronization. Users are expected to pull tender data for a specific posting date, store it in their own database, and apply any additional filters or business logic within their own application.

All keywords, regions, and classification filters are pre-configured and managed at the TendersOnTime backend based on mutually finalized requirements.

---

Base URL:
https://tmproject.tendersontime.org/tmpApi/tender-pull-json-tot.php

---

Authentication:

Authentication is mandatory for all requests.

username (required): Your API username.

key (required): Your API key for authentication.

---

Endpoints:

1. Retrieve Tenders by Date

Retrieve all tenders posted on a specific date.

• Method: GET
• Endpoint: /tender-pull-json-tot.php
• Parameters:

Request Fields	Field type	Field Description
username	string	required, Your API username.
key	string	required, Your API key for authentication.
date	string	required, Date of posting in YYYY-MM-DD format.

The API does not accept any additional filters apart from the date parameter.

Keyword, region, and category filtering is handled internally at the backend.

• Success Response:
• Status: 200 OK
• Content-Type: application/json
• Body:
JSON   Copy

{
  "status": "success",
  "message": "tender success",
  "posting_date": "YYYY-MM-DD",
  "total": 00,
  "data": [
    {
      // Tender data object
    }
  ]
}



• Error Response:
• Status: 400 Bad Request
• Content-Type: application/json
• Body:
JSON   Copy

{
  "status": "error",
  "message": "Error Message",
  "data": []
}

---

Sample Request:

Sample Response:

{
  "status": "success",
  "message": "tender success",
  "posting_date": "2024-01-18",
  "total": 20,
  "data": [
    {
      // Tender data object
    },
    {
      // Tender data object
    },
    ...
  ]
}

---

Recommended Data Synchronization Strategy

To ensure timely and complete tender data coverage, we recommend the following synchronization approach:

• Newly published tenders are synchronized to the API backend at a maximum interval of every 3 hours. To keep your system up to date, you may pull current-day tender data every 3 hours using the current posting date.
• This periodic pull ensures that any tenders published throughout the day are captured in near real-time within your system.
• On the following day, we strongly recommend performing one final pull for the previous day’s posting date. This ensures that all tenders published on that day—including any late updates—are fully retrieved and stored in your database.

---

Notes:

• Ensure to use valid credentials (username and key) for authentication.
• Handle error responses gracefully by checking the status and message fields in the response.
• In the provided Sample API endpoint for fetching tender data is not based on date parameter in this API documentation.