Bidassist Public API (1.5.3)

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.

Getting Started

To make your first successful API call, please follow these steps.

1. Authentication

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-key Value: YOUR_SECRET_API_KEY

Keep your API key secure and do not share it publicly.

2. Constructing a Request URL

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.

  • Base URL: https://partner-api.bidassist.in
  • Endpoint Path: /api/public/v1/tender/search
  • Full Request URL: https://partner-api.bidassist.in/api/public/v1/tender/search

3. Understanding Rate Limits

The 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.

Tenders

Endpoints for searching and retrieving tender information.

Search for Tenders

Retrieves a paginated list of tenders based on a set of filters. The 'FEED_SOURCE_ID' filter is mandatory.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

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.

Responses

Request samples

Content type
application/json
{
  • "filters": {
    },
  • "pageNumber": 0,
  • "pageSize": 20
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "last": false
}

Accept/Reject Tender

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.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

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 tenderId / bidAwardId returned by the search endpoints).

feedSourceId
required
string

The feed source id the given entityIds belong to. Must match the same feedSourceId used to search for these entities.

action
required
string
Enum: "SELECTED" "REJECTED"

The action to mark for the given entities. Use SELECTED to mark as interested, REJECTED to mark as rejected.

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 action is REJECTED. These are the same reasons shown to users in Nexizo; the list is admin-configurable and may change over time. If set to Other, rejectedReasonRemark is required.

rejectedReasonRemark
string

Additional remarks for the rejection. Required when rejectedReason is Other.

Responses

Request samples

Content type
application/json
{
  • "entityIds": [
    ],
  • "feedSourceId": "src_12345",
  • "action": "SELECTED"
}

Response samples

Content type
application/json
{
  • "data": "Success",
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}

Tender Results

Endpoints for searching bid awards and tender results.

Search for Tender Results (Bid Awards)

Retrieves a paginated list of tender results (bid awards) based on a set of filters. The 'FEED_SOURCE_ID' filter is mandatory.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

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.

Responses

Request samples

Content type
application/json
{
  • "filters": {
    },
  • "pageNumber": 0,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "last": false
}

Accept/Reject Tender Result

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.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

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 tenderId / bidAwardId returned by the search endpoints).

feedSourceId
required
string

The feed source id the given entityIds belong to. Must match the same feedSourceId used to search for these entities.

action
required
string
Enum: "SELECTED" "REJECTED"

The action to mark for the given entities. Use SELECTED to mark as interested, REJECTED to mark as rejected.

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 action is REJECTED. These are the same reasons shown to users in Nexizo; the list is admin-configurable and may change over time. If set to Other, rejectedReasonRemark is required.

rejectedReasonRemark
string

Additional remarks for the rejection. Required when rejectedReason is Other.

Responses

Request samples

Content type
application/json
{
  • "entityIds": [
    ],
  • "feedSourceId": "src_12345",
  • "action": "SELECTED"
}

Response samples

Content type
application/json
{
  • "data": "Success",
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}

Get Similar Tender Results

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.

Authorizations:
ApiKeyAuth
path Parameters
tenderId
required
string
Example: 1584388a-3fed-49c6-9dd4-35c46f3d4ba9

The internal tender identifier to find similar tender results for (matches the tenderId field in BidAwardDto/TenderDto responses).

query Parameters
sameAuthority
boolean
Default: false
Example: sameAuthority=true

When true, only returns similar tender results awarded by the same authority (purchaser) as the given tender. If the given tender has no authority on record, an empty data array is returned. Defaults to false, which returns similar results from any authority.

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}

Profile

Endpoints for retrieving enriched company profile information for bidders.

Get Profile Listing Filter Definitions

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.

Passing 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"]
}
  • Either bound may be omitted (pass null or an empty string in that slot) for an open-ended range — e.g. ["1735689600000", null] matches everything on/after that date.
  • At most 2 values are accepted; passing more than 2 raises a validation error.
  • Unlike the Tenders/Tender Results search endpoints, there is no maximum date-range span enforced on these Profile filters.
Authorizations:
ApiKeyAuth

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}

Search Company Profiles

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.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required

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 GET /api/public/v1/profile/filters endpoint. For RANGE-type filters (dates, etc.), pass a [from, to] array of epoch-millisecond strings — see the /profile/filters endpoint description for details. SEED_PROFILE_ID accepts at most 100 values per request; sending more returns a validation error (INVALID_ENTITY_ID_SIZE).

object

Sort order of the results. If omitted, results are sorted by RELEVANCE, descending.

pageNumber
integer
Default: 0

Page number (0-indexed). Default: 0.

pageSize
required
integer [ 1 .. 100 ]

Number of results per page. Required. Minimum: 1, Maximum: 100 (omitting it, sending 0, or sending more than 100 returns a validation error).

Responses

Request samples

Content type
application/json
{
  • "filters": {
    },
  • "sort": {
    },
  • "pageNumber": 0,
  • "pageSize": 100
}

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}

Unlock and Get Profile Detail

Returns the full enriched profile for a company, including verified contacts, GST details, address history, tender participation, and competitor tagging.

Credit behaviour:

  • If the profile is already unlocked → returns full detail at 0 credit cost.
  • If the profile is locked → unlocks it and deducts 1 credit from your organization's credit balance, then returns the full detail.

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.

Authorizations:
ApiKeyAuth
query Parameters
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.

Request Body schema: application/x-www-form-urlencoded
required

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.

Responses

Response samples

Content type
application/json
{
  • "data": {
    },
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}

Get Profile News

Returns paginated news for a company from the past 365 days, most recent first.

  • If seedProfileId is unlocked for the given feedSourceId -> 200 with status: "OK" and the paginated news in data.
  • If 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.
  • If seedProfileId was never added to that feedSourceId -> 404.

Note: Actual list of output fields may vary based on your plan.

Authorizations:
ApiKeyAuth
query Parameters
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.

Responses

Response samples

Content type
application/json
Example
{
  • "data": {
    },
  • "success": true,
  • "errorMessage": null,
  • "errorCode": null,
  • "meta": null
}