{
  "openapi": "3.0.1",
  "info": {
    "title": "AusTender Contract Notices",
    "description": "No open tenders: Australian Government contract awards (AusTender contract notices) by CN id, date, agency or UNSPSC, with alerts. AusTender materials are released by the Department of Finance. Derived and modified data, CC BY 3.0 AU. Not affiliated with or endorsed by the Department of Finance.",
    "version": "0.1",
    "x-build-id": "hBAsynyNUYfHAKbRh"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/yappman~au-contract-notices/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-yappman-au-contract-notices",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/yappman~au-contract-notices/runs": {
      "post": {
        "operationId": "runs-sync-yappman-au-contract-notices",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/yappman~au-contract-notices/run-sync": {
      "post": {
        "operationId": "run-sync-yappman-au-contract-notices",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "search",
              "lookup",
              "alert"
            ],
            "type": "string",
            "description": "Search filters contract notices in a date range; lookup returns the CN ids you name (the latest version of each, with its amendment count); alert returns only notices this alert has never sent before, over the last 14 days of contract last-modified dates. Allowed: search, lookup, alert; any other value refuses the run. Default: search. Cost: each row returned is one notice event ($0.002 on the Free plan, less on higher plans), in every mode; there is no run fee.",
            "default": "search"
          },
          "cnIds": {
            "title": "CN ids (lookup)",
            "maxItems": 20,
            "type": "array",
            "description": "Lookup mode: up to 20 contract notice ids, such as CN4280221, or an amendment id such as CN4271813-A1 (CN, then digits, optionally -A and digits); anything else refuses the run before anything is read. Each id returns the latest version of its notice; an id AusTender does not know is reported as not found and costs nothing. Search and alert ignore it. Default: none. Cost: one notice event per row returned ($0.002 on the Free plan, less on higher plans); no run fee.",
            "items": {
              "type": "string"
            }
          },
          "dateType": {
            "title": "Date type",
            "enum": [
              "contractPublished",
              "contractLastModified",
              "contractStart",
              "contractEnd"
            ],
            "type": "string",
            "description": "Which date the date range applies to (search mode). Allowed: contractPublished, contractLastModified (parents and amendments), contractStart, contractEnd; any other value refuses the run. Left empty, search uses contractPublished. Alert mode always reads contract last-modified dates and refuses this field. Cost: no charge of its own; each row returned is one notice event ($0.002 on the Free plan, less on higher plans); no run fee."
          },
          "dateFrom": {
            "title": "From",
            "type": "string",
            "description": "First day of the range (UTC), inclusive, as YYYY-MM-DD (search mode). Default: 30 days before \"To\", so the range is 31 days. The range can be at most 92 days; a longer one is refused before anything is read or charged. Alert mode reads its own 14 days and refuses this field. Cost: a longer range can return more rows, each one notice event ($0.002 on the Free plan, less on higher plans); no run fee."
          },
          "dateTo": {
            "title": "To",
            "type": "string",
            "description": "Last day of the range (UTC), inclusive, as YYYY-MM-DD (search mode). It may be in the future for contract start and end dates. Default: today. Alert mode reads its own 14 days and refuses this field. Cost: as \"From\": more days can mean more rows, each one notice event ($0.002 on the Free plan, less on higher plans); no run fee."
          },
          "agencies": {
            "title": "Agencies",
            "maxItems": 20,
            "type": "array",
            "description": "Part of the procuring agency's name, case-insensitive; any one matching is enough. Matched only against the agency (the procuring entity), never any other party; a notice whose agency is not output (null) never matches. Up to 20 entries of at most 200 characters. Default: none (every agency). Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee.",
            "items": {
              "type": "string"
            }
          },
          "unspscCodes": {
            "title": "UNSPSC codes",
            "maxItems": 20,
            "type": "array",
            "description": "UNSPSC code prefixes of 2 to 8 digits; any one matching is enough. \"80\" matches all of segment 80, \"80100000\" all of family 8010, and \"80101504\" matches itself. Up to 20 entries. Default: none (every code). Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee.",
            "items": {
              "type": "string"
            }
          },
          "valueMin": {
            "title": "Minimum value (AUD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only notices whose contract value is at least this, in Australian dollars (inclusive). Notices without a value are left out when a value bound is set. Must not exceed the maximum. Default: none. Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee."
          },
          "valueMax": {
            "title": "Maximum value (AUD)",
            "minimum": 0,
            "type": "integer",
            "description": "Only notices whose contract value is at most this, in Australian dollars (inclusive). Notices without a value are left out when a value bound is set. Default: none. Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee."
          },
          "procurementMethods": {
            "title": "Procurement methods",
            "type": "array",
            "description": "Only notices with one of these procurement methods, as published. Allowed: Open tender, Limited tender, Prequalified tender; any other value refuses the run. Default: none (every method). Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee.",
            "items": {
              "type": "string",
              "enum": [
                "Open tender",
                "Limited tender",
                "Prequalified tender"
              ]
            }
          },
          "contractStartFrom": {
            "title": "Contract start on or after",
            "type": "string",
            "description": "Only notices whose contract starts on or after this day (UTC, YYYY-MM-DD); notices without a start date are left out when a start bound is set. Default: none. Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee."
          },
          "contractStartTo": {
            "title": "Contract start on or before",
            "type": "string",
            "description": "Only notices whose contract starts on or before this day (UTC, YYYY-MM-DD); notices without a start date are left out when a start bound is set. Default: none. Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee."
          },
          "contractEndFrom": {
            "title": "Contract end on or after",
            "type": "string",
            "description": "Only notices whose contract ends on or after this day (UTC, YYYY-MM-DD); notices without an end date are left out when an end bound is set. Default: none. Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee."
          },
          "contractEndTo": {
            "title": "Contract end on or before",
            "type": "string",
            "description": "Only notices whose contract ends on or before this day (UTC, YYYY-MM-DD); notices without an end date are left out when an end bound is set. Default: none. Cost: narrows the rows returned, so fewer notice events ($0.002 each on the Free plan, less on higher plans); there is no run fee."
          },
          "alertId": {
            "title": "Alert id (alert mode)",
            "pattern": "^[a-z0-9-]{1,40}$",
            "type": "string",
            "description": "Alert mode: names this alert, as lower-case letters, digits and hyphens, 1 to 40 characters (such as \"defence-it\"); anything else refuses the run. Do not put a person's name in it: it is kept in the alert's store name, its ledger, the run summary and the status message. Each alert remembers what it has sent, in your own key-value store au-cn-alert-<alertId>. Search and lookup ignore it. Default: none (required in alert mode). Cost: each new notice returned is one notice event ($0.002 on the Free plan, less on higher plans); no run fee."
          },
          "firstRunLookbackDays": {
            "title": "First-run lookback (days)",
            "minimum": 1,
            "maximum": 14,
            "type": "integer",
            "description": "On an alert's first run, notices last modified in this many days (today included) are returned; the rest of the 14-day window is recorded as seen without charge. Allowed: 1 to 14. Default: 1. Alert mode only; search and lookup ignore it. Cost: more days can return more rows on the first run, each one notice event ($0.002 on the Free plan, less on higher plans); no run fee.",
            "default": 1
          },
          "maxItems": {
            "title": "Maximum notices",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Cap on rows returned, and so on notice charges. Search stops reading once it has this many; lookup returns at most 20 anyway; an alert sends at most this many new notices a run, newest first. For an alert, narrow it with the filters first (agencies, UNSPSC codes, value range, procurement methods, contract start and end dates), then set maxItems to cover its expected filtered daily volume; otherwise its backlog grows and older notices can age out of the 14-day window unsent (the run summary counts any that do, and they are never charged). About 930 contract notices were modified on AusTender between 28 Oct 17:24 UTC and 29 Oct 07:12 UTC (an owner canary of 29 Oct 2026); unfiltered daily volume is in the high hundreds. Examples at Free-plan prices: a filtered alert (for example one agency with valueMin 100000, about 5 to 20 notices a day) with maxItems 50 costs about $0.01 to $0.04 a day; an unfiltered alert with maxItems 1000 costs up to $2.00 a day, about $60 a month on Free and $36 on Gold and above. Allowed: 1 to 100,000. Default: 1,000; the Console form starts at 3. Cost: at most this many notice events ($0.002 each on the Free plan, less on higher plans); no run fee.",
            "default": 1000
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}