QCC — Company Tender Search

# QCC — Company Tender Search

Retrieve a previously identified company's tender notices using its returned company ID, with role, keyword, notice status, date, and region filters.
## Available implementations
qcc · QCC — Company Tender Search: https://openany.si/markets/apis/capabilities/qcc-company-tender-search?offering=e89195e8-14fb-451d-869d-b5095e93cfe4 · $0 / call

## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/qcc-company-tender-search
Method: POST
Endpoint: https://api.openany.si/v1/agent-apis/qcc/tender/search_company_tenders
Price: $0 / call
Provider: qcc
Contract revision: 2
Price source: selected implementation in the OpenAny public API catalog. Price update time: not supplied.

Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.

## Generated request template — review values before use
```bash
curl \
  'https://api.openany.si/v1/agent-apis/qcc/tender/search_company_tenders' \
  -X POST \
  -H "Authorization: Bearer $OPENANY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "id": "<REPLACE_id>"
}'
```

## API contract
```json
{
  "resource_type": "api",
  "name": "QCC — Company Tender Search",
  "endpoint": "https://api.openany.si/v1/agent-apis/qcc/tender/search_company_tenders",
  "method": "POST",
  "content_type": "application/json",
  "execution_mode": "sync",
  "authentication": {
    "type": "bearer",
    "environment_variable": "OPENANY_API_KEY"
  },
  "inputs": [
    {
      "description": "Retrieve a previously identified company's tender notices using its returned company ID, with role, keyword, notice status, date, and region filters.",
      "json_schema": {
        "properties": {
          "beginDate": {
            "description": "Publication date lower bound, YYYY-MM-DD. For the last year use the current date minus one year; for the last three months subtract three months; for since 2024 use 2024-01-01. Omit when no time restriction is specified.",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string"
          },
          "bidStatuses": {
            "description": "Notice substatuses, more specific than infoTypes. The first four enum entries concern tender notices and the remaining six concern award notices. If both information types and substatuses are supplied, the more specific substatus takes priority.",
            "items": {
              "enum": [
                "预告",
                "招标",
                "招标变更",
                "澄清答疑",
                "开标",
                "中标候选",
                "中标成交",
                "中标变更",
                "合同验收",
                "废标流标终止"
              ],
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "endDate": {
            "description": "Publication date upper bound, YYYY-MM-DD; must not precede beginDate. Supply only when an explicit cutoff date is requested; otherwise omit to include the latest records.",
            "pattern": "^(\\d{4}-\\d{2}-\\d{2})?$",
            "type": "string"
          },
          "id": {
            "description": "Company ID; must come from the company ID returned by search_companies, search_tenders, get_tender_detail, search_proposed_projects, or get_proposed_project_detail.",
            "minLength": 1,
            "type": "string"
          },
          "infoTypes": {
            "description": "Information types. May be omitted when bidStatuses is supplied; the server derives the types automatically.",
            "items": {
              "enum": [
                "招标公告",
                "中标公告"
              ],
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "keywords": {
            "description": "Product, service, or project keywords to search within this company's notices. Maximum 10 keywords, combined with OR.",
            "items": {
              "minLength": 1,
              "type": "string"
            },
            "maxItems": 10,
            "minItems": 1,
            "type": "array"
          },
          "regions": {
            "description": "Project location filter. Prefer complete Chinese administrative names starting at province level and including suffixes, e.g. 江苏省, 江苏省苏州市, 江苏省苏州市吴中区, or 上海市浦东新区. Complete an unambiguous Suzhou abbreviation to 江苏省苏州市; ask for clarification if ambiguous. Combine requested regions in one regions array using OR. Hong Kong, Macao, and Taiwan are unsupported.",
            "items": {
              "minLength": 2,
              "type": "string"
            },
            "maxItems": 20,
            "minItems": 1,
            "type": "array"
          },
          "role": {
            "description": "Single company role code in tender notices: 1=procuring entity, 3=winning bidder, 4=agent, 8=bidder (including bidders, award candidates, and winners), 6=mentioned party. Omit for no restriction.",
            "enum": [
              "1",
              "3",
              "4",
              "8",
              "6"
            ],
            "type": "string"
          }
        },
        "required": [
          "id"
        ],
        "type": "object"
      },
      "location": "body",
      "name": "body",
      "nullable": false,
      "pointer": "",
      "required": true,
      "type": "object"
    }
  ],
  "billing": {
    "currency": "USD",
    "mode": "fixed",
    "priceMicroUsd": "0",
    "rounding": null,
    "unit": "call",
    "unitQuantity": null
  },
  "examples": []
}
```