Download OpenAPI specification:
Welcome to the Bidassist Public API! This API provides programmatic access to a vast database of tenders and tender results (bid awards), allowing you to integrate real-time public procurement data into your applications.
To make your first successful API call, please follow these steps.
All requests to the Bidassist API must be authenticated. You will need to procure a secret API key from Bidassist and include it in every request in the x-api-key header.
Header:
x-api-keyValue:YOUR_SECRET_API_KEY
Keep your API key secure and do not share it publicly.
All API calls are made to the base URL listed below. The endpoint paths in this documentation should be appended to this base URL to form the complete URL for your request.
https://partner-api.bidassist.in/api/public/v1/tender/searchhttps://partner-api.bidassist.in/api/public/v1/tender/searchThe API enforces a rate limit of 5 requests per second, per API key. This limit is handled by the API Gateway. To help you manage your requests responsibly, successful responses include the following headers:
X-RateLimit-Limit: The total request limit per window (5).X-RateLimit-Remaining: The number of requests you have left in the current window.X-RateLimit-Reset: The timestamp when the limit will reset.If you exceed the limit, you will receive a 429 Too Many Requests error.
Note: Actual list of output fields may vary based on your plan.
Retrieves a paginated list of tenders based on a set of filters. The 'FEED_SOURCE_ID' filter is mandatory.
JSON object containing filters and pagination for the tender search.
required | object A map of filter keys to an array of string values. |
| pageNumber | integer Default: 0 The page number to retrieve (0-indexed). |
| pageSize | integer [ 1 .. 20 ] Default: 20 The number of items to retrieve per page. Minimum: 1, Maximum: 20. |
{- "filters": {
- "FEED_SOURCE_ID": [
- "src_12345"
], - "ENTITY_ID": [
- "9f2b85fe-276b-4a44-87b0-ed816bea2381"
], - "DATE_CREATED": [
- "1757389396000",
- "1757475796000"
]
}, - "pageNumber": 0,
- "pageSize": 20
}{- "data": [
- {
- "tenderId": "c473e854-e027-479d-b466-8d0f434681ef",
- "sourceTenderId": "GEM/2025/B/6658133",
- "tenderNoticeNo": "GEM/2025/B/6658133",
- "dateCreated": 1757389414667,
- "dateModified": 1757446040498,
- "postingDate": 1757388508000,
- "bidDeadline": 1759203000000,
- "value": 550000,
- "currency": "INR",
- "emd": "11000.0",
- "tenderFee": "500.0",
- "documentCost": "500.0",
- "workflowStatus": "PUBLISHED",
- "authority": {
- "name": "Indian Army"
}, - "location": {
- "city": "Pune",
- "state": "Maharashtra",
- "country": "India",
- "pincode": "411001"
}, - "secondaryLocations": [ ],
- "sector": [
- "Electronics Equipment",
- "Electrical and Electronics"
], - "tenderDetails": "Category: Solid State Convertor",
- "tenderDescription": "This is a detailed description for the procurement of Solid State Convertors for military application.",
- "source": "OFB",
- "sourceUrl": "bidplus.gem.gov.in",
- "isTenderValueEstimated"": false,
- "isUpdated": true,
- "documents": [
- {
- "name": "TenderNotice.pdf",
- "type": "NOTICE",
- "isUpdate"": false
}
], - "changedFields": [
- {
- "changedField": "TENDER_BIDDEADLINE",
- "meta"": null
}
], - "corrigendumInfo": [
- {
- "publishedDate": 1757400000000,
- "title": "The bid deadline has been extended by 24 hours."
}
], - "auctionStartDate": null,
- "auctionEndDate": null,
- "updatedDate": 1757446040498,
- "customLabels": {
- "Is Specified": "No",
- "Region": "ROM",
- "Construction Type": "Fresh"
}, - "makeListStatus": "Asian Paints Products Mentioned",
- "makeList": [
- {
- "rawProductName": "acrylic exterior paint",
- "productCategory": "Exterior Wall Finishes",
- "brandsMentioned": [
- "Asian Paints",
- "Dulux"
], - "isBrandSpecified": true,
- "productFamily": "Paints And Coatings"
}
], - "estimatedProductQuantity": {
- "items": [
- {
- "productFamily": "Paints And Coatings",
- "productCategory": "Exterior Wall Finishes",
- "subProductCategory": "Acrylic exterior paint",
- "quantity": "110",
- "unit": "L",
- "amount": 13750,
- "refBoqId": "cb434e5e-e02a-30ad-825a-5b1212b1409e"
}
]
}, - "aiInsights": {
- "scopeOfWork": "Supply and installation of painting works including surface preparation and application of exterior acrylic paint.",
- "projectMilestone": "- Commencement: 01/06/2025\n- Completion: 30/06/2025",
- "performanceSecurity": "5% of contract value",
- "insurance": "",
- "classOfBidder": "Class II & above",
- "certificationsRequired": "Valid GST registration, PAN card",
- "workExperienceRequirement": null,
- "bidCapacityRequirement": null,
- "technicalCapacityRequirement": null,
- "otherTechnicalSpecificationRequired": null,
- "turnoverRequirement": null,
- "networthRequirement": null,
- "liquidityRequirement": null,
- "creditFacilityRequirement": null,
- "otherFinancialRequirement": null,
- "defectLiabilityPeriod": null,
- "jvEligibility": null,
- "mobilizationAdvance": "",
- "mobilizationInterest": "",
- "listOfDocumentsRequired": null,
- "suretyBond": "Surety bond accepted in lieu of bank guarantee for performance security."
}, - "boqItems": [
- {
- "id": "cb434e5e-e02a-30ad-825a-5b1212b1409e",
- "rowNumber": 1,
- "itemDescription": "Painting three or more coats with acrylic exterior paint of approved brand including applying one coat of cement primer.",
- "quantity": 374.2,
- "units": "Sq. m",
- "rate": 208,
- "amount": 77833.6,
- "itemCode": null
}
], - "performanceSecurity": "5% of contract value",
- "bidToRaEnabled": "",
- "bidValidity": "90 days",
- "periodOfWork": "90 Days",
- "buyerDetails": null,
- "productInfos": null
}
], - "last": false
}Marks the given Tender(s) as SELECTED (interested) or REJECTED. Provide the entityIds (from a prior search response) along with the feedSourceId they belong to.
JSON object identifying the entities to mark and the action to apply.
| entityIds required | Array of strings The entity ids to mark the action for (the |
| feedSourceId required | string The feed source id the given |
| action required | string Enum: "SELECTED" "REJECTED" The action to mark for the given entities. Use |
| rejectedReason | string Enum: "Low Requirement" "Not matching the criteria" "Not eligible to participate" "Insufficient information" "Location Not Serviceable" "Other" Reason for rejection. Only applicable when |
| rejectedReasonRemark | string Additional remarks for the rejection. Required when |
{- "entityIds": [
- "c473e854-e027-479d-b466-8d0f434681ef"
], - "feedSourceId": "src_12345",
- "action": "SELECTED"
}{- "data": "Success",
- "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}Retrieves a paginated list of tender results (bid awards) based on a set of filters. The 'FEED_SOURCE_ID' filter is mandatory.
JSON object containing filters and pagination for the tender result search.
required | object A map of filter keys to an array of string values. |
| pageNumber | integer Default: 0 The page number to retrieve (0-indexed). |
| pageSize | integer [ 1 .. 20 ] Default: 20 The number of items to retrieve per page. Minimum: 1, Maximum: 20. |
{- "filters": {
- "FEED_SOURCE_ID": [
- "src_67890"
], - "ENTITY_ID": [
- "3cbde5e1-e451-4790-8622-93e670119a17"
], - "DATE_MODIFIED": [
- "1758222330000",
- "1758481627000"
]
}, - "pageNumber": 0,
- "pageSize": 10
}{- "data": [
- {
- "bidAwardId": "3cbde5e1-e451-4790-8622-93e670119a17",
- "tenderId": "1584388a-3fed-49c6-9dd4-35c46f3d4ba9",
- "sourceBidAwardId": "GEM/2025/B/6585087",
- "dateCreated": 1758206709245,
- "dateModified": 1758481627555,
- "postingDate": 1758206709245,
- "value": "525000.0",
- "location": {
- "city": "Vadodara",
- "state": "Gujarat",
- "country": "India",
- "pincode": "390007"
}, - "documents": [
- {
- "name": "AwardDetails.pdf",
- "type": "OTHER",
- "isUpdate": false
}
], - "changedFields": [
- {
- "changedField": "AWARDED",
- "meta": null
}
], - "isUpdated": true,
- "workflowStatus": "ARCHIVED",
- "bidderDetails": [
- {
- "bidderId": "bidder-001",
- "bidderName": "AIRTEK ENTERPRISE",
- "bidderAddress": "123 Tech Park, Vadodara",
- "awardedCurrency": "INR",
- "awardedValue": "522408.00",
- "bidValue": "522408.00",
- "contractNumber": "CN-2025-589",
- "contractIssueDate": 1758101400000,
- "dateOfCompletionOfSupply": 1765877400000,
- "workDescription": "Supply and installation.",
- "bidStatus": "Accepted-AOC",
- "bidRank": "L1",
- "offeredMake": "-",
- "offeredModel": "-",
- "addressType": "GST_LINKED",
- "addressCity": "Vadodara",
- "addressState": "Gujarat",
- "contactName": "Rajesh Kumar",
- "contactPhoneNumber": 9876543210,
- "contactDesignation": "Owner",
- "contactEmail": "info@airtekenterprise.com",
- "isAwarded": true
}, - {
- "bidderId": "bidder-002",
- "bidderName": "SHREE HARI ELETRICALS",
- "bidderAddress": null,
- "awardedCurrency": "INR",
- "awardedValue": null,
- "bidValue": "527433.60",
- "contractNumber": null,
- "contractIssueDate": null,
- "dateOfCompletionOfSupply": null,
- "workDescription": null,
- "bidStatus": "Accepted-Financial",
- "bidRank": "L2",
- "isAwarded": false
}
], - "aocDescription": "CATEGORY: Supplyof2TRSACCITYEXCH",
- "contractDate": 1758101400000,
- "isContractDateEstimated": true,
- "financialBidEvaluationDate": 1758015000000,
- "technicalBidEvaluationDate": 1757928600000,
- "financialBidOpeningDate": 1757842200000,
- "technicalBidOpeningDate": 1757755800000,
- "aocUpdationDate": 1758101400000,
- "authority": {
- "name": "Bharat Sanchar Nigam Limited",
- "purchaserContactNumber": null,
- "purchaserContactEmail": "procurement@bsnl.co.in",
- "purchaserContactPersonName": "General Manager",
- "purchaserContactPersonDesignation": "General Manager (Procurement)"
}, - "contractValue": "522408.00",
- "isContractValueEstimated": false,
- "bidAwardRefNo": "GEM/2025/B/6585087",
- "contractPeriod": "60",
- "bidResultStep": "Finalized",
- "bidAwardStage": "AOC_DATE",
- "bidAwardResultStage": "AOC Released",
- "category": [
- "Electronics Equipment",
- "Electrical and Electronics"
], - "customLabels": {
- "Is Specified": "No",
- "Region": "ROM",
- "Construction Type": "Fresh"
}, - "makeListStatus": "Asian Paints Products Mentioned",
- "makeList": [
- {
- "rawProductName": "acrylic exterior paint",
- "productCategory": "Exterior Wall Finishes",
- "brandsMentioned": [
- "Asian Paints",
- "Dulux"
], - "isBrandSpecified": true,
- "productFamily": "Paints And Coatings"
}
], - "estimatedProductQuantity": {
- "items": [
- {
- "productFamily": "Paints And Coatings",
- "productCategory": "Exterior Wall Finishes",
- "subProductCategory": "Acrylic exterior paint",
- "quantity": "110",
- "unit": "L",
- "amount": 13750,
- "refBoqId": "cb434e5e-e02a-30ad-825a-5b1212b1409e"
}
]
}, - "aiInsights": {
- "scopeOfWork": "Supply and installation of painting works.",
- "projectMilestone": "- Commencement: 01/06/2025\n- Completion: 30/06/2025",
- "performanceSecurity": "P. G. will be adjusted in the Bill.",
- "insurance": "",
- "classOfBidder": "Class II & above",
- "certificationsRequired": "Valid GST registration, PAN card",
- "workExperienceRequirement": null,
- "bidCapacityRequirement": null,
- "technicalCapacityRequirement": null,
- "otherTechnicalSpecificationRequired": null,
- "turnoverRequirement": null,
- "networthRequirement": null,
- "liquidityRequirement": null,
- "creditFacilityRequirement": null,
- "otherFinancialRequirement": null,
- "defectLiabilityPeriod": null,
- "jvEligibility": null,
- "mobilizationAdvance": "",
- "mobilizationInterest": "",
- "listOfDocumentsRequired": null
}, - "boqItems": [
- {
- "id": "cb434e5e-e02a-30ad-825a-5b1212b1409e",
- "rowNumber": 1,
- "itemDescription": "Painting three or more coats with acrylic exterior paint of approved brand including applying one coat of cement primer.",
- "quantity": 374.2,
- "units": "Sq. m",
- "rate": 208,
- "amount": 77833.6,
- "itemCode": null
}
], - "performanceSecurity": "P. G. will be adjusted in the Bill.",
- "bidToRaEnabled": "",
- "bidValidity": null,
- "buyerDetails": null,
- "productInfos": null,
- "auctionStartDate": null,
- "auctionEndDate": null,
- "scheduleWiseInfo": [
- {
- "scheduleTitle": "Schedule 1",
- "bidderName": "SHRI RAGHUNANDAN TRADERS",
- "price": 58350,
- "bidderRank": "L1"
}, - {
- "scheduleTitle": "Schedule 2",
- "bidderName": "SHRI RAGHUNANDAN TRADERS",
- "price": 75000,
- "bidderRank": "L1"
}, - {
- "scheduleTitle": "Schedule 3",
- "bidderName": "ANAISHA ENTERPRISES",
- "price": 1650,
- "bidderRank": "L1"
}
]
}
], - "last": false
}Marks the given Tender Result(s) as SELECTED (interested) or REJECTED. Provide the entityIds (from a prior search response) along with the feedSourceId they belong to.
JSON object identifying the entities to mark and the action to apply.
| entityIds required | Array of strings The entity ids to mark the action for (the |
| feedSourceId required | string The feed source id the given |
| action required | string Enum: "SELECTED" "REJECTED" The action to mark for the given entities. Use |
| rejectedReason | string Enum: "Low Requirement" "Not matching the criteria" "Not eligible to participate" "Insufficient information" "Location Not Serviceable" "Other" Reason for rejection. Only applicable when |
| rejectedReasonRemark | string Additional remarks for the rejection. Required when |
{- "entityIds": [
- "c473e854-e027-479d-b466-8d0f434681ef"
], - "feedSourceId": "src_12345",
- "action": "SELECTED"
}{- "data": "Success",
- "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}Retrieves up to 5 tender results (bid awards) similar to the given tender.
tenderId is the internal tender identifier — the same value returned in the tenderId field of BidAwardDto/TenderDto objects in prior search responses.
Returns an empty data array if no similar results are found for the given tenderId; this endpoint does not return a 404 for an unknown or non-matching tenderId.
Pass sameAuthority=true to restrict the results to tenders awarded by the same authority as the given tender, e.g. GET /api/public/v1/tender-result/similar/{tenderId}?sameAuthority=true.
| tenderId required | string Example: 1584388a-3fed-49c6-9dd4-35c46f3d4ba9 The internal tender identifier to find similar tender results for (matches the |
| sameAuthority | boolean Default: false Example: sameAuthority=true When |
{- "data": [
- {
- "bidAwardId": "3cbde5e1-e451-4790-8622-93e670119a17",
- "tenderId": "1584388a-3fed-49c6-9dd4-35c46f3d4ba9",
- "sourceBidAwardId": "GEM/2025/B/6585087",
- "dateCreated": 1758206709245,
- "dateModified": 1758481627555,
- "postingDate": 1758206709245,
- "value": "525000.0",
- "location": {
- "city": "Vadodara",
- "state": "Gujarat",
- "country": "India",
- "pincode": "390007"
}, - "documents": [
- {
- "name": "AwardDetails.pdf",
- "type": "OTHER",
- "isUpdate": false
}
], - "changedFields": [
- {
- "changedField": "AWARDED",
- "meta": null
}
], - "isUpdated": true,
- "workflowStatus": "ARCHIVED",
- "bidderDetails": [
- {
- "bidderId": "bidder-001",
- "bidderName": "AIRTEK ENTERPRISE",
- "bidderAddress": "123 Tech Park, Vadodara",
- "awardedCurrency": "INR",
- "awardedValue": "522408.00",
- "bidValue": "522408.00",
- "contractNumber": "CN-2025-589",
- "contractIssueDate": 1758101400000,
- "dateOfCompletionOfSupply": 1765877400000,
- "workDescription": "Supply and installation.",
- "bidStatus": "Accepted-AOC",
- "bidRank": "L1",
- "offeredMake": "-",
- "offeredModel": "-",
- "addressType": "GST_LINKED",
- "addressCity": "Vadodara",
- "addressState": "Gujarat",
- "contactName": "Rajesh Kumar",
- "contactPhoneNumber": 9876543210,
- "contactDesignation": "Owner",
- "contactEmail": "info@airtekenterprise.com",
- "isAwarded": true
}, - {
- "bidderId": "bidder-002",
- "bidderName": "SHREE HARI ELETRICALS",
- "bidderAddress": null,
- "awardedCurrency": "INR",
- "awardedValue": null,
- "bidValue": "527433.60",
- "contractNumber": null,
- "contractIssueDate": null,
- "dateOfCompletionOfSupply": null,
- "workDescription": null,
- "bidStatus": "Accepted-Financial",
- "bidRank": "L2",
- "isAwarded": false
}
], - "aocDescription": "CATEGORY: Supplyof2TRSACCITYEXCH",
- "contractDate": 1758101400000,
- "isContractDateEstimated": true,
- "financialBidEvaluationDate": 1758015000000,
- "technicalBidEvaluationDate": 1757928600000,
- "financialBidOpeningDate": 1757842200000,
- "technicalBidOpeningDate": 1757755800000,
- "aocUpdationDate": 1758101400000,
- "authority": {
- "name": "Bharat Sanchar Nigam Limited",
- "purchaserContactNumber": null,
- "purchaserContactEmail": "procurement@bsnl.co.in",
- "purchaserContactPersonName": "General Manager",
- "purchaserContactPersonDesignation": "General Manager (Procurement)"
}, - "contractValue": "522408.00",
- "isContractValueEstimated": false,
- "bidAwardRefNo": "GEM/2025/B/6585087",
- "contractPeriod": "60",
- "bidResultStep": "Finalized",
- "bidAwardStage": "AOC_DATE",
- "bidAwardResultStage": "AOC Released",
- "category": [
- "Electronics Equipment",
- "Electrical and Electronics"
], - "customLabels": {
- "Is Specified": "No",
- "Region": "ROM",
- "Construction Type": "Fresh"
}, - "makeListStatus": "Asian Paints Products Mentioned",
- "makeList": [
- {
- "rawProductName": "acrylic exterior paint",
- "productCategory": "Exterior Wall Finishes",
- "brandsMentioned": [
- "Asian Paints",
- "Dulux"
], - "isBrandSpecified": true,
- "productFamily": "Paints And Coatings"
}
], - "estimatedProductQuantity": {
- "items": [
- {
- "productFamily": "Paints And Coatings",
- "productCategory": "Exterior Wall Finishes",
- "subProductCategory": "Acrylic exterior paint",
- "quantity": "110",
- "unit": "L",
- "amount": 13750,
- "refBoqId": "cb434e5e-e02a-30ad-825a-5b1212b1409e"
}
]
}, - "aiInsights": {
- "scopeOfWork": "Supply and installation of painting works.",
- "projectMilestone": "- Commencement: 01/06/2025\n- Completion: 30/06/2025",
- "performanceSecurity": "P. G. will be adjusted in the Bill.",
- "insurance": "",
- "classOfBidder": "Class II & above",
- "certificationsRequired": "Valid GST registration, PAN card",
- "workExperienceRequirement": null,
- "bidCapacityRequirement": null,
- "technicalCapacityRequirement": null,
- "otherTechnicalSpecificationRequired": null,
- "turnoverRequirement": null,
- "networthRequirement": null,
- "liquidityRequirement": null,
- "creditFacilityRequirement": null,
- "otherFinancialRequirement": null,
- "defectLiabilityPeriod": null,
- "jvEligibility": null,
- "mobilizationAdvance": "",
- "mobilizationInterest": "",
- "listOfDocumentsRequired": null
}, - "boqItems": [
- {
- "id": "cb434e5e-e02a-30ad-825a-5b1212b1409e",
- "rowNumber": 1,
- "itemDescription": "Painting three or more coats with acrylic exterior paint of approved brand including applying one coat of cement primer.",
- "quantity": 374.2,
- "units": "Sq. m",
- "rate": 208,
- "amount": 77833.6,
- "itemCode": null
}
], - "performanceSecurity": "P. G. will be adjusted in the Bill.",
- "bidToRaEnabled": "",
- "bidValidity": null,
- "buyerDetails": null,
- "productInfos": null,
- "auctionStartDate": null,
- "auctionEndDate": null,
- "scheduleWiseInfo": [
- {
- "scheduleTitle": "Schedule 1",
- "bidderName": "SHRI RAGHUNANDAN TRADERS",
- "price": 58350,
- "bidderRank": "L1"
}, - {
- "scheduleTitle": "Schedule 2",
- "bidderName": "SHRI RAGHUNANDAN TRADERS",
- "price": 75000,
- "bidderRank": "L1"
}, - {
- "scheduleTitle": "Schedule 3",
- "bidderName": "ANAISHA ENTERPRISES",
- "price": 1650,
- "bidderRank": "L1"
}
]
}
], - "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}Returns all available filters for the Profile Listing endpoint, along with their data types and filter modes.
Use the returned filter keys in the filters object of the POST /api/public/v1/profile/my-list request body.
RANGE filters (e.g. date filters)Filters with "filterType": "RANGE" (e.g. LATEST_AWARDED_DATE, UPLOADED_DATE, TENDER_UPDATE_DATE, DATE_MODIFIED, KAM_STATUS_UPDATED_DATE) take their value as epoch milliseconds, passed as a [from, to] array:
"filters": {
"LATEST_AWARDED_DATE": ["1735689600000", "1738368000000"]
}
null or an empty string in that slot) for an open-ended range — e.g. ["1735689600000", null] matches everything on/after that date.Tenders/Tender Results search endpoints, there is no maximum date-range span enforced on these Profile filters.{- "data": {
- "SEED_PROFILE_ID": {
- "name": "SEED_PROFILE_ID",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "KEYWORD": {
- "name": "KEYWORD",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "INDUSTRY_TYPE": {
- "name": "INDUSTRY_TYPE",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "possibleValues": [
- "Aerospace and Defence",
- "Agriculture and Farming",
- "Automobiles and Auto Parts",
- "Banking",
- "Chemicals",
- "Education and Training",
- "Electrical",
- "Energy, Oil and Gas",
- "Environment and Pollution",
- "Finance and Insurance",
- "Food and Beverages",
- "Furnitures and Fixtures",
- "Healthcare and Medicines",
- "Infrastructure and Construction",
- "IT",
- "Machinery and Tools",
- "Manpower",
- "Paints and Painting",
- "Printing and Publishing",
- "Railway",
- "Real Estate",
- "Rubber and Plastic",
- "Scrap",
- "Security and Emergency Services",
- "Telecom",
- "Textile, Apparel and Footwear",
- "Transportation, Logistics, Distribution",
- "Waste Management",
- "Others",
- "Metals and Minerals",
- "IT Solutions",
- "IT Peripherals",
- "Construction Consulting",
- "Paper and Packaging",
- "Travel and Tourism Industry",
- "Plastic Products",
- "Industrial Safety Products",
- "Glass and Ceramic Products",
- "Wellness",
- "Stationery Products",
- "Domestic Appliances",
- "Gems and Jewellery",
- "E-commerce",
- "Gifting",
- "Hotels",
- "FMCG",
- "Tableware and Cookware"
]
}, - "SUB_INDUSTRY_TYPE": {
- "name": "SUB_INDUSTRY_TYPE",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "exampleValues": [
- "Construction Services",
- "Manufacturing"
]
}, - "STATE": {
- "name": "STATE",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "possibleValues": [
- "ANDHRA_PRADESH",
- "ARUNACHAL_PRADESH",
- "ASSAM",
- "BIHAR",
- "CHHATTISGARH",
- "DELHI",
- "GOA",
- "GUJARAT",
- "HARYANA",
- "HIMACHAL_PRADESH",
- "JAMMU_AND_KASHMIR",
- "JHARKHAND",
- "KARNATAKA",
- "KERALA",
- "MADHYA_PRADESH",
- "MAHARASHTRA",
- "MANIPUR",
- "MEGHALAYA",
- "MIZORAM",
- "NAGALAND",
- "ODISHA",
- "PUNJAB",
- "RAJASTHAN",
- "SIKKIM",
- "TAMIL_NADU",
- "TELANGANA",
- "TRIPURA",
- "UTTARAKHAND",
- "UTTAR_PRADESH",
- "WEST_BENGAL",
- "CHANDIGARH",
- "PONDICHERRY",
- "ANDAMAN_AND_NICOBAR_ISLANDS",
- "DADRA_AND_NAGAR_HAVELI",
- "DAMAN_AND_DIU",
- "LAKSHADWEEP",
- "LADAKH"
]
}, - "TURNOVER": {
- "name": "TURNOVER",
- "filterType": "RANGE",
- "filterDataType": "LONG",
- "exampleValues": [
- "5000000",
- "50000000"
]
}, - "KAM_STATUS": {
- "name": "KAM_STATUS",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "possibleValues": [
- "PENDING",
- "ACCEPTED",
- "REJECTED"
]
}, - "USER_ACCEPTANCE_STATUS": {
- "name": "USER_ACCEPTANCE_STATUS",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "possibleValues": [
- "PENDING",
- "UNLOCKED",
- "REJECTED",
- "EXPIRED",
- "NOT_ADDED"
]
}, - "KAM_STATUS_UPDATED_DATE": {
- "name": "KAM_STATUS_UPDATED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "USER_ACCEPTANCE_STATUS_UPDATE_DATE": {
- "name": "USER_ACCEPTANCE_STATUS_UPDATE_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "VIEWED": {
- "name": "VIEWED",
- "filterType": "SINGLE_VALUED",
- "filterDataType": "BOOLEAN"
}, - "UNLOCKED": {
- "name": "UNLOCKED",
- "filterType": "SINGLE_VALUED",
- "filterDataType": "BOOLEAN"
}, - "TENDER_UPDATE_DATE": {
- "name": "TENDER_UPDATE_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "RELEVANT_TENDER_UPDATE_DATE": {
- "name": "RELEVANT_TENDER_UPDATE_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "PARTICIPATED_TENDER_CATEGORY": {
- "name": "PARTICIPATED_TENDER_CATEGORY",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "exampleValues": [
- "Electronics Equipment",
- "Civil Construction"
]
}, - "LATEST_PARTICIPATION_DATE": {
- "name": "LATEST_PARTICIPATION_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "LATEST_AWARDED_DATE": {
- "name": "LATEST_AWARDED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "LATEST_TECHNICAL_ACCEPTED_DATE": {
- "name": "LATEST_TECHNICAL_ACCEPTED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "LATEST_TECHNICAL_REJECTED_DATE": {
- "name": "LATEST_TECHNICAL_REJECTED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "LATEST_FINANCIAL_REJECTED_DATE": {
- "name": "LATEST_FINANCIAL_REJECTED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "LATEST_FINANCIAL_ACCEPTED_DATE": {
- "name": "LATEST_FINANCIAL_ACCEPTED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "LATEST_REJECTED_DATE": {
- "name": "LATEST_REJECTED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "BID_STATUS": {
- "name": "BID_STATUS",
- "filterType": "SINGLE_VALUED",
- "filterDataType": "STRING",
- "possibleValues": [
- "TECHNICAL_REJECTED",
- "FINANCIAL_REJECTED",
- "AOC",
- "REJECTED_AOC",
- "REJECTED_OTHER",
- "TECHNICAL_ACCEPTED",
- "FINANCIAL_ACCEPTED",
- "POTENTIAL_AOC",
- "OTHERS"
]
}, - "UPLOADED_DATE": {
- "name": "UPLOADED_DATE",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}, - "TEAM_ID": {
- "name": "TEAM_ID",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "ORGANIZATION_ID": {
- "name": "ORGANIZATION_ID",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "EXCLUDE_FEED_SOURCE_ID": {
- "name": "EXCLUDE_FEED_SOURCE_ID",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "FEED_SOURCE_ID": {
- "name": "FEED_SOURCE_ID",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "TOP_CITY": {
- "name": "TOP_CITY",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "exampleValues": [
- "Pune",
- "Vadodara"
]
}, - "TOP_STATE": {
- "name": "TOP_STATE",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING"
}, - "TOP_ADDRESS_TYPE": {
- "name": "TOP_ADDRESS_TYPE",
- "filterType": "MULTI_VALUED",
- "filterDataType": "STRING",
- "possibleValues": [
- "HEAD_QUARTER_ADDRESS",
- "REGISTERED_ADDRESS",
- "GST_LINKED",
- "BRANCH_ADDRESS",
- "SALES_OFFICE"
]
}, - "DATE_MODIFIED": {
- "name": "DATE_MODIFIED",
- "filterType": "RANGE",
- "filterDataType": "LONG"
}
}, - "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}Returns a paginated, filterable list of company profiles from your feed. Each item is a summary — use Unlock And Get Profile Detail to retrieve full contact and bidding history.
Note: Actual list of output fields may vary based on your plan.
Filters, sort, and pagination for the profile search.
object A map of filter keys to arrays of values. Available filter keys can be retrieved from the | |
object Sort order of the results. If omitted, results are sorted by | |
| pageNumber | integer Default: 0 Page number (0-indexed). Default: |
| pageSize required | integer [ 1 .. 100 ] Number of results per page. Required. Minimum: 1, Maximum: 100 (omitting it, sending |
{- "filters": {
- "INDUSTRY_TYPE": [
- "Infrastructure and Construction"
]
}, - "sort": {
- "value": "RELEVANCE",
- "ascending": false
}, - "pageNumber": 0,
- "pageSize": 100
}{- "data": {
- "content": [
- {
- "teamId": "66d31a5bd7a8ac68ae240be7",
- "feedSourceId": "66d6ddbf175d3f4d7b02df08",
- "seedProfileId": "1047443218355986049",
- "companyName": "shree ayyappa engineering",
- "indianStates": [
- "Delhi",
- "Gujarat",
- "Telangana",
- "Madhya Pradesh",
- "Tamil Nadu",
- "Rajasthan",
- "Uttar Pradesh",
- "Karnataka",
- "Maharashtra",
- "Kerala"
], - "minTurnover": 344427490,
- "maxTurnover": 344427490,
- "industryType": "Electrical",
- "subIndustryType": "Manufacturing",
- "profileFeedId": "67bd7b6b609cf311b8681df1",
- "isAwarded": false,
- "isRecent": false,
- "bidAwardDate": 1784015340000,
- "matchCriteria": "Description",
- "userRejectionReason": null,
- "remark": null,
- "keywords": [
- "Basement"
], - "totalBidsCount": 2436,
- "totalAwardedBidsCount": 566,
- "contactsExist": true,
- "matchingBidsCount": 354,
- "userAcceptanceStatus": "UNLOCKED"
}, - {
- "teamId": "67bdbba69a4f1924f7c5be0a",
- "feedSourceId": "67bdbbbba309361705b7f322",
- "seedProfileId": "973525148181205908",
- "companyName": "DINESHCHANDRA R AGRAWAL INFRACON PRIVATE LIMITED",
- "indianStates": [
- "Delhi",
- "Bihar",
- "Gujarat",
- "Telangana",
- "Madhya Pradesh",
- "Karnataka",
- "Maharashtra",
- "Kerala",
- "Rajasthan",
- "Uttar Pradesh",
- "Haryana"
], - "minTurnover": 78400000000,
- "maxTurnover": 78400000000,
- "industryType": "Infrastructure and Construction",
- "subIndustryType": "Construction Services",
- "profileFeedId": "67bfc273b7a21236e7ff96a8",
- "isAwarded": false,
- "isRecent": false,
- "bidAwardDate": 1783967400000,
- "matchCriteria": "Description",
- "userRejectionReason": null,
- "remark": null,
- "keywords": [
- "Construction"
], - "totalBidsCount": 1080,
- "totalAwardedBidsCount": 120,
- "contactsExist": true,
- "matchingBidsCount": 230,
- "userAcceptanceStatus": "PENDING"
}
], - "pageable": {
- "pageNumber": 1,
- "pageSize": 10,
- "sort": {
- "unsorted": true,
- "empty": true,
- "sorted": false
}, - "offset": 10,
- "unpaged": false,
- "paged": true
}, - "last": false,
- "totalPages": 774,
- "totalElements": 7732,
- "size": 10,
- "number": 1,
- "sort": {
- "unsorted": true,
- "empty": true,
- "sorted": false
}, - "first": false,
- "numberOfElements": 10,
- "empty": false
}, - "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}Returns the full enriched profile for a company, including verified contacts, GST details, address history, tender participation, and competitor tagging.
Credit behaviour:
Bid award pagination is controlled via the bidAwardPageNum and bidAwardPageSize query parameters (defaults: 0 and 5 respectively).
competitors returns the top 5 competitors and is not paginated via query params. News is available separately via GET /profile/news.
Note: Actual list of output fields may vary based on your plan.
| bidAwardPageNum | integer Default: 0 Page number for bid award pagination (0-indexed). Default: 0. |
| bidAwardPageSize | integer Default: 5 Number of bid awards per page. Default: 5. |
Form-encoded body with the profile identifiers.
| seedProfileId required | string The unique identifier of the company profile to unlock. |
| feedSourceId required | string The feed source ID the profile belongs to. |
{- "data": {
- "companyId": "973525807328663206",
- "companyName": "HARSH CONSTRUCTIONS PRIVATE LIMITED",
- "companyType": "Private Limited Company",
- "yearOfEstablishment": 631132200000,
- "industryType": "Infrastructure and Construction",
- "subIndustryType": "Construction Services",
- "operatingLocations": [
- "Bihar",
- "Delhi",
- "Gujarat",
- "Madhya Pradesh",
- "Andhra Pradesh",
- "Tamil Nadu",
- "Daman & Diu",
- "Rajasthan",
- "Tripura",
- "Uttar Pradesh",
- "Haryana",
- "Karnataka",
- "Goa",
- "West Bengal",
- "Maharashtra",
- "Kerala"
], - "addressDetails": [
- {
- "address": "FLAT NO 705,B,2, R C M 11,Highrise Building,Scheme No 40,Indore,Madhya Pradesh,452001",
- "country": "India",
- "state": "Madhya Pradesh",
- "city": "Indore",
- "pinCode": 452001,
- "addressTypes": [
- {
- "type": "GST_LINKED",
- "displayName": "GST Linked",
- "acronym": "GST"
}
]
}, - {
- "address": "CTS NO 5006/B,GROUND FLOOR,OPP SANT SENA BHAVAN,SANT SENA ROAD,Belagavi,Karnataka,590001",
- "country": "India",
- "state": "Karnataka",
- "city": "Belagavi",
- "pinCode": 590001,
- "addressTypes": [
- {
- "type": "GST_LINKED",
- "displayName": "GST Linked",
- "acronym": "GST"
}
]
}, - {
- "address": "GROUND FLOOR, FLAT NO 01, SANSKRUTI APARTMENT, GANGAPUR ROAD MURKUTE COLONY, NEW PANDIT COLONY, Nashik, Maharashtra, 422002",
- "country": "India",
- "state": "Maharashtra",
- "city": "Nashik",
- "pinCode": 422002,
- "addressTypes": [
- {
- "type": "GST_LINKED",
- "displayName": "GST Linked",
- "acronym": "GST"
}
]
}, - {
- "address": "Bajirao Road, Pune,411002, Maharashtra",
- "country": "India",
- "state": "Maharashtra",
- "city": "Pune",
- "pinCode": 411002,
- "addressTypes": null
}
], - "contactDetails": [
- {
- "contactName": "Nilesh B Yeole",
- "contactNumbers": [
- {
- "number": 9623450694,
- "countryCode": 91,
- "extension": null
}
], - "contactEmails": [
- "nileshyeole7@yahoo.co.in"
], - "designation": "DIRECTOR",
- "verificationStatus": null,
- "verificationType": "CALL_VERIFIED",
- "verificationBadge": "TYPE_A",
- "hasCustomDomainEmail": false
}, - {
- "contactName": "Nilesh",
- "contactNumbers": [
- {
- "number": 8380007227,
- "countryCode": 91,
- "extension": null
}
], - "contactEmails": [
- "tenders@hcpl.co.in"
], - "designation": "GENERAL MANAGER",
- "verificationStatus": null,
- "verificationType": "CALL_VERIFIED",
- "verificationBadge": "TYPE_A",
- "hasCustomDomainEmail": true
}, - {
- "contactName": "Vilas K Birari",
- "contactNumbers": [
- {
- "number": 9420485095,
- "countryCode": 91,
- "extension": null
}
], - "contactEmails": [
- "vilasbirari@gmail.com"
], - "designation": "Owner",
- "verificationStatus": null,
- "verificationType": "ZOOM_INFO_VERIFIED",
- "verificationBadge": "TYPE_C",
- "hasCustomDomainEmail": false
}, - {
- "contactName": "Dharma patel",
- "contactNumbers": [
- {
- "number": 8380005398,
- "countryCode": 91,
- "extension": null
}
], - "contactEmails": [
- "deep.girkar@hcpl.co.in"
], - "designation": "ACCOUNTANT",
- "verificationStatus": null,
- "verificationType": null,
- "verificationBadge": null,
- "hasCustomDomainEmail": true
}
], - "gstDetails": [
- {
- "gstIn": "07AACCH2277H1ZM",
- "status": "Active",
- "dateOfRegistration": 1561228200000,
- "verificationStatus": "NOT_VERIFIED"
}, - {
- "gstIn": "24AACCH2277H1ZQ",
- "status": "Cancelled",
- "dateOfRegistration": 1498847400000,
- "verificationStatus": "NOT_VERIFIED"
}, - {
- "gstIn": "27AACCH2277H1ZK",
- "status": "ACTIVE",
- "dateOfRegistration": null,
- "verificationStatus": "NOT_VERIFIED"
}
], - "website": [
- "hcpl.co.in"
], - "turnover": {
- "first": 10700000000,
- "second": 10700000000
}, - "insights": {
- "totalBidsCount": 585,
- "totalAwardedCount": 79,
- "totalParticipatedContractValue": 376370607286.69574,
- "totalAwardedContractValue": 60286362547.1174,
- "authorityWiseData": {
- "Public Works Department": {
- "totalBidCount": 298,
- "totalAwardCount": 41,
- "totalBidAmount": 152000000000,
- "totalAwardAmount": 21700000000
}, - "Maharashtra State Infrastructure Development Corporation": {
- "totalBidCount": 26,
- "totalAwardCount": 5,
- "totalBidAmount": 18500000000,
- "totalAwardAmount": 3200000000
}, - "Municipal Corporation": {
- "totalBidCount": 24,
- "totalAwardCount": 3,
- "totalBidAmount": 4100000000,
- "totalAwardAmount": 610000000
}
}, - "authorityWiseWinData": {
- "Public Works Department": {
- "totalBidCount": 298,
- "totalAwardCount": 41,
- "totalBidAmount": 152000000000,
- "totalAwardAmount": 21700000000
}, - "National Highways Authority Of India": {
- "totalBidCount": 18,
- "totalAwardCount": 7,
- "totalBidAmount": 26400000000,
- "totalAwardAmount": 9800000000
}, - "Maharashtra State Infrastructure Development Corporation": {
- "totalBidCount": 26,
- "totalAwardCount": 5,
- "totalBidAmount": 18500000000,
- "totalAwardAmount": 3200000000
}
}, - "sectorWiseData": {
- "Civil And Construction": {
- "totalBidCount": 333,
- "totalAwardCount": 44,
- "totalBidAmount": 149850000000,
- "totalAwardAmount": 16720000000
}, - "Electrical and Electronics": {
- "totalBidCount": 29,
- "totalAwardCount": 4,
- "totalBidAmount": 13050000000,
- "totalAwardAmount": 1520000000
}, - "Consultancy Services": {
- "totalBidCount": 20,
- "totalAwardCount": 2,
- "totalBidAmount": 9000000000,
- "totalAwardAmount": 760000000
}
}, - "stateWiseData": {
- "KARNATAKA": {
- "totalBidCount": 7,
- "totalAwardCount": 4,
- "totalBidAmount": 3150000000,
- "totalAwardAmount": 1520000000
}, - "DELHI": {
- "totalBidCount": 4,
- "totalAwardCount": 0,
- "totalBidAmount": 1800000000,
- "totalAwardAmount": 0
}, - "MAHARASHTRA": {
- "totalBidCount": 414,
- "totalAwardCount": 59,
- "totalBidAmount": 186300000000,
- "totalAwardAmount": 22420000000
}
}
}, - "allTenders": {
- "content": [
- {
- "bidAwardId": "a6f67b65-3b7e-4649-adf8-c2be86414e06",
- "tenderId": "2026_NHAI_282371_1",
- "tenderDescription": "Engagement of user fee agency through E-Tender at Dhulepura FP at Design Km 102.200 for the use of two lane with paved shoulder section of Asind to Mandal Section of NH158 in Rajasthan",
- "purchaserName": "National Highways Authority Of India",
- "totalBidders": 8,
- "bidderNames": [ ],
- "contractDate": null,
- "value": 99300000,
- "valueInUsd": 1098223.4,
- "locationString": "NHAI HQ",
- "location": {
- "district": null,
- "state": "Rajasthan"
}, - "currency": "INR",
- "sectorNames": [
- "Transportation and Logistics"
], - "contractPeriod": "365",
- "awardStatus": "Under Evaluation",
- "dateEstimationType": "FIN_BID_OPENING_DATE",
- "estimatedDate": 1784030880000,
- "bidStatus": "Financial Accepted",
- "awardedValue": null,
- "enrichmentColumn": {
- "technicalEligibility": "Bidder must have completed at least one similar work of value not less than 40% of the estimated cost in the last 7 years.",
- "financialEligibility": "Average annual financial turnover during the last 3 financial years should be at least 30% of the estimated cost."
}
}, - {
- "bidAwardId": "ce6234c7-44db-4704-b2c6-f24ab12123f2",
- "tenderId": "2026_PDKVA_1270383_1",
- "tenderDescription": "CONSTRUCTION OF COLLEGE OF FOOD TECHNOLOGY, At YAVATMAL, Under Dr. Panjabrao Deshmukh Krishi Vidyapeeth, Akola.",
- "purchaserName": "Dr Panjabrao Deshmukh Krishi Vidyapeeth",
- "totalBidders": 3,
- "bidderNames": [
- "Pawar Patkar Constructions Pvt.Ltd."
], - "contractDate": 1783939800000,
- "value": 911628417.9,
- "valueInUsd": 10082292,
- "locationString": "Yavatmal",
- "location": {
- "district": "Yavatmal",
- "state": "Maharashtra"
}, - "currency": "INR",
- "sectorNames": [
- "Building Construction",
- "Civil And Construction"
], - "contractPeriod": "1095",
- "awardStatus": "Not Won",
- "dateEstimationType": "CONTRACT_DATE",
- "estimatedDate": 1783939800000,
- "bidStatus": "Financial Rejected",
- "awardedValue": null,
- "enrichmentColumn": null
}
], - "pageable": {
- "pageNumber": 0,
- "pageSize": 5,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "offset": 0,
- "paged": true,
- "unpaged": false
}, - "totalElements": 587,
- "totalPages": 118,
- "last": false,
- "size": 5,
- "number": 0,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "numberOfElements": 5,
- "first": true,
- "empty": false
}, - "relevantTenders": {
- "content": [
- {
- "bidAwardId": "b505c6a1-74f9-49fa-97d6-50cf717d7a13",
- "tenderId": "2026_DOA_1312021_2",
- "tenderDescription": "Description : <mark>Construction</mark> of Boys Hostel building for College of",
- "purchaserName": "Mahatma Phule Krishi Vidyapeeth",
- "totalBidders": 4,
- "bidderNames": [ ],
- "contractDate": null,
- "value": 75891758,
- "valueInUsd": 839336.4,
- "locationString": "Agriculture at Pune.",
- "location": {
- "district": "Pune",
- "state": "Maharashtra"
}, - "currency": "INR",
- "sectorNames": [
- "Building Construction",
- "Civil And Construction"
], - "contractPeriod": "365",
- "awardStatus": "Under Evaluation",
- "dateEstimationType": "FIN_BID_OPENING_DATE",
- "estimatedDate": 1784029200000,
- "bidStatus": "Technical Accepted",
- "awardedValue": null,
- "profileFeedTagType": "DESCRIPTION",
- "keywords": [
- "Construction"
]
}, - {
- "bidAwardId": "dacd291e-7981-484c-9818-b9c05fc0c9b8",
- "tenderId": "2025_MSIDC_1233288_1",
- "tenderDescription": "Description : <mark>Construction</mark> of Post Production Unit Screening Theater",
- "purchaserName": "Maharashtra State Infrastructure Development Corporation",
- "totalBidders": 6,
- "bidderNames": [
- "Painterior Protective Systems LLP"
], - "contractDate": 1783621800000,
- "value": 130287222,
- "valueInUsd": 1440931.2,
- "locationString": "Kolhapur",
- "location": {
- "district": "Kolhapur",
- "state": "Maharashtra"
}, - "currency": "INR",
- "sectorNames": [
- "Building Construction",
- "Civil And Construction"
], - "contractPeriod": "365",
- "awardStatus": "Not Won",
- "dateEstimationType": "CONTRACT_DATE",
- "estimatedDate": 1783621800000,
- "bidStatus": "Technical Rejected",
- "awardedValue": null,
- "profileFeedTagType": "DESCRIPTION",
- "keywords": [
- "Construction"
]
}
], - "pageable": {
- "pageNumber": 0,
- "pageSize": 5,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "offset": 0,
- "paged": true,
- "unpaged": false
}, - "totalElements": 157,
- "totalPages": 32,
- "last": false,
- "size": 5,
- "number": 0,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "numberOfElements": 5,
- "first": true,
- "empty": false
}, - "userAcceptanceStatus": "UNLOCKED",
- "competitors": {
- "content": [
- {
- "profileId": "973525807328663901",
- "companyName": "APEX INFRA PROJECTS PRIVATE LIMITED",
- "commonTendersCount": 2,
- "tendersWonByCompany": 1,
- "tendersWonByCompetitor": 1
}
], - "pageable": {
- "pageNumber": 0,
- "pageSize": 5,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "offset": 0,
- "paged": true,
- "unpaged": false
}, - "totalElements": 5,
- "totalPages": 1,
- "last": true,
- "size": 5,
- "number": 0,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "numberOfElements": 5,
- "first": true,
- "empty": false
}
}, - "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}Returns paginated news for a company from the past 365 days, most recent first.
seedProfileId is unlocked for the given feedSourceId -> 200 with status: "OK" and the paginated news in data.seedProfileId exists in that feedSourceId but hasn't been unlocked yet -> 200 with status: "NOT_UNLOCKED" and data: null. Call POST /profile/unlock first, then retry.seedProfileId was never added to that feedSourceId -> 404.Note: Actual list of output fields may vary based on your plan.
| seedProfileId required | string The unique identifier of the company profile. |
| feedSourceId required | string The feed source ID the profile belongs to. |
| pageNum | integer Default: 0 Page number for news pagination (0-indexed). Default: 0. |
| pageSize | integer Default: 10 Number of news items per page. Default: 10. |
{- "data": {
- "status": "OK",
- "message": null,
- "data": {
- "content": [
- {
- "newsId": "68a41c2be4b0f31a7d9c5e12",
- "publishedDate": 1755600000000,
- "title": "Harsh Constructions wins major road infrastructure contract in Madhya Pradesh",
- "summary": "The company has been awarded a contract for the construction of a state highway stretch, expanding its footprint in the infrastructure sector.",
- "sentiment": "POSITIVE",
- "category": [
- "INFRASTRUCTURE_AND_CONSTRUCTION"
], - "context": [
- "State Highway Projects",
- "Road Construction"
]
}
], - "pageable": {
- "pageNumber": 0,
- "pageSize": 10,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "offset": 0,
- "paged": true,
- "unpaged": false
}, - "totalElements": 1,
- "totalPages": 1,
- "last": true,
- "size": 10,
- "number": 0,
- "sort": {
- "empty": true,
- "sorted": false,
- "unsorted": true
}, - "numberOfElements": 1,
- "first": true,
- "empty": false
}
}, - "success": true,
- "errorMessage": null,
- "errorCode": null,
- "meta": null
}