release-schema.json

{
  "properties": {
    "bids": {
      "title": "Submissions",
      "description": "Information about individual bids and expressions of interest, and summary statistics.",
      "type": "object",
      "properties": {
        "statistics": {
          "title": "Statistics",
          "description": "Summary statistics about the number of bidders, bids and expressions of interest.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Statistic"
          }
        },
        "details": {
          "title": "Submission details",
          "description": "Information about individual bids and expressions of interest.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Bid"
          }
        }
      }
    }
  },
  "definitions": {
    "Award": {
      "properties": {
        "relatedBid": {
          "title": "Related bid",
          "description": "The identifiers of the bids (or expressions of interest) to which the contract relates.",
          "type": [
            "string",
            "null"
          ],
          "deprecated": {
            "description": "This field is deprecated in favor of `relatedBids`, to allow an award to combine multiple bids.",
            "deprecatedVersion": "1.2"
          }
        },
        "relatedBids": {
          "title": "Related bids",
          "description": "The identifiers of the bids (or expressions of interest) to which the award relates.",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        }
      }
    },
    "Contract": {
      "properties": {
        "relatedBids": {
          "title": "Related bids",
          "description": "The identifiers of the bids (or expressions of interest) to which the contract relates.",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        }
      }
    },
    "Statistic": {
      "title": "Statistic",
      "description": "A summary statistic related to the contracting process.",
      "type": "object",
      "required": [
        "id",
        "measure",
        "value"
      ],
      "properties": {
        "id": {
          "title": "ID",
          "description": "An internal identifier for the statistic.",
          "type": "string"
        },
        "measure": {
          "title": "Measure",
          "description": "The statistic reported in the value.",
          "type": "string",
          "codelist": "statistic.csv",
          "openCodelist": true
        },
        "date": {
          "title": "Date",
          "description": "The date when the statistic was last updated. This is often the closing date of the tender process. This field may be omitted unless either (a) the same statistic is provided from multiple points in time, or (b) there is a specific local requirement for the date when statistics were calculated to be provided.",
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "value": {
          "title": "Value",
          "description": "The value for the measure in question. A total count should be expressed as an integer. A proportion should be expressed as a decimal (for example, 0.1) and not as a percentage (for example, 10).",
          "type": "number"
        },
        "valueGross": {
          "title": "Gross value",
          "description": "The monetary value for the measure in question, including all taxes.",
          "type": [
            "number",
            "null"
          ]
        },
        "currency": {
          "title": "Currency",
          "description": "The currency of the amount in the `value` field, if the statistic has a monetary value.",
          "type": [
            "string",
            "null"
          ],
          "codelist": "currency.csv",
          "openCodelist": false,
          "enum": [
            "ADP",
            "AED",
            "AFA",
            "AFN",
            "ALK",
            "ALL",
            "AMD",
            "ANG",
            "AOA",
            "AOK",
            "AON",
            "AOR",
            "ARA",
            "ARP",
            "ARS",
            "ARY",
            "ATS",
            "AUD",
            "AWG",
            "AYM",
            "AZM",
            "AZN",
            "BAD",
            "BAM",
            "BBD",
            "BDT",
            "BEC",
            "BEF",
            "BEL",
            "BGJ",
            "BGK",
            "BGL",
            "BGN",
            "BHD",
            "BIF",
            "BMD",
            "BND",
            "BOB",
            "BOP",
            "BOV",
            "BRB",
            "BRC",
            "BRE",
            "BRL",
            "BRN",
            "BRR",
            "BSD",
            "BTN",
            "BUK",
            "BWP",
            "BYB",
            "BYN",
            "BYR",
            "BZD",
            "CAD",
            "CDF",
            "CHC",
            "CHE",
            "CHF",
            "CHW",
            "CLF",
            "CLP",
            "CNY",
            "COP",
            "COU",
            "CRC",
            "CSD",
            "CSJ",
            "CSK",
            "CUC",
            "CUP",
            "CVE",
            "CYP",
            "CZK",
            "DDM",
            "DEM",
            "DJF",
            "DKK",
            "DOP",
            "DZD",
            "ECS",
            "ECV",
            "EEK",
            "EGP",
            "ERN",
            "ESA",
            "ESB",
            "ESP",
            "ETB",
            "EUR",
            "FIM",
            "FJD",
            "FKP",
            "FRF",
            "GBP",
            "GEK",
            "GEL",
            "GHC",
            "GHP",
            "GHS",
            "GIP",
            "GMD",
            "GNE",
            "GNF",
            "GNS",
            "GQE",
            "GRD",
            "GTQ",
            "GWE",
            "GWP",
            "GYD",
            "HKD",
            "HNL",
            "HRD",
            "HRK",
            "HTG",
            "HUF",
            "IDR",
            "IEP",
            "ILP",
            "ILR",
            "ILS",
            "INR",
            "IQD",
            "IRR",
            "ISJ",
            "ISK",
            "ITL",
            "JMD",
            "JOD",
            "JPY",
            "KES",
            "KGS",
            "KHR",
            "KMF",
            "KPW",
            "KRW",
            "KWD",
            "KYD",
            "KZT",
            "LAJ",
            "LAK",
            "LBP",
            "LKR",
            "LRD",
            "LSL",
            "LSM",
            "LTL",
            "LTT",
            "LUC",
            "LUF",
            "LUL",
            "LVL",
            "LVR",
            "LYD",
            "MAD",
            "MDL",
            "MGA",
            "MGF",
            "MKD",
            "MLF",
            "MMK",
            "MNT",
            "MOP",
            "MRO",
            "MRU",
            "MTL",
            "MTP",
            "MUR",
            "MVQ",
            "MVR",
            "MWK",
            "MXN",
            "MXP",
            "MXV",
            "MYR",
            "MZE",
            "MZM",
            "MZN",
            "NAD",
            "NGN",
            "NIC",
            "NIO",
            "NLG",
            "NOK",
            "NPR",
            "NZD",
            "OMR",
            "PAB",
            "PEH",
            "PEI",
            "PEN",
            "PES",
            "PGK",
            "PHP",
            "PKR",
            "PLN",
            "PLZ",
            "PTE",
            "PYG",
            "QAR",
            "RHD",
            "ROK",
            "ROL",
            "RON",
            "RSD",
            "RUB",
            "RUR",
            "RWF",
            "SAR",
            "SBD",
            "SCR",
            "SDD",
            "SDG",
            "SDP",
            "SEK",
            "SGD",
            "SHP",
            "SIT",
            "SKK",
            "SLL",
            "SOS",
            "SRD",
            "SRG",
            "SSP",
            "STD",
            "STN",
            "SUR",
            "SVC",
            "SYP",
            "SZL",
            "THB",
            "TJR",
            "TJS",
            "TMM",
            "TMT",
            "TND",
            "TOP",
            "TPE",
            "TRL",
            "TRY",
            "TTD",
            "TWD",
            "TZS",
            "UAH",
            "UAK",
            "UGS",
            "UGW",
            "UGX",
            "USD",
            "USN",
            "USS",
            "UYI",
            "UYN",
            "UYP",
            "UYU",
            "UYW",
            "UZS",
            "VEB",
            "VEF",
            "VES",
            "VNC",
            "VND",
            "VUV",
            "WST",
            "XAF",
            "XAG",
            "XAU",
            "XBA",
            "XBB",
            "XBC",
            "XBD",
            "XCD",
            "XDR",
            "XEU",
            "XFO",
            "XFU",
            "XOF",
            "XPD",
            "XPF",
            "XPT",
            "XRE",
            "XSU",
            "XTS",
            "XUA",
            "XXX",
            "YDD",
            "YER",
            "YUD",
            "YUM",
            "YUN",
            "ZAL",
            "ZAR",
            "ZMK",
            "ZMW",
            "ZRN",
            "ZRZ",
            "ZWC",
            "ZWD",
            "ZWL",
            "ZWN",
            "ZWR",
            null
          ]
        },
        "notes": {
          "title": "Notes",
          "description": "Any notes needed to understand or interpret the given statistic.",
          "type": [
            "string",
            "null"
          ]
        },
        "relatedLot": {
          "title": "Related Lot",
          "description": "The identifiers of the lots to which the statistic relates. If left blank, the statistic will be interpreted as applying to the whole tender.",
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "Bid": {
      "title": "Submission",
      "description": "A bid or expression of interest. Depending on the procedure, a bid can be an estimate, offer, proposal, quote or quotation. An expression of interest is also called a request to participate.",
      "type": "object",
      "required": [
        "id"
      ],
      "properties": {
        "id": {
          "title": "ID",
          "description": "A local identifier for the bid or expression of interest.",
          "type": "string"
        },
        "identifiers": {
          "title": "Identifiers",
          "description": "Identifiers for this bid or expression of interest. This field can be used to provide internal identifiers for the submission, such as identifiers from a buyer's document management system or procurement system.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/SimpleIdentifier"
          },
          "wholeListMerge": true,
          "uniqueItems": true,
          "minItems": 1
        },
        "submissionType": {
          "title": "Submission type",
          "description": "The type of the submission, using the closed [submissionType](https://github.com/open-contracting-extensions/ocds_bid_extension/blob/master/codelists/submissionType.csv) codelist.",
          "type": [
            "string",
            "null"
          ],
          "codelist": "submissionType.csv",
          "openCodelist": false,
          "enum": [
            "expressionOfInterest",
            "bid",
            null
          ]
        },
        "date": {
          "title": "Date",
          "description": "The date when the bid or expression of interest was received.",
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "description": {
          "title": "Description",
          "description": "A description of the bid or expression of interest. The description field may be used to describe the terms and conditions for the submission.",
          "type": [
            "string",
            "null"
          ]
        },
        "status": {
          "title": "Status",
          "description": "The status of the bid or expression of interest.",
          "type": [
            "string",
            "null"
          ],
          "codelist": "bidStatus.csv",
          "openCodelist": false,
          "enum": [
            "invited",
            "pending",
            "valid",
            "disqualified",
            "withdrawn",
            null
          ]
        },
        "items": {
          "title": "Items offered by the tenderer(s)",
          "description": "The goods, works or services offered by the tenderer(s), broken into line items wherever possible. Items should not be duplicated, but the quantity specified instead.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Item"
          },
          "uniqueItems": true
        },
        "tenderers": {
          "title": "Tenderer",
          "description": "The organization(s) responsible for the bid or expression of interest.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/OrganizationReference"
          }
        },
        "value": {
          "title": "Value",
          "description": "The total value of the bid (or expression of interest).",
          "$ref": "#/definitions/Value"
        },
        "validityPeriod": {
          "title": "Validity period",
          "description": "The period for which the bid or expression of interest is valid.",
          "$ref": "#/definitions/Period"
        },
        "documents": {
          "title": "Documents",
          "description": "All documents and attachments related to the bid or expression of interest and its evaluation.",
          "type": "array",
          "items": {
            "$ref": "#/definitions/Document"
          },
          "uniqueItems": true
        },
        "relatedLots": {
          "title": "Related lot(s)",
          "description": "The identifiers of the lots to which the bid or expression of interest relates.",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string"
          }
        },
        "countriesOfOrigin": {
          "title": "Countries of origin",
          "description": "The countries of origin of the items in the bid or expression of interest, from the closed country codelist. If a country is missing, [create an issue](https://github.com/open-contracting/standard/issues) to discuss the addition of a user-assigned code to the country codelist.",
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": "string",
            "enum": [
              "AD",
              "AE",
              "AF",
              "AG",
              "AI",
              "AL",
              "AM",
              "AO",
              "AQ",
              "AR",
              "AS",
              "AT",
              "AU",
              "AW",
              "AX",
              "AZ",
              "BA",
              "BB",
              "BD",
              "BE",
              "BF",
              "BG",
              "BH",
              "BI",
              "BJ",
              "BL",
              "BM",
              "BN",
              "BO",
              "BQ",
              "BR",
              "BS",
              "BT",
              "BV",
              "BW",
              "BY",
              "BZ",
              "CA",
              "CC",
              "CD",
              "CF",
              "CG",
              "CH",
              "CI",
              "CK",
              "CL",
              "CM",
              "CN",
              "CO",
              "CR",
              "CU",
              "CV",
              "CW",
              "CX",
              "CY",
              "CZ",
              "DE",
              "DJ",
              "DK",
              "DM",
              "DO",
              "DZ",
              "EC",
              "EE",
              "EG",
              "EH",
              "ER",
              "ES",
              "ET",
              "FI",
              "FJ",
              "FK",
              "FM",
              "FO",
              "FR",
              "GA",
              "GB",
              "GD",
              "GE",
              "GF",
              "GG",
              "GH",
              "GI",
              "GL",
              "GM",
              "GN",
              "GP",
              "GQ",
              "GR",
              "GS",
              "GT",
              "GU",
              "GW",
              "GY",
              "HK",
              "HM",
              "HN",
              "HR",
              "HT",
              "HU",
              "ID",
              "IE",
              "IL",
              "IM",
              "IN",
              "IO",
              "IQ",
              "IR",
              "IS",
              "IT",
              "JE",
              "JM",
              "JO",
              "JP",
              "KE",
              "KG",
              "KH",
              "KI",
              "KM",
              "KN",
              "KP",
              "KR",
              "KW",
              "KY",
              "KZ",
              "LA",
              "LB",
              "LC",
              "LI",
              "LK",
              "LR",
              "LS",
              "LT",
              "LU",
              "LV",
              "LY",
              "MA",
              "MC",
              "MD",
              "ME",
              "MF",
              "MG",
              "MH",
              "MK",
              "ML",
              "MM",
              "MN",
              "MO",
              "MP",
              "MQ",
              "MR",
              "MS",
              "MT",
              "MU",
              "MV",
              "MW",
              "MX",
              "MY",
              "MZ",
              "NA",
              "NC",
              "NE",
              "NF",
              "NG",
              "NI",
              "NL",
              "NO",
              "NP",
              "NR",
              "NU",
              "NZ",
              "OM",
              "PA",
              "PE",
              "PF",
              "PG",
              "PH",
              "PK",
              "PL",
              "PM",
              "PN",
              "PR",
              "PS",
              "PT",
              "PW",
              "PY",
              "QA",
              "RE",
              "RO",
              "RS",
              "RU",
              "RW",
              "SA",
              "SB",
              "SC",
              "SD",
              "SE",
              "SG",
              "SH",
              "SI",
              "SJ",
              "SK",
              "SL",
              "SM",
              "SN",
              "SO",
              "SR",
              "SS",
              "ST",
              "SV",
              "SX",
              "SY",
              "SZ",
              "TC",
              "TD",
              "TF",
              "TG",
              "TH",
              "TJ",
              "TK",
              "TL",
              "TM",
              "TN",
              "TO",
              "TR",
              "TT",
              "TV",
              "TW",
              "TZ",
              "UA",
              "UG",
              "UM",
              "US",
              "UY",
              "UZ",
              "VA",
              "VC",
              "VE",
              "VG",
              "VI",
              "VN",
              "VU",
              "WF",
              "WS",
              "XK",
              "YE",
              "YT",
              "ZA",
              "ZM",
              "ZW"
            ]
          },
          "codelist": "country.csv",
          "openCodelist": false,
          "minItems": 1
        },
        "hasRank": {
          "title": "Has rank",
          "description": "Whether the bid is ranked.",
          "type": [
            "boolean",
            "null"
          ]
        },
        "rank": {
          "title": "Rank",
          "description": "The position of the bid (i.e. whether the bid is ranked first, second, third, etc.) in a design contest, a framework agreement with multiple winners (e.g. cascades), an innovation partnership, a competitive dialogue, or another procedure.",
          "type": [
            "integer",
            "null"
          ]
        },
        "variant": {
          "title": "Is variant",
          "description": "Whether the bid is a variant. A variant is a bid that fulfills the buyer's needs differently than as proposed in the procurement documents.",
          "type": [
            "boolean",
            "null"
          ]
        }
      }
    },
    "SimpleIdentifier": {
      "title": "Simple identifier",
      "description": "An unambiguous reference to a resource within a given context.",
      "type": "object",
      "properties": {
        "scheme": {
          "title": "Scheme",
          "description": "The list, register or system from which the identifier is taken.",
          "type": [
            "string",
            "null"
          ],
          "minLength": 1
        },
        "id": {
          "title": "ID",
          "description": "The identifier taken from the scheme.",
          "type": [
            "string",
            "null"
          ],
          "versionId": true,
          "minLength": 1
        }
      },
      "minProperties": 1
    }
  }
}