Tenders API Documentation

Overview:

The TendersOnTime API provides access to tender information for a given date. Users can retrieve tenders posted on a specific date, with pagination support for navigating through the results.

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

---

Authentication:

username (required): Your API username.
key (required): Your API key for authentication.

---

Endpoints:

1. Retrieve Tenders by Date

Retrieve 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.
page	integer	optional, Page number for pagination (default: 1).
perpage	integer	optional, Limit of items per page (default: 10).

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

{
  "status": "success",
  "message": "tender success",
  "posting_date": "YYYY-MM-DD",
  "page_no": 1,
  "pagination": {
    "total_items": 100,
    "per_page": 10,
    "first_page": 1,
    "last_page": 10
  },
  "data": [
    {
      // Tender data object
    }
  ],
  "last_id": "last_item_id",
  "time_stamp": "YYYY-MM-DD HH:MM:SS"
 }



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

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

---

Sample Request:

Sample Response:

{
  "status": "success",
  "message": "tender success",
  "posting_date": "2024-01-18",
  "page_no": 1,
  "pagination": {
    "total_items": 20,
    "per_page": 5,
    "first_page": 1,
    "last_page": 4
  },
  "data": [
    {
      // Tender data object
    },
    {
      // Tender data object
    },
    ...
  ],
  "last_id": "last_item_id",
  "time_stamp": "2024-02-19 10:30:00"
}

---

Notes:

• Pagination is supported to retrieve large sets of data efficiently.
• 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.