Schema

For more information on the release schema, refer to the reference section in the OCDS documentation.

The release schema below is patched with the extensions used by the profile, and is provided here for convenience only. It can be downloaded as a JSON Schema file from https://standard.open-contracting.org/profiles/eu/latest/en/_static/patched/release-schema.json.

You can browse the schema using either the interactive browser or fields table below.

Schema browser

Fields table

Title

Description

Type

Format

Required

ocid

string

Required

Open Contracting ID

A globally unique identifier for this Open Contracting Process. Composed of an ocid prefix and an identifier for the contracting process. For more information see the Open Contracting Identifier guidance

id

string

Required

Release ID

An identifier for this particular release of information. A release identifier must be unique within the scope of its related contracting process (defined by a common ocid). A release identifier must not contain the # character.

date

string

date-time

Required

Release Date

The date on which the information contained in the release was first recorded in, or published by, any system.

tag

array[string]

Release Tag

One or more values from the closed releaseTag codelist. Tags can be used to filter releases and to understand the kind of information that releases might contain.

initiationType

string

Required

Initiation type

The type of initiation process used for this contract, from the closed initiationType codelist.

parties

array[Organization]

Parties

Information on the parties (organizations, economic operators and other participants) who are involved in the contracting process and their roles, e.g. buyer, procuring entity, supplier etc. Organization references elsewhere in the schema are used to refer back to this entries in this list.

See Organization

parties/0/name

[string, null]

Common name

A common name for this organization or other participant in the contracting process. The identifier object provides a space for the formal legal name, and so this may either repeat that value, or may provide the common name by which this organization or entity is known. This field may also include details of the department or sub-unit involved in this contracting process.

parties/0/id

string

Entity ID

The ID used for cross-referencing to this party from other sections of the release. This field may be built with the following structure {identifier.scheme}-{identifier.id}(-{department-identifier}).

parties/0/identifier

object

Primary identifier

The primary identifier for this organization or participant. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

parties/0/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

parties/0/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

parties/0/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

parties/0/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

parties/0/additionalIdentifiers

array[Identifier]

Additional identifiers

A list of additional / supplemental identifiers for the organization or participant, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

parties/0/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

parties/0/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

parties/0/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

parties/0/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

parties/0/address

object

Address

An address. This may be the legally registered address of the organization, or may be a correspondence address for this particular contracting process.

See Address

parties/0/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

parties/0/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

parties/0/address/region

[string, null]

Region

The region. For example, CA.

parties/0/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

parties/0/address/countryName

[string, null]

Country name

The country name. For example, United States.

parties/0/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

parties/0/contactPoint

object

Contact point

Contact details that can be used for this party.

See ContactPoint

parties/0/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

parties/0/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

parties/0/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

parties/0/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

parties/0/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

parties/0/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

parties/0/roles

array[string]

Party roles

The party's role(s) in the contracting process, using the open partyRole codelist.

parties/0/details

[object, null]

Details

Additional classification information about parties can be provided using partyDetail extensions that define particular fields and classification schemes.

parties/0/details/url

[string, null]

Website URL

The website of the organization.

parties/0/details/buyerProfile

[string, null]

Buyer profile URL

The Web address of the buyer profile.

parties/0/details/classifications

array[Classification]

Organization classifications

The classifications that categorize the organization

See Classification

parties/0/details/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

parties/0/details/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

parties/0/details/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

parties/0/details/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

parties/0/details/scale

[string, null]

Scale

The size or scale of the organization.

parties/0/additionalContactPoints

array[Contact point]

Additional contact points

An array of additional contact points that may be consulted for information. Additional contact points should each list the languages they operate in their name, and as structured data in the availableLanguage field.

See ContactPoint

parties/0/additionalContactPoints/0/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

parties/0/additionalContactPoints/0/email

[string, null]

Email

The e-mail address of the contact point/person.

parties/0/additionalContactPoints/0/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

parties/0/additionalContactPoints/0/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

parties/0/additionalContactPoints/0/url

[string, null]

uri

URL

A web address for the contact point/person.

parties/0/additionalContactPoints/0/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

parties/0/shareholders

array[Shareholder]

Organization shareholders

A list of shareholders in the organization: used to provide company ownership information for firms, primarily in the case of large and complex contracts, or Public Private Partnerships, that require disclosure of this information for certain bidders or awarded parties.

See Shareholder

parties/0/shareholders/0/id

[string]

Required

Shareholder ID

A local identifier for this shareholder, unique within this block. This field is used to keep track of multiple revisions of a shareholder through the compilation from release to record mechanism.

parties/0/shareholders/0/shareholder

object

Shareholder organization reference.

An organization reference pointing the entry in the parties section for the shareholding organization.

See OrganizationReference

parties/0/shareholders/0/shareholder/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

parties/0/shareholders/0/shareholder/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

parties/0/shareholders/0/shareholder/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

parties/0/shareholders/0/shareholder/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

parties/0/shareholders/0/shareholder/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

parties/0/shareholders/0/shareholder/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

parties/0/shareholders/0/shareholder/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

parties/0/shareholders/0/shareholder/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

parties/0/shareholders/0/shareholder/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

parties/0/shareholders/0/shareholder/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

parties/0/shareholders/0/shareholder/address/region

[string, null]

Region

The region. For example, CA.

parties/0/shareholders/0/shareholder/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

parties/0/shareholders/0/shareholder/address/countryName

[string, null]

Country name

The country name. For example, United States.

parties/0/shareholders/0/shareholder/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

parties/0/shareholders/0/shareholder/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

parties/0/shareholders/0/shareholder/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

parties/0/shareholders/0/shareholder/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

parties/0/shareholders/0/shareholder/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

parties/0/shareholders/0/shareholder/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

parties/0/shareholders/0/shareholder/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

parties/0/shareholders/0/shareholder/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

parties/0/shareholders/0/shareholder/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

parties/0/shareholders/0/shareholder/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

parties/0/shareholders/0/shareholder/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

parties/0/shareholders/0/shareholder/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

parties/0/shareholders/0/shareholder/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

parties/0/shareholders/0/shareholding

[number, null]

Shareholding

The percentage of shares held by the shareholder, expressed as a decimal value between 0 and 1.

parties/0/shareholders/0/votingRights

[string, null]

Shareholder voting rights

The type of voting rights associated with the shares held by the shareholder.

parties/0/shareholders/0/votingRightsDetails

[string, null]

Shareholder voting rights details

Detailed information about the shareholder's voting rights. This field should be completed when the shareholder voting rights are restricted, additional or enhanced.

parties/0/shareholders/0/notes

[string, null]

Shareholder notes

Additional notes on this shareholder. This field should be used to provide details on any caps on equity transfer, or lock-in arrangements, applicable to this shareholder.

buyer

object

Buyer

A buyer is an entity whose budget will be used to pay for goods, works or services related to a contract. This may be different from the procuring entity who may be specified in the tender data.

See OrganizationReference

buyer/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

buyer/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

buyer/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

buyer/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

buyer/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

buyer/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

buyer/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

buyer/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

buyer/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

buyer/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

buyer/address/region

[string, null]

Region

The region. For example, CA.

buyer/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

buyer/address/countryName

[string, null]

Country name

The country name. For example, United States.

buyer/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

buyer/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

buyer/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

buyer/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

buyer/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

buyer/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

buyer/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

buyer/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

buyer/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

buyer/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

buyer/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

buyer/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

buyer/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

planning

object

Planning

Information from the planning phase of the contracting process. This includes information related to the process of deciding what to contract, when and how.

See Planning

planning/rationale

[string, null]

Rationale

The rationale for the procurement provided in free text. More detail can be provided in an attached document.

planning/budget

object

Budget

Details of the budget that funds this contracting process.

See Budget

planning/budget/id

[string, integer, null]

ID

An identifier for the budget line item which provides funds for this contracting process. This identifier should be possible to cross-reference against the provided data source.

planning/budget/description

[string, null]

Budget Source

A short free text description of the budget source. May be used to provide the title of the budget line, or the programme used to fund this project.

planning/budget/amount

object

Amount

The value reserved in the budget for this contracting process. A negative value indicates anticipated income to the budget as a result of this contracting process, rather than expenditure. Where the budget is drawn from multiple sources, the budget breakdown extension can be used.

See Value

planning/budget/amount/amount

[number, null]

Amount

Amount as a number.

planning/budget/amount/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

planning/budget/project

[string, null]

Project title

The name of the project through which this contracting process is funded (if applicable). Some organizations maintain a registry of projects, and the data should use the name by which the project is known in that registry. No translation option is offered for this string, as translated values can be provided in third-party data, linked from the data source above.

planning/budget/projectID

[string, integer, null]

Project identifier

An external identifier for the project that this contracting process forms part of, or is funded via (if applicable). Some organizations maintain a registry of projects, and the data should use the identifier from the relevant registry of projects.

planning/budget/uri

[string, null]

uri

Linked budget information

A URI pointing directly to a machine-readable record about the budget line-item or line-items that fund this contracting process. Information can be provided in a range of formats, including using IATI, the Open Fiscal Data Standard or any other standard which provides structured data on budget sources. Human readable documents can be included using the planning.documents block.

planning/budget/source

[string, null]

uri

Data Source

(Deprecated in 1.1) Used to point either to a corresponding Budget Data Package, or to a machine or human-readable source where users can find further information on the budget line item identifiers, or project identifiers, provided here.

This property was deprecated in version 1.1

The budget data source field was intended to link to machine-readable data about the budget for a contracting process, but has been widely mis-used to provide free-text descriptions of budget providers. As a result, it has been removed from version 1.1. budget/uri can be used to provide a link to machine-readable budget information, and budget/description can be used to provide human-readable information on the budget source.

planning/budget/finance

array[Financing arrangements]

Finance

An array with details of each source of finance planned for this procedure.

See Finance

planning/budget/finance/0/id

string

Required

ID

An identifier for this financing arrangement.

planning/budget/finance/0/title

[string, null]

Title

A short title for this financing arrangement.

planning/budget/finance/0/description

[string, null]

Description

A short description of this financing arrangement. This may include details of lender rights, step in arrangements, exchange rate guarantees, and for syndicated loans, details of syndication and any banks who are known parties to the loan.

planning/budget/finance/0/financingParty

object

Financing party

The party providing this financing arrangement.

See OrganizationReference

planning/budget/finance/0/financingParty/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

planning/budget/finance/0/financingParty/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

planning/budget/finance/0/financingParty/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

planning/budget/finance/0/financingParty/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

planning/budget/finance/0/financingParty/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

planning/budget/finance/0/financingParty/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

planning/budget/finance/0/financingParty/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

planning/budget/finance/0/financingParty/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

planning/budget/finance/0/financingParty/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

planning/budget/finance/0/financingParty/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

planning/budget/finance/0/financingParty/address/region

[string, null]

Region

The region. For example, CA.

planning/budget/finance/0/financingParty/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

planning/budget/finance/0/financingParty/address/countryName

[string, null]

Country name

The country name. For example, United States.

planning/budget/finance/0/financingParty/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

planning/budget/finance/0/financingParty/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

planning/budget/finance/0/financingParty/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

planning/budget/finance/0/financingParty/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

planning/budget/finance/0/financingParty/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

planning/budget/finance/0/financingParty/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

planning/budget/finance/0/financingParty/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

planning/budget/finance/0/financingParty/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

planning/budget/finance/0/financingParty/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

planning/budget/finance/0/financingParty/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

planning/budget/finance/0/financingParty/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

planning/budget/finance/0/financingParty/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

planning/budget/finance/0/financingParty/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

planning/budget/finance/0/financeType

[string, null]

Finance type

The type of finance arranged.

planning/budget/finance/0/financeCategory

[string, null]

Finance category

The nature of the finance. This information can be used when determining the order of preference for investors to get their money back in cases of liquidation.

planning/budget/finance/0/value

object

Value

The total value of this finance.

See Value

planning/budget/finance/0/value/amount

[number, null]

Amount

Amount as a number.

planning/budget/finance/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

planning/budget/finance/0/period

object

Finance period

What period is covered by this finance.

See Period

planning/budget/finance/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

planning/budget/finance/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

planning/budget/finance/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

planning/budget/finance/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

planning/budget/finance/0/interestRate

object

Interest rate

The interest rate associated with this finance.

planning/budget/finance/0/interestRate/base

[string, number, null]

Base

The variable to which an additional margin amount is added to get the Interest amount. This can be specified as a fixed number, as a known variable (e.g. LIBOR or LIBOR+1%), or can be omitted if margin specifies the entire interest rate.

planning/budget/finance/0/interestRate/margin

[number, null]

Margin

The variable added to the base to give the Interest amount expressed as a decimal fraction (e.g. 12.5% = 0.125).

planning/budget/finance/0/interestRate/fixed

[boolean, null]

Fixed rate

A boolean field. If this interest rate of fixed, set to true. Otherwise, set to false.

planning/budget/finance/0/interestRate/notes

[string, null]

Notes

Any explanatory notes concerning the interest rate.

planning/budget/finance/0/repaymentFrequency

[number, null]

Repayment frequency (days)

What is the average repayment frequency (in days) for this source of finance. For example, for yearly, use 365; for monthly repayment use 30.4; for daily use 1. User interfaces may wish to translate this into a more user-friendly presentation, such as 'daily','monthly' or 'yearly'.

planning/budget/finance/0/stepInRights

[boolean, null]

Step in rights

Does provision of this finance confer any step in rights on the financing party? Step in rights are the lender's option to assume certain contractual responsibilities of a project party through managing their contract in cases when that party is not meeting its obligations under such a contract. This is a true/false field to indicate when step in rights exist. If there are step in rights, details should be provided in the description field, and in additional contract documents.

planning/budget/finance/0/exchangeRateGuarantee

[boolean, null]

Exchange rate guarantees

Is there an associated exchange rate guarantee with this source of finance. This is a true/false field to indicate when exchange rate guarantees exist. Details of any guarantees can be provided in the finance description, or in associated documents.

planning/budget/finance/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this financing arrangement relates.

planning/documents

array[Document]

Documents

A list of documents related to the planning process.

See Document

planning/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

planning/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

planning/documents/0/title

[string, null]

Title

The document title.

planning/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

planning/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

planning/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

planning/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

planning/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

planning/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

planning/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

planning/milestones

array[Milestone]

Planning milestones

A list of milestones associated with the planning stage.

See Milestone

planning/milestones/0/id

[string, integer]

Required

ID

A local identifier for this milestone, unique within this block. This field is used to keep track of multiple revisions of a milestone through the compilation from release to record mechanism.

planning/milestones/0/title

[string, null]

Title

Milestone title

planning/milestones/0/type

[string, null]

Milestone type

The nature of the milestone, using the open milestoneType codelist.

planning/milestones/0/description

[string, null]

Description

A description of the milestone.

planning/milestones/0/code

[string, null]

Milestone code

Milestone codes can be used to track specific events that take place for a particular kind of contracting process. For example, a code of 'approvalLetter' can be used to allow applications to understand this milestone represents the date an approvalLetter is due or signed.

planning/milestones/0/dueDate

[string, null]

date-time

Due date

The date the milestone is due.

planning/milestones/0/dateMet

[string, null]

date-time

Date met

The date on which the milestone was met.

planning/milestones/0/dateModified

[string, null]

date-time

Date modified

The date the milestone was last reviewed or modified and the status was altered or confirmed to still be correct.

planning/milestones/0/status

[string, null]

Status

The status that was realized on the date provided in dateModified, from the closed milestoneStatus codelist.

planning/milestones/0/documents

array[Document]

Documents

List of documents associated with this milestone (Deprecated in 1.1).

See Document

This property was deprecated in version 1.1

Inclusion of documents at the milestone level is now deprecated. Documentation should be attached in the tender, award, contract or implementation sections, and titles and descriptions used to highlight the related milestone. Publishers who wish to continue to provide documents at the milestone level should explicitly declare this by using the milestone documents extension.

planning/milestones/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

planning/milestones/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

planning/milestones/0/documents/0/title

[string, null]

Title

The document title.

planning/milestones/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

planning/milestones/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

planning/milestones/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

planning/milestones/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

planning/milestones/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

planning/milestones/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

planning/milestones/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

planning/milestones/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this milestone relates.

planning/forecasts

array[Metric]

Forecasts

Any forecasts metrics for this results of this contracting process.

See Metric

planning/forecasts/0/id

[string]

Required

Identifier

An identifier for this metric. In some cases this may be drawn from a codelist of metrics required for this type of contracting process, or in other instances may be an arbitrary identifier.

planning/forecasts/0/title

[string, null]

Title

The title of this metric

planning/forecasts/0/description

[string, null]

Description

A short description of the metric. This may include short details of measurement methods.

planning/forecasts/0/observations

array[Observation]

Observations

An array of target or actual values for this metric.

See Observation

planning/forecasts/0/observations/0/id

string

Required

Identifier

A local identifier for this specific observation. This may be an arbitrary identifier, or could be a composite of the metric identifier, and the date and other dimensions of this observation.

planning/forecasts/0/observations/0/period

object

Period

The period over which this observation is measured.

See Period

planning/forecasts/0/observations/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

planning/forecasts/0/observations/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

planning/forecasts/0/observations/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

planning/forecasts/0/observations/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

planning/forecasts/0/observations/0/value

object

Value

For financial metrics, the value of this forecast, target or actual observation.

See Value

planning/forecasts/0/observations/0/value/amount

[number, null]

Amount

Amount as a number.

planning/forecasts/0/observations/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

planning/forecasts/0/observations/0/measure

[string, number, null]

Measure

For non-financial metrics, the measure of this forecast, target or actual observation. Measures may be provided as free text or numerical values.

planning/forecasts/0/observations/0/unit

object

Unit

Unit

planning/forecasts/0/observations/0/unit/name

[string, null]

Unit name

The name of the unit.

planning/forecasts/0/observations/0/unit/scheme

[string, null]

Scheme

The list from which units of measure identifiers are taken. Use of the scheme 'UNCEFACT' for the UN/CEFACT Recommendation 20 list of "Codes for Units of Measure Used in International Trade" is recommended.

planning/forecasts/0/observations/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. For example, with UNCEFACT, this is the value of the 'Common Code' column. From this identifier, applications can look-up the human readable name or symbol for this unit of measure.

planning/forecasts/0/observations/0/unit/uri

[string, null]

uri

URI

If the scheme used provide a machine-readable URI for this unit of measure, this can be given.

planning/forecasts/0/observations/0/dimensions

object

Dimensions

Any number of dimensions can be recorded within this object. Dimensions names should follow the camelCase conventions of OCDS.

planning/forecasts/0/observations/0/notes

[string, null]

Notes

Any notes on this observation. This may include clarifying information.

planning/forecasts/0/observations/0/relatedImplementationMilestone

object

Related implementation milestone

A link to the milestone in the implementation section of OCDS to which this forecast, target or actual observation relates.

See MilestoneReference

planning/forecasts/0/observations/0/relatedImplementationMilestone/id

string

Required

Milestone ID

The ID of the milestone being referenced, this must match the ID of a milestone described elsewhere in a release about this contracting process.

planning/forecasts/0/observations/0/relatedImplementationMilestone/title

[string, null]

Milestone title

The title of the milestone being referenced, this must match the title of a milestone described elsewhere in a release about this contracting process.

tender

object

Tender

The activities undertaken in order to enter into a contract.

See Tender

tender/id

[string, integer]

Required

Tender ID

An identifier for this tender process. This may be the same as the ocid, or may be an internal identifier for this tender.

tender/title

[string, null]

Tender title

A title for this tender. This will often be used by applications as a headline to attract interest, and to help analysts understand the nature of this procurement.

tender/description

[string, null]

Tender description

A summary description of the tender. This complements any structured information provided using the items array. Descriptions should be short and easy to read. Avoid using ALL CAPS.

tender/status

[string, null]

Tender status

The current status of the tender, from the closed tenderStatus codelist.

tender/procuringEntity

object

Procuring entity

The entity managing the procurement. This may be different from the buyer who pays for, or uses, the items being procured.

See OrganizationReference

tender/procuringEntity/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

tender/procuringEntity/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

tender/procuringEntity/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/procuringEntity/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/procuringEntity/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/procuringEntity/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/procuringEntity/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/procuringEntity/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/procuringEntity/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/procuringEntity/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/procuringEntity/address/region

[string, null]

Region

The region. For example, CA.

tender/procuringEntity/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/procuringEntity/address/countryName

[string, null]

Country name

The country name. For example, United States.

tender/procuringEntity/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/procuringEntity/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/procuringEntity/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/procuringEntity/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/procuringEntity/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/procuringEntity/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/procuringEntity/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/procuringEntity/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

tender/procuringEntity/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

tender/procuringEntity/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

tender/procuringEntity/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

tender/procuringEntity/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

tender/procuringEntity/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

tender/items

array[Item]

Items to be procured

The goods and services to be purchased, broken into line items wherever possible. Items should not be duplicated, but the quantity specified instead.

See Item

tender/items/0/id

[string, integer]

Required

ID

A local identifier to reference and merge the items by. Must be unique within a given array of items.

tender/items/0/description

[string, null]

Description

A description of the goods, services to be provided.

tender/items/0/classification

object

Classification

The primary classification for the item.

See Classification

tender/items/0/classification/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/items/0/classification/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/items/0/classification/description

[string, null]

Description

A textual description or title for the classification code.

tender/items/0/classification/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/items/0/additionalClassifications

array[Classification]

Additional classifications

An array of additional classifications for the item.

See Classification

tender/items/0/additionalClassifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/items/0/additionalClassifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/items/0/additionalClassifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/items/0/additionalClassifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/items/0/quantity

[number, null]

Quantity

The number of units to be provided.

tender/items/0/unit

object

Unit

A description of the unit in which the supplies, services or works are provided (e.g. hours, kilograms) and the unit-price.

tender/items/0/unit/scheme

[string, null]

Scheme

The list from which identifiers for units of measure are taken, using the open unitClassificationScheme codelist. 'UNCEFACT' is recommended.

tender/items/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. Check the unitClassificationScheme codelist for details of how to find and use identifiers from the scheme in use.

tender/items/0/unit/name

[string, null]

Name

Name of the unit.

tender/items/0/unit/value

object

Value

The monetary value of a single unit.

See Value

tender/items/0/unit/value/amount

[number, null]

Amount

Amount as a number.

tender/items/0/unit/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/items/0/unit/uri

[string, null]

uri

URI

The machine-readable URI for the unit of measure, provided by the scheme.

tender/items/0/deliveryAddresses

array[Address]

Delivery Addresses

The addresses to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

tender/items/0/deliveryAddresses/0/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/items/0/deliveryAddresses/0/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/items/0/deliveryAddresses/0/region

[string, null]

Region

The region. For example, CA.

tender/items/0/deliveryAddresses/0/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/items/0/deliveryAddresses/0/countryName

[string, null]

Country name

The country name. For example, United States.

tender/items/0/deliveryAddresses/0/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/items/0/deliveryLocations

array[Delivery Location]

Delivery Locations

The locations where activity related to this tender, contract or license will be delivered

See Location

tender/items/0/deliveryLocations/0/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

tender/items/0/deliveryLocations/0/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

tender/items/0/deliveryLocations/0/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

tender/items/0/deliveryLocations/0/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

tender/items/0/deliveryLocations/0/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

tender/items/0/deliveryLocations/0/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

tender/items/0/deliveryLocations/0/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

tender/items/0/deliveryLocations/0/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

tender/items/0/deliveryLocation

object

Delivery Location

The location where activity related to this tender, contract or license will be delivered, or will take place.

See Location

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryLocations` to support items with multiple delivery locations.

tender/items/0/deliveryLocation/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

tender/items/0/deliveryLocation/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

tender/items/0/deliveryLocation/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

tender/items/0/deliveryLocation/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

tender/items/0/deliveryLocation/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

tender/items/0/deliveryLocation/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

tender/items/0/deliveryLocation/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

tender/items/0/deliveryLocation/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

tender/items/0/deliveryAddress

object

Delivery Address

The address to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryAddresses` to support items with multiple delivery locations.

tender/items/0/deliveryAddress/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/items/0/deliveryAddress/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/items/0/deliveryAddress/region

[string, null]

Region

The region. For example, CA.

tender/items/0/deliveryAddress/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/items/0/deliveryAddress/countryName

[string, null]

Country name

The country name. For example, United States.

tender/items/0/deliveryAddress/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/items/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this item relates.

tender/value

object

Value

The total upper estimated value of the procurement. A negative value indicates that the contracting process may involve payments from the supplier to the buyer (commonly used in concession contracts).

See Value

tender/value/amount

[number, null]

Amount

Amount as a number.

tender/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/minValue

object

Minimum value

The minimum estimated value of the procurement. A negative value indicates that the contracting process may involve payments from the supplier to the buyer (commonly used in concession contracts).

See Value

tender/minValue/amount

[number, null]

Amount

Amount as a number.

tender/minValue/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/procurementMethod

[string, null]

Procurement method

The procurement method, from the closed method codelist.

tender/procurementMethodDetails

[string, null]

Procurement method details

Additional detail on the procurement method used. This field can be used to provide the local name of the particular procurement method used.

tender/procurementMethodRationale

[string, null]

Procurement method rationale

Rationale for the chosen procurement method. This is especially important to provide a justification in the case of limited tenders or direct awards.

tender/mainProcurementCategory

[string, null]

Main procurement category

The primary category describing the main object of this contracting process, from the closed procurementCategory codelist.

tender/additionalProcurementCategories

array[string]

Additional procurement categories

Any additional categories describing the objects of this contracting process, using the open extendedProcurementCategory codelist.

tender/awardCriteria

[string, null]

Award criteria

The award criteria for the procurement, using the open awardCriteria codelist.

tender/awardCriteriaDetails

[string, null]

Award criteria details

Any detailed or further information on the award or selection criteria.

tender/submissionMethod

array[string]

Submission method

The methods by which bids are submitted, using the open submissionMethod codelist.

tender/submissionMethodDetails

[string, null]

Submission method details

Any detailed or further information on the submission method. This can include the address, e-mail address or online service to which bids are submitted, and any special requirements to be followed for submissions.

tender/tenderPeriod

object

Tender period

The period when the tender is open for submissions. The end date is the closing date for tender submissions.

See Period

tender/tenderPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/tenderPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/tenderPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/tenderPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/enquiryPeriod

object

Enquiry period

The period during which potential bidders may submit questions and requests for clarification to the entity managing procurement. Details of how to submit enquiries should be provided in attached notices, or in submissionMethodDetails. Structured dates for when responses to questions will be made can be provided using tender milestones.

See Period

tender/enquiryPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/enquiryPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/enquiryPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/enquiryPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/hasEnquiries

[boolean, null]

Has enquiries?

A true/false field to indicate whether any enquiries were received during the tender process. Structured information on enquiries that were received, and responses to them, can be provided using the enquiries extension.

tender/eligibilityCriteria

[string, null]

Eligibility criteria

A description of any eligibility criteria for potential suppliers.

tender/awardPeriod

object

Evaluation and award period

The period for decision making regarding the contract award. The end date should be the date on which an award decision is due to be finalized. The start date may be used to indicate the start of an evaluation period.

See Period

tender/awardPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/awardPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/awardPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/awardPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/contractPeriod

object

Contract period

The period over which the contract is estimated or required to be active. If the tender does not specify explicit dates, the duration field may be used.

See Period

tender/contractPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/contractPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/contractPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/contractPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/numberOfTenderers

[integer, null]

Number of tenderers

The number of parties who submit a bid.

tender/tenderers

array[Organization reference]

Tenderers

All parties who submit a bid on a tender. More detailed information on bids and the bidding organization can be provided using the bid extension.

See OrganizationReference

tender/tenderers/0/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

tender/tenderers/0/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

tender/tenderers/0/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/tenderers/0/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/tenderers/0/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/tenderers/0/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/tenderers/0/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/tenderers/0/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/tenderers/0/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/tenderers/0/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/tenderers/0/address/region

[string, null]

Region

The region. For example, CA.

tender/tenderers/0/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/tenderers/0/address/countryName

[string, null]

Country name

The country name. For example, United States.

tender/tenderers/0/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/tenderers/0/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/tenderers/0/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/tenderers/0/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/tenderers/0/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/tenderers/0/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/tenderers/0/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/tenderers/0/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

tender/tenderers/0/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

tender/tenderers/0/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

tender/tenderers/0/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

tender/tenderers/0/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

tender/tenderers/0/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

tender/documents

array[Document]

Documents

All documents and attachments related to the tender, including any notices. See the documentType codelist for details of potential documents to include. Common documents include official legal notices of tender, technical specifications, evaluation criteria, and, as a tender process progresses, clarifications and replies to queries.

See Document

tender/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

tender/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

tender/documents/0/title

[string, null]

Title

The document title.

tender/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

tender/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

tender/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

tender/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

tender/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

tender/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

tender/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

tender/milestones

array[Milestone]

Milestones

A list of milestones associated with the tender.

See Milestone

tender/milestones/0/id

[string, integer]

Required

ID

A local identifier for this milestone, unique within this block. This field is used to keep track of multiple revisions of a milestone through the compilation from release to record mechanism.

tender/milestones/0/title

[string, null]

Title

Milestone title

tender/milestones/0/type

[string, null]

Milestone type

The nature of the milestone, using the open milestoneType codelist.

tender/milestones/0/description

[string, null]

Description

A description of the milestone.

tender/milestones/0/code

[string, null]

Milestone code

Milestone codes can be used to track specific events that take place for a particular kind of contracting process. For example, a code of 'approvalLetter' can be used to allow applications to understand this milestone represents the date an approvalLetter is due or signed.

tender/milestones/0/dueDate

[string, null]

date-time

Due date

The date the milestone is due.

tender/milestones/0/dateMet

[string, null]

date-time

Date met

The date on which the milestone was met.

tender/milestones/0/dateModified

[string, null]

date-time

Date modified

The date the milestone was last reviewed or modified and the status was altered or confirmed to still be correct.

tender/milestones/0/status

[string, null]

Status

The status that was realized on the date provided in dateModified, from the closed milestoneStatus codelist.

tender/milestones/0/documents

array[Document]

Documents

List of documents associated with this milestone (Deprecated in 1.1).

See Document

This property was deprecated in version 1.1

Inclusion of documents at the milestone level is now deprecated. Documentation should be attached in the tender, award, contract or implementation sections, and titles and descriptions used to highlight the related milestone. Publishers who wish to continue to provide documents at the milestone level should explicitly declare this by using the milestone documents extension.

tender/milestones/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

tender/milestones/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

tender/milestones/0/documents/0/title

[string, null]

Title

The document title.

tender/milestones/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

tender/milestones/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

tender/milestones/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

tender/milestones/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

tender/milestones/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

tender/milestones/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

tender/milestones/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

tender/milestones/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this milestone relates.

tender/amendments

array[Amendment]

Amendments

A tender amendment is a formal change to the tender, and generally involves the publication of a new tender notice/release. The rationale and a description of the changes made can be provided here.

See Amendment

tender/amendments/0/date

[string, null]

date-time

Amendment date

The date of this amendment.

tender/amendments/0/rationale

[string, null]

Rationale

An explanation for the amendment.

tender/amendments/0/id

[string, null]

ID

An identifier for this amendment: often the amendment number

tender/amendments/0/description

[string, null]

Description

A free text, or semi-structured, description of the changes made in this amendment.

tender/amendments/0/amendsReleaseID

[string, null]

Amended release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process before the amendment was made.

tender/amendments/0/releaseID

[string, null]

Amending release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process after the amendment was made.

tender/amendments/0/changes

array[object]

Amended fields

An array of change objects describing the fields changed, and their former values. (Deprecated in 1.1)

This property was deprecated in version 1.1

A free-text or semi-structured string describing the changes made in each amendment can be provided in the amendment.description field. To provide structured information on the fields that have changed, publishers should provide releases indicating the state of the contracting process before and after the amendment.

tender/amendments/0/changes/0/property

string

Property

The property name that has been changed relative to the place the amendment is. For example if the contract value has changed, then the property under changes within the contract.amendment would be value.amount. (Deprecated in 1.1)

tender/amendments/0/unstructuredChanges

array[Unstructured change]

Unstructured changes

Unstructured or semi-structured changes to an earlier notice.

See UnstructuredChange

tender/amendments/0/unstructuredChanges/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this change relates, if any.

tender/amendments/0/unstructuredChanges/0/oldValue

object

Old value

The value of the data element referenced by the where field, before the change.

See UnstructuredChangeValue

tender/amendments/0/unstructuredChanges/0/oldValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

tender/amendments/0/unstructuredChanges/0/oldValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

tender/amendments/0/unstructuredChanges/0/oldValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/amendments/0/unstructuredChanges/0/oldValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/amendments/0/unstructuredChanges/0/oldValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/amendments/0/unstructuredChanges/0/oldValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/amendments/0/unstructuredChanges/0/oldValue/date

[string, null]

Date

A date.

tender/amendments/0/unstructuredChanges/0/newValue

object

New value

The value of the data element referenced by the where field, after the change.

See UnstructuredChangeValue

tender/amendments/0/unstructuredChanges/0/newValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

tender/amendments/0/unstructuredChanges/0/newValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

tender/amendments/0/unstructuredChanges/0/newValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/amendments/0/unstructuredChanges/0/newValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/amendments/0/unstructuredChanges/0/newValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/amendments/0/unstructuredChanges/0/newValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/amendments/0/unstructuredChanges/0/newValue/date

[string, null]

Date

A date.

tender/amendments/0/unstructuredChanges/0/where

object

Where

A reference to a data element on an earlier notice that is being changed.

tender/amendments/0/unstructuredChanges/0/where/section

[string, null]

Section

The identifier of the section containing the data element, if the earlier notice is organized into sections.

tender/amendments/0/unstructuredChanges/0/where/label

[string, null]

Label

The label for the data element.

tender/amendment

object

Amendment

The use of individual amendment objects has been deprecated. From OCDS 1.1 information should be provided in the amendments array.

See Amendment

This property was deprecated in version 1.1

The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.

tender/amendment/date

[string, null]

date-time

Amendment date

The date of this amendment.

tender/amendment/rationale

[string, null]

Rationale

An explanation for the amendment.

tender/amendment/id

[string, null]

ID

An identifier for this amendment: often the amendment number

tender/amendment/description

[string, null]

Description

A free text, or semi-structured, description of the changes made in this amendment.

tender/amendment/amendsReleaseID

[string, null]

Amended release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process before the amendment was made.

tender/amendment/releaseID

[string, null]

Amending release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process after the amendment was made.

tender/amendment/changes

array[object]

Amended fields

An array of change objects describing the fields changed, and their former values. (Deprecated in 1.1)

This property was deprecated in version 1.1

A free-text or semi-structured string describing the changes made in each amendment can be provided in the amendment.description field. To provide structured information on the fields that have changed, publishers should provide releases indicating the state of the contracting process before and after the amendment.

tender/amendment/changes/0/property

string

Property

The property name that has been changed relative to the place the amendment is. For example if the contract value has changed, then the property under changes within the contract.amendment would be value.amount. (Deprecated in 1.1)

tender/amendment/unstructuredChanges

array[Unstructured change]

Unstructured changes

Unstructured or semi-structured changes to an earlier notice.

See UnstructuredChange

tender/amendment/unstructuredChanges/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this change relates, if any.

tender/amendment/unstructuredChanges/0/oldValue

object

Old value

The value of the data element referenced by the where field, before the change.

See UnstructuredChangeValue

tender/amendment/unstructuredChanges/0/oldValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

tender/amendment/unstructuredChanges/0/oldValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

tender/amendment/unstructuredChanges/0/oldValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/amendment/unstructuredChanges/0/oldValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/amendment/unstructuredChanges/0/oldValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/amendment/unstructuredChanges/0/oldValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/amendment/unstructuredChanges/0/oldValue/date

[string, null]

Date

A date.

tender/amendment/unstructuredChanges/0/newValue

object

New value

The value of the data element referenced by the where field, after the change.

See UnstructuredChangeValue

tender/amendment/unstructuredChanges/0/newValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

tender/amendment/unstructuredChanges/0/newValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

tender/amendment/unstructuredChanges/0/newValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/amendment/unstructuredChanges/0/newValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/amendment/unstructuredChanges/0/newValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/amendment/unstructuredChanges/0/newValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/amendment/unstructuredChanges/0/newValue/date

[string, null]

Date

A date.

tender/amendment/unstructuredChanges/0/where

object

Where

A reference to a data element on an earlier notice that is being changed.

tender/amendment/unstructuredChanges/0/where/section

[string, null]

Section

The identifier of the section containing the data element, if the earlier notice is organized into sections.

tender/amendment/unstructuredChanges/0/where/label

[string, null]

Label

The label for the data element.

tender/bidOpening

object

Bid opening

The date, time, place and other details of the bid opening.

See BidOpening

tender/bidOpening/date

[string, null]

date-time

Date and time

The date and time of the bid opening.

tender/bidOpening/location

object

Location

The place where the bid opening occurs.

See Location

tender/bidOpening/location/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

tender/bidOpening/location/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

tender/bidOpening/location/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

tender/bidOpening/location/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

tender/bidOpening/location/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

tender/bidOpening/location/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

tender/bidOpening/location/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

tender/bidOpening/location/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

tender/bidOpening/address

object

Address

The address of the place where the bid opening occurs.

See Address

tender/bidOpening/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/bidOpening/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/bidOpening/address/region

[string, null]

Region

The region. For example, CA.

tender/bidOpening/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/bidOpening/address/countryName

[string, null]

Country name

The country name. For example, United States.

tender/bidOpening/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/bidOpening/description

[string, null]

Details

Any other details about the bid opening (who can participate, whether authorization is needed, etc.).

tender/communication

object

Communication

Modalities of communication about key events.

tender/communication/atypicalToolUrl

[string, null]

uri

Atypical tool URL

Electronic communication with the procuring entity requires the use of tools and devices that are not generally available. These tools are accessible via this URL.

tender/communication/futureNoticeDate

[string, null]

date-time

Future notice date

The estimated date of publication of the next sequential notice.

tender/communication/documentAvailabilityPeriod

object

Document availability period

The period during which documents can be accessed, or during which requests for access to documents can be submitted.

See Period

tender/communication/documentAvailabilityPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/communication/documentAvailabilityPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/communication/documentAvailabilityPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/communication/documentAvailabilityPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/contractTerms

object

Contract terms

Information about the terms governing the future contracts from the procedure.

See ContractTerms

tender/contractTerms/hasElectronicPayment

[boolean, null]

Electronic payment used

Whether electronic payment is used.

tender/contractTerms/hasElectronicOrdering

[boolean, null]

Electronic ordering used

Whether electronic ordering is used.

tender/contractTerms/electronicInvoicingPolicy

[string, null]

Electronic invoicing policy

Whether the buyer will require, allow or not allow electronic invoices.

tender/contractTerms/reservedExecution

[boolean, null]

Reserved execution

Whether the execution of the contract is restricted to the framework of sheltered employment programmes.

tender/contractTerms/performanceTerms

[string, null]

Terms performance

The main information about the performance of the contract (e.g. intermediary deliverables, compensation for damages, intellectual property rights).

tender/contractTerms/financialTerms

[string, null]

Financial terms

The main information about financing and payment and/or reference to any provisions that govern them.

tender/contractTerms/tendererLegalForm

[string, null]

Tenderer legal form

A certain legal form that must be taken by a group of tenderers that is awarded a contract.

tender/contractTerms/hasExclusiveRights

[boolean, null]

Has exclusive rights

A right entitling a public service operator to operate certain public passenger transport services on a particular route or network or in a particular area, to the exclusion of any other such operator.

tender/contractTerms/exclusiveRights

[string, null]

Exclusive rights

The nature and extent of the exclusive rights granted by the procuring entity to the supplier.

tender/contractTerms/operatorRevenueShare

[number, null]

Operator revenue share

The percentage of revenue from the sale of tickets allocated to the supplier.

tender/contractTerms/otherTerms

[string, null]

Other terms

Other contract terms that do not fit the semantics of any other OCDS field.

tender/contractTerms/rewardsAndPenalties

[string, null]

Rewards and penalties

Information about rewards and penalties relating to quality targets.

tender/contractTerms/socialStandards

[string, null]

Social standards

The required social standards, for example: detail of the contractual rights of the staff concerned, and conditions under which employees are considered to be linked to the services.

tender/coveredBy

array[string]

Covered by

The treaties that the contracting process is covered by.

tender/designContest

object

Design contest

Information about the organization of a design contest.

See DesignContest

tender/designContest/selectedParticipants

array[Organization reference]

Selected participants

The parties that have already been selected to participate to the design contest.

See OrganizationReference

tender/designContest/selectedParticipants/0/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

tender/designContest/selectedParticipants/0/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

tender/designContest/selectedParticipants/0/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/designContest/selectedParticipants/0/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/designContest/selectedParticipants/0/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/designContest/selectedParticipants/0/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/designContest/selectedParticipants/0/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/designContest/selectedParticipants/0/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/designContest/selectedParticipants/0/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/designContest/selectedParticipants/0/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/designContest/selectedParticipants/0/address/region

[string, null]

Region

The region. For example, CA.

tender/designContest/selectedParticipants/0/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/designContest/selectedParticipants/0/address/countryName

[string, null]

Country name

The country name. For example, United States.

tender/designContest/selectedParticipants/0/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/designContest/selectedParticipants/0/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/designContest/selectedParticipants/0/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/designContest/selectedParticipants/0/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/designContest/selectedParticipants/0/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/designContest/selectedParticipants/0/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/designContest/selectedParticipants/0/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/designContest/selectedParticipants/0/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

tender/designContest/selectedParticipants/0/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

tender/designContest/selectedParticipants/0/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

tender/designContest/selectedParticipants/0/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

tender/designContest/selectedParticipants/0/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

tender/designContest/selectedParticipants/0/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

tender/designContest/hasPrizes

[boolean, null]

Has prizes

Whether prizes will be awarded in the design contest.

tender/designContest/prizes

object

Prizes

Information about the prizes awarded in the design contest.

tender/designContest/prizes/description

[string, null]

Description

The description of the prizes.

tender/designContest/rewardsDetails

[string, null]

Rewards details

The details and conditions of the payments to be made to the participants.

tender/designContest/followUpContracts

[boolean, null]

Follow-up contracts

Whether any contracts following the design contest will be awarded to the winner or winners of the design contest.

tender/designContest/bindingJuryDecision

[boolean, null]

Binding jury decision

Whether the jury’s decision is binding on the procuring entity.

tender/designContest/juryMembers

array[Jury member]

Jury members

The members of the jury.

See JuryMember

tender/designContest/juryMembers/0/name

[string, null]

Name

The name of the jury member.

tender/essentialAssets

object

Essentials assets

Information about the assets used for the provision of public services.

See EssentialAssets

tender/essentialAssets/description

[string, null]

Description

Description of the essential assets.

tender/essentialAssets/significance

[string, null]

Significance

Share of the essential assets provided in relation to the overall assets needed for the provision of the public services.

tender/essentialAssets/predominance

[string, null]

Predominance

Estimated share of assets provided compared to assets used for activities other than the public services.

tender/hasEssentialAssets

[boolean, null]

Has essential assets

Whether there is information about the assets used for the provision of public services.

tender/reviewDetails

[string, null]

Review details

Precise information concerning the time limits for the review procedures or contact information from which it can be obtained.

tender/valueCalculationMethod

[string, null]

Value calculation method

The method used for calculating the estimated value of the concession.

tender/legislativeReferences

array[Legislative reference]

Legislative references

Legislative references and associated contact points for information.

See LegislativeReference

tender/legislativeReferences/0/title

[string, null]

Title

The title of the legislative reference

tender/legislativeReferences/0/url

[string, null]

uri

URL

A link to the Web page of the legislative reference.

tender/legislativeReferences/0/informationService

object

Information service

An organization that can provide information about the legislative reference.

See OrganizationReference

tender/legislativeReferences/0/informationService/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

tender/legislativeReferences/0/informationService/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

tender/legislativeReferences/0/informationService/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/legislativeReferences/0/informationService/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/legislativeReferences/0/informationService/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/legislativeReferences/0/informationService/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/legislativeReferences/0/informationService/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/legislativeReferences/0/informationService/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/legislativeReferences/0/informationService/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/legislativeReferences/0/informationService/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/legislativeReferences/0/informationService/address/region

[string, null]

Region

The region. For example, CA.

tender/legislativeReferences/0/informationService/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/legislativeReferences/0/informationService/address/countryName

[string, null]

Country name

The country name. For example, United States.

tender/legislativeReferences/0/informationService/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/legislativeReferences/0/informationService/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/legislativeReferences/0/informationService/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/legislativeReferences/0/informationService/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/legislativeReferences/0/informationService/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/legislativeReferences/0/informationService/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/legislativeReferences/0/informationService/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/legislativeReferences/0/informationService/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

tender/legislativeReferences/0/informationService/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

tender/legislativeReferences/0/informationService/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

tender/legislativeReferences/0/informationService/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

tender/legislativeReferences/0/informationService/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

tender/legislativeReferences/0/informationService/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

tender/crossBorderLaw

[string, null]

Cross-border law

In case of joint procurement, the public procurement legislation that applies to the procedure.

tender/legalBasis

object

Legal basis

The legal basis of the procedure.

See Classification

tender/legalBasis/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/legalBasis/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/legalBasis/description

[string, null]

Description

A textual description or title for the classification code.

tender/legalBasis/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/deliveryLocations

array[Delivery Location]

Delivery Locations

The locations where activity related to this tender will take place.

See Location

tender/deliveryLocations/0/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

tender/deliveryLocations/0/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

tender/deliveryLocations/0/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

tender/deliveryLocations/0/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

tender/deliveryLocations/0/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

tender/deliveryLocations/0/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

tender/deliveryLocations/0/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

tender/deliveryLocations/0/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

tender/deliveryAddresses

array[Address]

Delivery Addresses

The addresses to which, or where, goods or services related to this tender will be delivered.

See Address

tender/deliveryAddresses/0/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/deliveryAddresses/0/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/deliveryAddresses/0/region

[string, null]

Region

The region. For example, CA.

tender/deliveryAddresses/0/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/deliveryAddresses/0/countryName

[string, null]

Country name

The country name. For example, United States.

tender/deliveryAddresses/0/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/lots

array[Lots]

Lots

A tender process can be divided into lots, where bidders can bid on one or more lots. Details of each lot can be provided here. Items, documents and other features may then reference the lot they are related to using relatedLot. Where no relatedLots identifier is given, the values ought to be interpreted as applicable to the whole tender. Details about the whole tender can be overridden for a given lot through their inclusion in the lot object.

See Lot

tender/lots/0/awardCriteria

object

Award criteria

Information about the award criteria for the lot.

See AwardCriteria

tender/lots/0/awardCriteria/weightingDescription

[string, null]

Complicated weighting description

When the weighting cannot be expressed per criterion, the mathematical equation (or other description) that expresses the complicated (e.g. non-linear) weighting.

tender/lots/0/awardCriteria/orderRationale

[string, null]

Justification for order of importance

The justification for only indicating the award criteria's order of importance, not their weighting.

tender/lots/0/awardCriteria/criteria

array[Award criterion]

Award criteria

The award criteria.

See AwardCriterion

tender/lots/0/awardCriteria/criteria/0/type

[string, null]

Type

The aspect of the bid that the criterion concerns.

tender/lots/0/awardCriteria/criteria/0/name

[string, null]

Name

The name of the criterion.

tender/lots/0/awardCriteria/criteria/0/description

[string, null]

Description

The description of the criterion.

tender/lots/0/awardCriteria/criteria/0/numbers

array[Award criterion number]

Numbers

Numbers linked to the criterion.

See AwardCriterionNumber

tender/lots/0/awardCriteria/criteria/0/numbers/0/number

[number, null]

Number

The number.

tender/lots/0/awardCriteria/criteria/0/numbers/0/weight

[string, null]

Weight

Whether the number is a type of weight.

tender/lots/0/awardCriteria/criteria/0/numbers/0/fixed

[string, null]

Fixed

Whether the number is a fixed value.

tender/lots/0/awardCriteria/criteria/0/numbers/0/threshold

[string, null]

Threshold

Whether the number is a type of threshold.

tender/lots/0/contractTerms

object

Contract terms

Information about the terms governing the future contracts for the lot.

See ContractTerms

tender/lots/0/contractTerms/hasElectronicPayment

[boolean, null]

Electronic payment used

Whether electronic payment is used.

tender/lots/0/contractTerms/hasElectronicOrdering

[boolean, null]

Electronic ordering used

Whether electronic ordering is used.

tender/lots/0/contractTerms/electronicInvoicingPolicy

[string, null]

Electronic invoicing policy

Whether the buyer will require, allow or not allow electronic invoices.

tender/lots/0/contractTerms/reservedExecution

[boolean, null]

Reserved execution

Whether the execution of the contract is restricted to the framework of sheltered employment programmes.

tender/lots/0/contractTerms/performanceTerms

[string, null]

Terms performance

The main information about the performance of the contract (e.g. intermediary deliverables, compensation for damages, intellectual property rights).

tender/lots/0/contractTerms/financialTerms

[string, null]

Financial terms

The main information about financing and payment and/or reference to any provisions that govern them.

tender/lots/0/contractTerms/tendererLegalForm

[string, null]

Tenderer legal form

A certain legal form that must be taken by a group of tenderers that is awarded a contract.

tender/lots/0/contractTerms/hasExclusiveRights

[boolean, null]

Has exclusive rights

A right entitling a public service operator to operate certain public passenger transport services on a particular route or network or in a particular area, to the exclusion of any other such operator.

tender/lots/0/contractTerms/exclusiveRights

[string, null]

Exclusive rights

The nature and extent of the exclusive rights granted by the procuring entity to the supplier.

tender/lots/0/contractTerms/operatorRevenueShare

[number, null]

Operator revenue share

The percentage of revenue from the sale of tickets allocated to the supplier.

tender/lots/0/contractTerms/otherTerms

[string, null]

Other terms

Other contract terms that do not fit the semantics of any other OCDS field.

tender/lots/0/contractTerms/rewardsAndPenalties

[string, null]

Rewards and penalties

Information about rewards and penalties relating to quality targets.

tender/lots/0/contractTerms/socialStandards

[string, null]

Social standards

The required social standards, for example: detail of the contractual rights of the staff concerned, and conditions under which employees are considered to be linked to the services.

tender/lots/0/awardPeriod

object

Award period

The period for decision making regarding the contract award for the lot. The end date should be the date on which an award decision is due to be finalized. The start date may be used to indicate the start of an evaluation period.

See Period

tender/lots/0/awardPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/awardPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/awardPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/awardPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/id

string

Required

Lot ID

A local identifier for this lot, such as a lot number. This is used in relatedLots references at the item, document and award level.

tender/lots/0/title

[string, null]

Title

A title for this lot.

tender/lots/0/description

[string, null]

Description

A description of this lot.

tender/lots/0/status

[string, null]

Lot Status

The current status of the process related to this lot.

tender/lots/0/value

object

Lot value

The maximum estimated value of this lot.

See Value

tender/lots/0/value/amount

[number, null]

Amount

Amount as a number.

tender/lots/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/lots/0/minValue

object

Minimum value

The estimated minimum value of the lot. A negative value indicates that the contracting process may involve payments from the supplier to the buyer (commonly used in concession contracts).

See Value

tender/lots/0/minValue/amount

[number, null]

Amount

Amount as a number.

tender/lots/0/minValue/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/lots/0/contractPeriod

object

Contract period

The period over which the contract is estimated or specified to be active. If the lot does not specify explicit dates, the duration field can be used.

See Period

tender/lots/0/contractPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/contractPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/contractPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/contractPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/buyer

object

Buyer

The organization aiming to conclude a contract with a supplier or to use the goods, works or services in this lot. This may be different from the procuring entity who may be specified in the tender data.

See OrganizationReference

tender/lots/0/buyer/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

tender/lots/0/buyer/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

tender/lots/0/buyer/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/lots/0/buyer/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/lots/0/buyer/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/lots/0/buyer/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/lots/0/buyer/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/lots/0/buyer/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/lots/0/buyer/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

tender/lots/0/buyer/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

tender/lots/0/buyer/address/region

[string, null]

Region

The region. For example, CA.

tender/lots/0/buyer/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

tender/lots/0/buyer/address/countryName

[string, null]

Country name

The country name. For example, United States.

tender/lots/0/buyer/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

tender/lots/0/buyer/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/lots/0/buyer/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

tender/lots/0/buyer/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

tender/lots/0/buyer/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

tender/lots/0/buyer/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

tender/lots/0/buyer/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

tender/lots/0/buyer/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

tender/lots/0/buyer/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

tender/lots/0/buyer/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

tender/lots/0/buyer/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

tender/lots/0/buyer/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

tender/lots/0/buyer/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

tender/lots/0/options

object

Options

A description of the options.

See Options

tender/lots/0/options/description

[string, null]

Description

A description of the options.

tender/lots/0/options/period

object

Period

The period over which the options can be used.

See Period

tender/lots/0/options/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/options/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/options/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/options/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/hasOptions

[boolean, null]

Options used

Whether the buyer reserves the right to make additional purchases from the supplier, as long as the contract is valid.

tender/lots/0/otherRequirements

object

Other requirements

Other requirements to participate in the lot.

See OtherRequirements

tender/lots/0/otherRequirements/requiresStaffNamesAndQualifications

[boolean, null]

Requires staff names and qualifications

Whether the bidders are obligated to indicate the names and professional qualifications of the staff assigned to performing the contract.

tender/lots/0/otherRequirements/reservedParticipation

array[string]

Reserved participation

The types of organizations to which participation is reserved.

tender/lots/0/otherRequirements/qualificationSystemConditions

array[string]

Qualification system conditions

The conditions to be fulfilled by candidates in view of their qualification for the system.

tender/lots/0/otherRequirements/qualificationSystemMethods

array[string]

Qualification system methods

The methods according to which each of the qualification system conditions will be verified.

tender/lots/0/otherRequirements/reductionCriteria

[string, null]

Reduction criteria

The criteria or rules for selecting a limited number of qualified candidates to submit bids.

tender/lots/0/recurrence

object

Recurrence

Information on the recurrence of the lot.

See Recurrence

tender/lots/0/recurrence/dates

array[Period]

Estimated dates

An estimate of the timing of subsequent initiations of contracting processes (e.g. notices of intended procurement).

See Period

tender/lots/0/recurrence/dates/0/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/recurrence/dates/0/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/recurrence/dates/0/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/recurrence/dates/0/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/recurrence/description

[string, null]

Further information

Any further information on the recurrence of the contracting process.

tender/lots/0/hasRecurrence

[boolean, null]

Has recurrence

Whether the contracting process is recurrent.

tender/lots/0/hasRenewal

[boolean, null]

Has renewal

Whether the contract related to the lot can be renewed.

tender/lots/0/renewal

object

Renewal

The options for the renewal of the contract related to the lot.

See Renewal

tender/lots/0/renewal/description

[string, null]

Description

A description of the options for the renewal of the contract.

tender/lots/0/renewal/minimumRenewals

[number, null]

Minimum renewal

The minimum number of renewals.

tender/lots/0/renewal/maximumRenewals

[number, null]

Maximum renewal

The maximum number of renewals. If there is no maximum, set to 1e9999 (which parses to infinity).

tender/lots/0/renewal/period

object

Renewal period

The period over which the contract can be renewed.

See Period

tender/lots/0/renewal/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/renewal/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/renewal/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/renewal/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/secondStage

object

Second stage

Information about the second stage of a two-stage procedure (e.g. a restricted procedure, a competitive procedure with negotiation, a competitive dialogue or an innovation partnership).

See SecondStage

tender/lots/0/secondStage/minimumCandidates

[number, null]

Minimum number of candidates

The minimum number of candidates to be invited for the second stage of the procedure. If there is an exact limit on the number of candidates, set minimumCandidates and maximumCandidates to the same number.

tender/lots/0/secondStage/maximumCandidates

[number, null]

Maximum number of candidates

The maximum number of candidates to be invited for the second stage of the procedure. If there is an exact limit on the number of candidates, set minimumCandidates and maximumCandidates to the same number.

tender/lots/0/secondStage/successiveReduction

[boolean, null]

Successive reduction

The procedure will take place in successive stages. In each stage, some participants might be eliminated.

tender/lots/0/secondStage/noNegotiationNecessary

[boolean, null]

No negotiation necessary

The buyer or procuring entity reserves the right to award the contract on the basis of the initial bids without any further negotiations.

tender/lots/0/secondStage/invitationDate

[string, null]

date-time

Invitation date

The estimated date of dispatch of the invitations to participate or to submit bids.

tender/lots/0/selectionCriteria

object

Selection criteria

Information about the conditions for participation in a lot.

See SelectionCriteria

tender/lots/0/selectionCriteria/criteria

array[Selection criterion]

Selection criteria

The selection criteria.

See SelectionCriterion

tender/lots/0/selectionCriteria/criteria/0/type

[string, null]

Type

The type of the criterion.

tender/lots/0/selectionCriteria/criteria/0/description

[string, null]

Description

The description of the criterion.

tender/lots/0/selectionCriteria/criteria/0/minimum

[string, null]

Minimum value or level

The minimum value or level of compliance a candidate needs to meet in order to participate.

tender/lots/0/selectionCriteria/criteria/0/appliesTo

array[string]

Applies to

Whether the criterion applies to suppliers, subcontractors, or both.

tender/lots/0/selectionCriteria/description

[string, null]

Description

The description of the criteria used to select the economic operators who will be allowed to bid.

tender/lots/0/submissionTerms

object

Submission terms

Information about the submission terms to describe how, when and where the tenderers need to submit their bids for the lot.

See SubmissionTerms

tender/lots/0/submissionTerms/electronicSubmissionPolicy

[string, null]

Electronic submission policy

Whether tenderers are required, allowed or not allowed to submit bids electronically.

tender/lots/0/submissionTerms/variantPolicy

[string, null]

Variant policy

Whether tenderers are required, allowed or not allowed to submit bids which fulfill the buyer's needs differently than as proposed in the procurement documents.

tender/lots/0/submissionTerms/electronicCataloguePolicy

[string, null]

Electronic catalogue policy

Whether tenderers are required, allowed or not allowed to submit bids as electronic catalogues.

tender/lots/0/submissionTerms/languages

array[string]

Submission language

One or more languages in which bids or requests to participate can be submitted, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended.

tender/lots/0/submissionTerms/bidValidityPeriod

object

Bid validity period

The period, from the bid submission deadline, for which bids must remain valid.

See Period

tender/lots/0/submissionTerms/bidValidityPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/submissionTerms/bidValidityPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/submissionTerms/bidValidityPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/submissionTerms/bidValidityPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/submissionTerms/depositsGuarantees

[string, null]

Deposits and guarantees

Information about the deposits or guarantees required from the tenderers.

tender/lots/0/techniques

object

Techniques

Information about the use of techniques, such as framework agreements, dynamic purchasing systems and electronic auctions.

See Techniques

tender/lots/0/techniques/hasFrameworkAgreement

[boolean, null]

Framework agreement involved

Whether a framework agreement is involved.

tender/lots/0/techniques/frameworkAgreement

object

Framework agreement

Information about the framework agreement.

See FrameworkAgreement

tender/lots/0/techniques/frameworkAgreement/minimumParticipants

[number, null]

Minimum number of participants

The minimum number of participants in the framework agreement.

tender/lots/0/techniques/frameworkAgreement/maximumParticipants

[number, null]

Maximum number of participants

The maximum number of participants in the framework agreement. If there is no maximum, set to 1e9999 (which parses to infinity).

tender/lots/0/techniques/frameworkAgreement/method

[string, null]

Method

Whether contracts are awarded with, without, or both with and without the reopening of competition.

tender/lots/0/techniques/frameworkAgreement/periodRationale

[string, null]

Duration rationale

The justification for exceptional cases when the duration of a framework agreement exceeds the legal limits.

tender/lots/0/techniques/frameworkAgreement/buyerCategories

[string, null]

Buyer categories

Any additional categories of buyers participating in the framework agreement and not mentioned by name (e.g. 'all hospitals in the Tuscany region').

tender/lots/0/techniques/frameworkAgreement/value

object

Value

The total upper estimated value of the framework agreement.

See Value

tender/lots/0/techniques/frameworkAgreement/value/amount

[number, null]

Amount

Amount as a number.

tender/lots/0/techniques/frameworkAgreement/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/lots/0/techniques/frameworkAgreement/period

object

Period

The period over which the framework agreement is estimated to be active.

See Period

tender/lots/0/techniques/frameworkAgreement/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/lots/0/techniques/frameworkAgreement/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/lots/0/techniques/frameworkAgreement/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/lots/0/techniques/frameworkAgreement/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/lots/0/techniques/frameworkAgreement/description

[string, null]

Description

A summary description of the framework agreement. This complements any structured information provided using the other fields.

tender/lots/0/techniques/hasDynamicPurchasingSystem

[boolean, null]

Dynamic purchasing system involved

Whether a dynamic purchasing system is involved.

tender/lots/0/techniques/dynamicPurchasingSystem

object

Dynamic purchasing system

Information about the dynamic purchasing system.

See DynamicPurchasingSystem

tender/lots/0/techniques/dynamicPurchasingSystem/type

[string, null]

Type

In the case of central purchasing bodies, whether the dynamic purchasing system can be used by buyers not listed in the contracting process.

tender/lots/0/techniques/dynamicPurchasingSystem/status

[string, null]

Status

The status of the dynamic purchasing system.

tender/lots/0/techniques/hasElectronicAuction

[boolean, null]

Electronic auction used

Whether an electronic auction is used.

tender/lots/0/techniques/electronicAuction

object

Electronic auction

Information about the electronic auction.

See ElectronicAuction

tender/lots/0/techniques/electronicAuction/url

[string, null]

URL

The internet address of the electronic auction.

tender/lots/0/techniques/electronicAuction/description

[string, null]

Description

Any additional information about the electronic auction.

tender/lotDetails

object

Lot Details

Details of any criteria that apply to bidding on the lots in this tender.

tender/lotDetails/maximumLotsBidPerSupplier

[integer, null]

Maximum lots per supplier

The maximum number of lots that one supplier can bid on as part of this contracting process.

tender/lotDetails/maximumLotsAwardedPerSupplier

[integer, null]

Maximum lots per supplier

The maximum number of lots that can be awarded to one supplier as part of this contracting process.

tender/lotDetails/awardCriteriaDetails

[string, null]

Award criteria details

Any detailed or further information on the award or selection criteria.

tender/lotGroups

array[Lot group]

Lot groups

Where the buyer reserves the right to combine lots, or wishes to specify the total value for a group of lots, a lot group is used to capture this information.

See LotGroup

tender/lotGroups/0/id

string

Required

Lot group identifier

A local identifier for this group of lots.

tender/lotGroups/0/relatedLots

array[[string]]

Related lot(s)

A list of the identifiers of the lots that form this group. Lots can appear in more than one group.

tender/lotGroups/0/optionToCombine

[boolean, null]

Option to combine

The buyer reserves the right to combine the lots in this group when awarding a contract.

tender/lotGroups/0/maximumValue

object

Maximum value

The maximum estimated value of the lots in this group. This can be lower than the sum total of lot values

See Value

tender/lotGroups/0/maximumValue/amount

[number, null]

Amount

Amount as a number.

tender/lotGroups/0/maximumValue/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/targets

array[Metric]

Targets

Any target metrics for this results of this contracting process.

See Metric

tender/targets/0/id

[string]

Required

Identifier

An identifier for this metric. In some cases this may be drawn from a codelist of metrics required for this type of contracting process, or in other instances may be an arbitrary identifier.

tender/targets/0/title

[string, null]

Title

The title of this metric

tender/targets/0/description

[string, null]

Description

A short description of the metric. This may include short details of measurement methods.

tender/targets/0/observations

array[Observation]

Observations

An array of target or actual values for this metric.

See Observation

tender/targets/0/observations/0/id

string

Required

Identifier

A local identifier for this specific observation. This may be an arbitrary identifier, or could be a composite of the metric identifier, and the date and other dimensions of this observation.

tender/targets/0/observations/0/period

object

Period

The period over which this observation is measured.

See Period

tender/targets/0/observations/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/targets/0/observations/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/targets/0/observations/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/targets/0/observations/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/targets/0/observations/0/value

object

Value

For financial metrics, the value of this forecast, target or actual observation.

See Value

tender/targets/0/observations/0/value/amount

[number, null]

Amount

Amount as a number.

tender/targets/0/observations/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/targets/0/observations/0/measure

[string, number, null]

Measure

For non-financial metrics, the measure of this forecast, target or actual observation. Measures may be provided as free text or numerical values.

tender/targets/0/observations/0/unit

object

Unit

Unit

tender/targets/0/observations/0/unit/name

[string, null]

Unit name

The name of the unit.

tender/targets/0/observations/0/unit/scheme

[string, null]

Scheme

The list from which units of measure identifiers are taken. Use of the scheme 'UNCEFACT' for the UN/CEFACT Recommendation 20 list of "Codes for Units of Measure Used in International Trade" is recommended.

tender/targets/0/observations/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. For example, with UNCEFACT, this is the value of the 'Common Code' column. From this identifier, applications can look-up the human readable name or symbol for this unit of measure.

tender/targets/0/observations/0/unit/uri

[string, null]

uri

URI

If the scheme used provide a machine-readable URI for this unit of measure, this can be given.

tender/targets/0/observations/0/dimensions

object

Dimensions

Any number of dimensions can be recorded within this object. Dimensions names should follow the camelCase conventions of OCDS.

tender/targets/0/observations/0/notes

[string, null]

Notes

Any notes on this observation. This may include clarifying information.

tender/targets/0/observations/0/relatedImplementationMilestone

object

Related implementation milestone

A link to the milestone in the implementation section of OCDS to which this forecast, target or actual observation relates.

See MilestoneReference

tender/targets/0/observations/0/relatedImplementationMilestone/id

string

Required

Milestone ID

The ID of the milestone being referenced, this must match the ID of a milestone described elsewhere in a release about this contracting process.

tender/targets/0/observations/0/relatedImplementationMilestone/title

[string, null]

Milestone title

The title of the milestone being referenced, this must match the title of a milestone described elsewhere in a release about this contracting process.

tender/options

object

Options

A description of the options.

See Options

tender/options/description

[string, null]

Description

A description of the options.

tender/options/period

object

Period

The period over which the options can be used.

See Period

tender/options/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/options/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/options/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/options/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/hasOptions

[boolean, null]

Options used

Whether or not the buyer reserves the right to make additional purchases from the supplier, as long as the contract is valid.

tender/otherRequirements

object

Other requirements

Other requirements to participate in the procedure.

See OtherRequirements

tender/otherRequirements/requiresStaffNamesAndQualifications

[boolean, null]

Requires staff names and qualifications

Whether the bidders are obligated to indicate the names and professional qualifications of the staff assigned to performing the contract.

tender/otherRequirements/reservedParticipation

array[string]

Reserved participation

The types of organizations to which participation is reserved.

tender/otherRequirements/qualificationSystemConditions

array[string]

Qualification system conditions

The conditions to be fulfilled by candidates in view of their qualification for the system.

tender/otherRequirements/qualificationSystemMethods

array[string]

Qualification system methods

The methods according to which each of the qualification system conditions will be verified.

tender/otherRequirements/reductionCriteria

[string, null]

Reduction criteria

The criteria or rules for selecting a limited number of qualified candidates to submit bids.

tender/participationFees

array[Participation fee]

Participation fees

Any fees applicable to bidders wishing to participate in the tender process. Fees can apply for accessing bidding documents or for submitting bids, or there can be a "win fee" payable by the successful bidder.

See ParticipationFee

tender/participationFees/0/id

string

Required

Fee ID

A local identifier for this fee, unique within this block. This field is used to keep track of multiple revisions of a fee through the compilation from release to record mechanism.

tender/participationFees/0/type

array[string]

Fee type

The type of this fee.

tender/participationFees/0/value

object

Value

The monetary value of this fee.

See Value

tender/participationFees/0/value/amount

[number, null]

Amount

Amount as a number.

tender/participationFees/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/participationFees/0/description

[string, null]

Description

Additional information about this fee, for example: the specific cases in which the fee is applicable (e.g. hard copies of documents only), the way in which the fee is levied, or the exact nature of the fee.

tender/participationFees/0/methodOfPayment

array[string]

Method(s) of payment

The accepted ways in which fees can be paid.

tender/procedure

object

Procedure

Information about the procurement procedure.

See Procedure

tender/procedure/isAccelerated

[boolean, null]

Accelerated procedure used

Whether the time limit for receipt of bids or requests to participate can be reduced due to a state of urgency.

tender/procedure/acceleratedRationale

[string, null]

Accelerated procedure rationale

The justification for using an accelerated procedure.

tender/procedure/features

[string, null]

Features

The main features of the procedure (e.g. description of the individual stages) and information about where the full rules for the procedure can be found.

tender/procurementMethodRationaleClassifications

array[Classification]

Procurement method rationale classifications

The classifications of the procurement method rationale.

See Classification

tender/procurementMethodRationaleClassifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/procurementMethodRationaleClassifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/procurementMethodRationaleClassifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/procurementMethodRationaleClassifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/recurrence

object

Recurrence

Information on the recurrence of the contracting process.

See Recurrence

tender/recurrence/dates

array[Period]

Estimated dates

An estimate of the timing of subsequent initiations of contracting processes (e.g. notices of intended procurement).

See Period

tender/recurrence/dates/0/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/recurrence/dates/0/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/recurrence/dates/0/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/recurrence/dates/0/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/recurrence/description

[string, null]

Further information

Any further information on the recurrence of the contracting process.

tender/hasRecurrence

[boolean, null]

Has recurrence

Whether the contracting process is recurrent.

tender/hasRenewal

[boolean, null]

Has renewal

Whether the contracts can be renewed.

tender/renewal

object

Renewal

The options for the renewal of the contracts.

See Renewal

tender/renewal/description

[string, null]

Description

A description of the options for the renewal of the contract.

tender/renewal/minimumRenewals

[number, null]

Minimum renewal

The minimum number of renewals.

tender/renewal/maximumRenewals

[number, null]

Maximum renewal

The maximum number of renewals. If there is no maximum, set to 1e9999 (which parses to infinity).

tender/renewal/period

object

Renewal period

The period over which the contract can be renewed.

See Period

tender/renewal/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/renewal/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/renewal/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/renewal/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/secondStage

object

Second stage

Information about the second stage of a two-stage procedure (e.g. a restricted procedure, a competitive procedure with negotiation, a competitive dialogue or an innovation partnership).

See SecondStage

tender/secondStage/minimumCandidates

[number, null]

Minimum number of candidates

The minimum number of candidates to be invited for the second stage of the procedure. If there is an exact limit on the number of candidates, set minimumCandidates and maximumCandidates to the same number.

tender/secondStage/maximumCandidates

[number, null]

Maximum number of candidates

The maximum number of candidates to be invited for the second stage of the procedure. If there is an exact limit on the number of candidates, set minimumCandidates and maximumCandidates to the same number.

tender/secondStage/successiveReduction

[boolean, null]

Successive reduction

The procedure will take place in successive stages. In each stage, some participants might be eliminated.

tender/secondStage/noNegotiationNecessary

[boolean, null]

No negotiation necessary

The buyer or procuring entity reserves the right to award the contract on the basis of the initial bids without any further negotiations.

tender/secondStage/invitationDate

[string, null]

date-time

Invitation date

The estimated date of dispatch of the invitations to participate or to submit bids.

tender/selectionCriteria

object

Selection criteria

Information about the conditions for participation in a procedure.

See SelectionCriteria

tender/selectionCriteria/criteria

array[Selection criterion]

Selection criteria

The selection criteria.

See SelectionCriterion

tender/selectionCriteria/criteria/0/type

[string, null]

Type

The type of the criterion.

tender/selectionCriteria/criteria/0/description

[string, null]

Description

The description of the criterion.

tender/selectionCriteria/criteria/0/minimum

[string, null]

Minimum value or level

The minimum value or level of compliance a candidate needs to meet in order to participate.

tender/selectionCriteria/criteria/0/appliesTo

array[string]

Applies to

Whether the criterion applies to suppliers, subcontractors, or both.

tender/selectionCriteria/description

[string, null]

Description

The description of the criteria used to select the economic operators who will be allowed to bid.

tender/mainProcurementCategoryDetails

[string, null]

Main Procurement Category Details

The local name of the Main Procurement Category

tender/statusDetails

[string, null]

Status Details

Additional detail on the status of the tender. This field can be used to provide the local name of the status.

tender/subcontractingTerms

object

Subcontracting terms

Information about the terms governing subcontracting.

See SubcontractingTerms

tender/subcontractingTerms/description

[string, null]

Description

A description of the terms governing subcontracting.

tender/submissionTerms

object

Submission terms

Information about the submission terms to describe how, when and where the tenderers need to submit their bids for the procedure.

See SubmissionTerms

tender/submissionTerms/electronicSubmissionPolicy

[string, null]

Electronic submission policy

Whether tenderers are required, allowed or not allowed to submit bids electronically.

tender/submissionTerms/variantPolicy

[string, null]

Variant policy

Whether tenderers are required, allowed or not allowed to submit bids which fulfill the buyer's needs differently than as proposed in the procurement documents.

tender/submissionTerms/electronicCataloguePolicy

[string, null]

Electronic catalogue policy

Whether tenderers are required, allowed or not allowed to submit bids as electronic catalogues.

tender/submissionTerms/languages

array[string]

Submission language

One or more languages in which bids or requests to participate can be submitted, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended.

tender/submissionTerms/bidValidityPeriod

object

Bid validity period

The period, from the bid submission deadline, for which bids must remain valid.

See Period

tender/submissionTerms/bidValidityPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/submissionTerms/bidValidityPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/submissionTerms/bidValidityPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/submissionTerms/bidValidityPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/submissionTerms/depositsGuarantees

[string, null]

Deposits and guarantees

Information about the deposits or guarantees required from the tenderers.

tender/techniques

object

Techniques

Information about the use of techniques, such as framework agreements, dynamic purchasing systems and electronic auctions.

See Techniques

tender/techniques/hasFrameworkAgreement

[boolean, null]

Framework agreement involved

Whether a framework agreement is involved.

tender/techniques/frameworkAgreement

object

Framework agreement

Information about the framework agreement.

See FrameworkAgreement

tender/techniques/frameworkAgreement/minimumParticipants

[number, null]

Minimum number of participants

The minimum number of participants in the framework agreement.

tender/techniques/frameworkAgreement/maximumParticipants

[number, null]

Maximum number of participants

The maximum number of participants in the framework agreement. If there is no maximum, set to 1e9999 (which parses to infinity).

tender/techniques/frameworkAgreement/method

[string, null]

Method

Whether contracts are awarded with, without, or both with and without the reopening of competition.

tender/techniques/frameworkAgreement/periodRationale

[string, null]

Duration rationale

The justification for exceptional cases when the duration of a framework agreement exceeds the legal limits.

tender/techniques/frameworkAgreement/buyerCategories

[string, null]

Buyer categories

Any additional categories of buyers participating in the framework agreement and not mentioned by name (e.g. 'all hospitals in the Tuscany region').

tender/techniques/frameworkAgreement/value

object

Value

The total upper estimated value of the framework agreement.

See Value

tender/techniques/frameworkAgreement/value/amount

[number, null]

Amount

Amount as a number.

tender/techniques/frameworkAgreement/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

tender/techniques/frameworkAgreement/period

object

Period

The period over which the framework agreement is estimated to be active.

See Period

tender/techniques/frameworkAgreement/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

tender/techniques/frameworkAgreement/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

tender/techniques/frameworkAgreement/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

tender/techniques/frameworkAgreement/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

tender/techniques/frameworkAgreement/description

[string, null]

Description

A summary description of the framework agreement. This complements any structured information provided using the other fields.

tender/techniques/hasDynamicPurchasingSystem

[boolean, null]

Dynamic purchasing system involved

Whether a dynamic purchasing system is involved.

tender/techniques/dynamicPurchasingSystem

object

Dynamic purchasing system

Information about the dynamic purchasing system.

See DynamicPurchasingSystem

tender/techniques/dynamicPurchasingSystem/type

[string, null]

Type

In the case of central purchasing bodies, whether the dynamic purchasing system can be used by buyers not listed in the contracting process.

tender/techniques/dynamicPurchasingSystem/status

[string, null]

Status

The status of the dynamic purchasing system.

tender/techniques/hasElectronicAuction

[boolean, null]

Electronic auction used

Whether an electronic auction is used.

tender/techniques/electronicAuction

object

Electronic auction

Information about the electronic auction.

See ElectronicAuction

tender/techniques/electronicAuction/url

[string, null]

URL

The internet address of the electronic auction.

tender/techniques/electronicAuction/description

[string, null]

Description

Any additional information about the electronic auction.

tender/classification

object

Tender classification

The primary classification of the contracting process.

See Classification

tender/classification/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/classification/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/classification/description

[string, null]

Description

A textual description or title for the classification code.

tender/classification/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

tender/additionalClassifications

array[Classification]

Tender additional classifications

Additional classifications of the contracting process.

See Classification

tender/additionalClassifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

tender/additionalClassifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

tender/additionalClassifications/0/description

[string, null]

Description

A textual description or title for the classification code.

tender/additionalClassifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards

array[Award]

Awards

Information from the award phase of the contracting process. There can be more than one award per contracting process e.g. because the contract is split among different providers, or because it is a standing offer.

See Award

awards/0/id

[string, integer]

Required

Award ID

The identifier for this award. It must be unique and must not change within the Open Contracting Process it is part of (defined by a single ocid). See the identifier guidance for further details.

awards/0/title

[string, null]

Title

Award title

awards/0/description

[string, null]

Description

Award description

awards/0/status

[string, null]

Award status

The current status of the award, from the closed awardStatus codelist.

awards/0/date

[string, null]

date-time

Award date

The date of the contract award. This is usually the date on which a decision to award was made.

awards/0/value

object

Value

The total value of this award. In the case of a framework contract this may be the total estimated lifetime value, or maximum value, of the agreement. There may be more than one award per procurement. A negative value indicates that the award may involve payments from the supplier to the buyer (commonly used in concession contracts).

See Value

awards/0/value/amount

[number, null]

Amount

Amount as a number.

awards/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

awards/0/suppliers

array[Organization reference]

Suppliers

The suppliers awarded this award. If different suppliers have been awarded different items or values, these should be split into separate award blocks.

See OrganizationReference

awards/0/suppliers/0/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

awards/0/suppliers/0/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

awards/0/suppliers/0/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

awards/0/suppliers/0/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

awards/0/suppliers/0/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

awards/0/suppliers/0/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

awards/0/suppliers/0/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

awards/0/suppliers/0/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

awards/0/suppliers/0/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

awards/0/suppliers/0/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

awards/0/suppliers/0/address/region

[string, null]

Region

The region. For example, CA.

awards/0/suppliers/0/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

awards/0/suppliers/0/address/countryName

[string, null]

Country name

The country name. For example, United States.

awards/0/suppliers/0/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

awards/0/suppliers/0/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

awards/0/suppliers/0/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

awards/0/suppliers/0/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

awards/0/suppliers/0/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

awards/0/suppliers/0/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

awards/0/suppliers/0/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

awards/0/suppliers/0/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

awards/0/suppliers/0/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

awards/0/suppliers/0/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

awards/0/suppliers/0/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

awards/0/suppliers/0/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

awards/0/suppliers/0/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

awards/0/items

array[Item]

Items awarded

The goods and services awarded in this award, broken into line items wherever possible. Items should not be duplicated, but the quantity specified instead.

See Item

awards/0/items/0/id

[string, integer]

Required

ID

A local identifier to reference and merge the items by. Must be unique within a given array of items.

awards/0/items/0/description

[string, null]

Description

A description of the goods, services to be provided.

awards/0/items/0/classification

object

Classification

The primary classification for the item.

See Classification

awards/0/items/0/classification/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

awards/0/items/0/classification/id

[string, integer, null]

ID

The classification code taken from the scheme.

awards/0/items/0/classification/description

[string, null]

Description

A textual description or title for the classification code.

awards/0/items/0/classification/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards/0/items/0/additionalClassifications

array[Classification]

Additional classifications

An array of additional classifications for the item.

See Classification

awards/0/items/0/additionalClassifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

awards/0/items/0/additionalClassifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

awards/0/items/0/additionalClassifications/0/description

[string, null]

Description

A textual description or title for the classification code.

awards/0/items/0/additionalClassifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards/0/items/0/quantity

[number, null]

Quantity

The number of units to be provided.

awards/0/items/0/unit

object

Unit

A description of the unit in which the supplies, services or works are provided (e.g. hours, kilograms) and the unit-price.

awards/0/items/0/unit/scheme

[string, null]

Scheme

The list from which identifiers for units of measure are taken, using the open unitClassificationScheme codelist. 'UNCEFACT' is recommended.

awards/0/items/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. Check the unitClassificationScheme codelist for details of how to find and use identifiers from the scheme in use.

awards/0/items/0/unit/name

[string, null]

Name

Name of the unit.

awards/0/items/0/unit/value

object

Value

The monetary value of a single unit.

See Value

awards/0/items/0/unit/value/amount

[number, null]

Amount

Amount as a number.

awards/0/items/0/unit/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

awards/0/items/0/unit/uri

[string, null]

uri

URI

The machine-readable URI for the unit of measure, provided by the scheme.

awards/0/items/0/deliveryAddresses

array[Address]

Delivery Addresses

The addresses to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

awards/0/items/0/deliveryAddresses/0/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

awards/0/items/0/deliveryAddresses/0/locality

[string, null]

Locality

The locality. For example, Mountain View.

awards/0/items/0/deliveryAddresses/0/region

[string, null]

Region

The region. For example, CA.

awards/0/items/0/deliveryAddresses/0/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

awards/0/items/0/deliveryAddresses/0/countryName

[string, null]

Country name

The country name. For example, United States.

awards/0/items/0/deliveryAddresses/0/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

awards/0/items/0/deliveryLocations

array[Delivery Location]

Delivery Locations

The locations where activity related to this tender, contract or license will be delivered

See Location

awards/0/items/0/deliveryLocations/0/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

awards/0/items/0/deliveryLocations/0/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

awards/0/items/0/deliveryLocations/0/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

awards/0/items/0/deliveryLocations/0/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

awards/0/items/0/deliveryLocations/0/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

awards/0/items/0/deliveryLocations/0/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

awards/0/items/0/deliveryLocations/0/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

awards/0/items/0/deliveryLocations/0/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

awards/0/items/0/deliveryLocation

object

Delivery Location

The location where activity related to this tender, contract or license will be delivered, or will take place.

See Location

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryLocations` to support items with multiple delivery locations.

awards/0/items/0/deliveryLocation/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

awards/0/items/0/deliveryLocation/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

awards/0/items/0/deliveryLocation/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

awards/0/items/0/deliveryLocation/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

awards/0/items/0/deliveryLocation/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

awards/0/items/0/deliveryLocation/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

awards/0/items/0/deliveryLocation/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

awards/0/items/0/deliveryLocation/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

awards/0/items/0/deliveryAddress

object

Delivery Address

The address to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryAddresses` to support items with multiple delivery locations.

awards/0/items/0/deliveryAddress/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

awards/0/items/0/deliveryAddress/locality

[string, null]

Locality

The locality. For example, Mountain View.

awards/0/items/0/deliveryAddress/region

[string, null]

Region

The region. For example, CA.

awards/0/items/0/deliveryAddress/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

awards/0/items/0/deliveryAddress/countryName

[string, null]

Country name

The country name. For example, United States.

awards/0/items/0/deliveryAddress/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

awards/0/items/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this item relates.

awards/0/contractPeriod

object

Contract period

The period for which the contract has been awarded.

See Period

awards/0/contractPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

awards/0/contractPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

awards/0/contractPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

awards/0/contractPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

awards/0/documents

array[Document]

Documents

All documents and attachments related to the award, including any notices.

See Document

awards/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

awards/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

awards/0/documents/0/title

[string, null]

Title

The document title.

awards/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

awards/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

awards/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

awards/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

awards/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

awards/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

awards/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

awards/0/amendments

array[Amendment]

Amendments

An award amendment is a formal change to the details of the award, and generally involves the publication of a new award notice/release. The rationale and a description of the changes made can be provided here.

See Amendment

awards/0/amendments/0/date

[string, null]

date-time

Amendment date

The date of this amendment.

awards/0/amendments/0/rationale

[string, null]

Rationale

An explanation for the amendment.

awards/0/amendments/0/id

[string, null]

ID

An identifier for this amendment: often the amendment number

awards/0/amendments/0/description

[string, null]

Description

A free text, or semi-structured, description of the changes made in this amendment.

awards/0/amendments/0/amendsReleaseID

[string, null]

Amended release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process before the amendment was made.

awards/0/amendments/0/releaseID

[string, null]

Amending release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process after the amendment was made.

awards/0/amendments/0/changes

array[object]

Amended fields

An array of change objects describing the fields changed, and their former values. (Deprecated in 1.1)

This property was deprecated in version 1.1

A free-text or semi-structured string describing the changes made in each amendment can be provided in the amendment.description field. To provide structured information on the fields that have changed, publishers should provide releases indicating the state of the contracting process before and after the amendment.

awards/0/amendments/0/changes/0/property

string

Property

The property name that has been changed relative to the place the amendment is. For example if the contract value has changed, then the property under changes within the contract.amendment would be value.amount. (Deprecated in 1.1)

awards/0/amendments/0/unstructuredChanges

array[Unstructured change]

Unstructured changes

Unstructured or semi-structured changes to an earlier notice.

See UnstructuredChange

awards/0/amendments/0/unstructuredChanges/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this change relates, if any.

awards/0/amendments/0/unstructuredChanges/0/oldValue

object

Old value

The value of the data element referenced by the where field, before the change.

See UnstructuredChangeValue

awards/0/amendments/0/unstructuredChanges/0/oldValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

awards/0/amendments/0/unstructuredChanges/0/oldValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

awards/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

awards/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

awards/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

awards/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards/0/amendments/0/unstructuredChanges/0/oldValue/date

[string, null]

Date

A date.

awards/0/amendments/0/unstructuredChanges/0/newValue

object

New value

The value of the data element referenced by the where field, after the change.

See UnstructuredChangeValue

awards/0/amendments/0/unstructuredChanges/0/newValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

awards/0/amendments/0/unstructuredChanges/0/newValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

awards/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

awards/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

awards/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

awards/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards/0/amendments/0/unstructuredChanges/0/newValue/date

[string, null]

Date

A date.

awards/0/amendments/0/unstructuredChanges/0/where

object

Where

A reference to a data element on an earlier notice that is being changed.

awards/0/amendments/0/unstructuredChanges/0/where/section

[string, null]

Section

The identifier of the section containing the data element, if the earlier notice is organized into sections.

awards/0/amendments/0/unstructuredChanges/0/where/label

[string, null]

Label

The label for the data element.

awards/0/amendment

object

Amendment

The use of individual amendment objects has been deprecated. From OCDS 1.1 information should be provided in the amendments array.

See Amendment

This property was deprecated in version 1.1

The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.

awards/0/amendment/date

[string, null]

date-time

Amendment date

The date of this amendment.

awards/0/amendment/rationale

[string, null]

Rationale

An explanation for the amendment.

awards/0/amendment/id

[string, null]

ID

An identifier for this amendment: often the amendment number

awards/0/amendment/description

[string, null]

Description

A free text, or semi-structured, description of the changes made in this amendment.

awards/0/amendment/amendsReleaseID

[string, null]

Amended release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process before the amendment was made.

awards/0/amendment/releaseID

[string, null]

Amending release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process after the amendment was made.

awards/0/amendment/changes

array[object]

Amended fields

An array of change objects describing the fields changed, and their former values. (Deprecated in 1.1)

This property was deprecated in version 1.1

A free-text or semi-structured string describing the changes made in each amendment can be provided in the amendment.description field. To provide structured information on the fields that have changed, publishers should provide releases indicating the state of the contracting process before and after the amendment.

awards/0/amendment/changes/0/property

string

Property

The property name that has been changed relative to the place the amendment is. For example if the contract value has changed, then the property under changes within the contract.amendment would be value.amount. (Deprecated in 1.1)

awards/0/amendment/unstructuredChanges

array[Unstructured change]

Unstructured changes

Unstructured or semi-structured changes to an earlier notice.

See UnstructuredChange

awards/0/amendment/unstructuredChanges/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this change relates, if any.

awards/0/amendment/unstructuredChanges/0/oldValue

object

Old value

The value of the data element referenced by the where field, before the change.

See UnstructuredChangeValue

awards/0/amendment/unstructuredChanges/0/oldValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

awards/0/amendment/unstructuredChanges/0/oldValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

awards/0/amendment/unstructuredChanges/0/oldValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

awards/0/amendment/unstructuredChanges/0/oldValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

awards/0/amendment/unstructuredChanges/0/oldValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

awards/0/amendment/unstructuredChanges/0/oldValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards/0/amendment/unstructuredChanges/0/oldValue/date

[string, null]

Date

A date.

awards/0/amendment/unstructuredChanges/0/newValue

object

New value

The value of the data element referenced by the where field, after the change.

See UnstructuredChangeValue

awards/0/amendment/unstructuredChanges/0/newValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

awards/0/amendment/unstructuredChanges/0/newValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

awards/0/amendment/unstructuredChanges/0/newValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

awards/0/amendment/unstructuredChanges/0/newValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

awards/0/amendment/unstructuredChanges/0/newValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

awards/0/amendment/unstructuredChanges/0/newValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

awards/0/amendment/unstructuredChanges/0/newValue/date

[string, null]

Date

A date.

awards/0/amendment/unstructuredChanges/0/where

object

Where

A reference to a data element on an earlier notice that is being changed.

awards/0/amendment/unstructuredChanges/0/where/section

[string, null]

Section

The identifier of the section containing the data element, if the earlier notice is organized into sections.

awards/0/amendment/unstructuredChanges/0/where/label

[string, null]

Label

The label for the data element.

awards/0/relatedBid

[string, null]

Related bid

Where bid details are used, a cross reference to the entry in the bids array to which this award relates. Provide the bid identifier here.

This property was deprecated in version 1.2

This field is deprecated in favor of `relatedBids`, to allow an award to combine multiple bids.

awards/0/relatedBids

array[string]

Related bids

Where bid details are used, a cross reference to the entries in the bids array to which this award relates. Provide the bid identifiers here.

awards/0/valueCalculationMethod

[string, null]

Value calculation method

Any details relevant to the value of the concession according to article 8(3) of Directive 2014/23/EU on concession contracts.

awards/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this award relates.

awards/0/agreedMetrics

array[Metric]

Agreed metrics

Any target metrics set out as part of the contract award.

See Metric

awards/0/agreedMetrics/0/id

[string]

Required

Identifier

An identifier for this metric. In some cases this may be drawn from a codelist of metrics required for this type of contracting process, or in other instances may be an arbitrary identifier.

awards/0/agreedMetrics/0/title

[string, null]

Title

The title of this metric

awards/0/agreedMetrics/0/description

[string, null]

Description

A short description of the metric. This may include short details of measurement methods.

awards/0/agreedMetrics/0/observations

array[Observation]

Observations

An array of target or actual values for this metric.

See Observation

awards/0/agreedMetrics/0/observations/0/id

string

Required

Identifier

A local identifier for this specific observation. This may be an arbitrary identifier, or could be a composite of the metric identifier, and the date and other dimensions of this observation.

awards/0/agreedMetrics/0/observations/0/period

object

Period

The period over which this observation is measured.

See Period

awards/0/agreedMetrics/0/observations/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

awards/0/agreedMetrics/0/observations/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

awards/0/agreedMetrics/0/observations/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

awards/0/agreedMetrics/0/observations/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

awards/0/agreedMetrics/0/observations/0/value

object

Value

For financial metrics, the value of this forecast, target or actual observation.

See Value

awards/0/agreedMetrics/0/observations/0/value/amount

[number, null]

Amount

Amount as a number.

awards/0/agreedMetrics/0/observations/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

awards/0/agreedMetrics/0/observations/0/measure

[string, number, null]

Measure

For non-financial metrics, the measure of this forecast, target or actual observation. Measures may be provided as free text or numerical values.

awards/0/agreedMetrics/0/observations/0/unit

object

Unit

Unit

awards/0/agreedMetrics/0/observations/0/unit/name

[string, null]

Unit name

The name of the unit.

awards/0/agreedMetrics/0/observations/0/unit/scheme

[string, null]

Scheme

The list from which units of measure identifiers are taken. Use of the scheme 'UNCEFACT' for the UN/CEFACT Recommendation 20 list of "Codes for Units of Measure Used in International Trade" is recommended.

awards/0/agreedMetrics/0/observations/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. For example, with UNCEFACT, this is the value of the 'Common Code' column. From this identifier, applications can look-up the human readable name or symbol for this unit of measure.

awards/0/agreedMetrics/0/observations/0/unit/uri

[string, null]

uri

URI

If the scheme used provide a machine-readable URI for this unit of measure, this can be given.

awards/0/agreedMetrics/0/observations/0/dimensions

object

Dimensions

Any number of dimensions can be recorded within this object. Dimensions names should follow the camelCase conventions of OCDS.

awards/0/agreedMetrics/0/observations/0/notes

[string, null]

Notes

Any notes on this observation. This may include clarifying information.

awards/0/agreedMetrics/0/observations/0/relatedImplementationMilestone

object

Related implementation milestone

A link to the milestone in the implementation section of OCDS to which this forecast, target or actual observation relates.

See MilestoneReference

awards/0/agreedMetrics/0/observations/0/relatedImplementationMilestone/id

string

Required

Milestone ID

The ID of the milestone being referenced, this must match the ID of a milestone described elsewhere in a release about this contracting process.

awards/0/agreedMetrics/0/observations/0/relatedImplementationMilestone/title

[string, null]

Milestone title

The title of the milestone being referenced, this must match the title of a milestone described elsewhere in a release about this contracting process.

awards/0/statusDetails

[string, null]

Status Details

Additional detail on the status of the award. This field can be used to provide the local name of the status.

awards/0/hasSubcontracting

[boolean, null]

Subcontracting involved

Whether a part of the contract will be subcontracted.

awards/0/subcontracting

object

Subcontracting

Information about the parts of the contract that the supplier will subcontract to third parties.

See Subcontracting

awards/0/subcontracting/description

[string, null]

Description

The description of the part of the contract that the supplier will subcontract to third parties.

awards/0/subcontracting/maximumPercentage

[number, null]

Maximum percentage of contract value

The maximum percentage of the contract value that will be subcontracted.

awards/0/subcontracting/minimumPercentage

[number, null]

Minimum percentage of contract value

The minimum percentage of the contract value that will be subcontracted.

awards/0/subcontracting/competitiveMaximumPercentage

[number, null]

Maximum percentage of contract value for competitive subcontracting

The maximum percentage of the contract value that the procuring entity requires the supplier to subcontract to third parties through a competitive procedure.

awards/0/subcontracting/competitiveMinimumPercentage

[number, null]

Minimum percentage of contract value for competitive subcontracting

The minimum percentage of the contract value that the procuring entity requires the supplier to subcontract to third parties through a competitive procedure.

awards/0/subcontracting/value

object

Subcontracted value

The estimated value of the part of the contract that the supplier will subcontract to third parties.

See Value

awards/0/subcontracting/value/amount

[number, null]

Amount

Amount as a number.

awards/0/subcontracting/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

awards/0/subcontracting/competitive

[boolean, null]

Competitive subcontracting

Whether the supplier will subcontract part of the contract to third parties through a competitive procedure.

contracts

array[Contract]

Contracts

Information from the contract creation phase of the procurement process.

See Contract

contracts/0/id

[string, integer]

Required

Contract ID

The identifier for this contract. It must be unique and must not change within the Open Contracting Process it is part of (defined by a single ocid). See the identifier guidance for further details.

contracts/0/awardID

[string, integer]

Required

Award ID

The award.id against which this contract is being issued.

contracts/0/title

[string, null]

Contract title

Contract title

contracts/0/description

[string, null]

Contract description

Contract description

contracts/0/status

[string, null]

Contract status

The current status of the contract, from the closed contractStatus codelist.

contracts/0/period

object

Period

The start and end date for the contract.

See Period

contracts/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

contracts/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

contracts/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

contracts/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

contracts/0/value

object

Value

The total value of this contract. A negative value indicates that the contract will involve payments from the supplier to the buyer (commonly used in concession contracts).

See Value

contracts/0/value/amount

[number, null]

Amount

Amount as a number.

contracts/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/items

array[Item]

Items contracted

The goods, services, and any intangible outcomes in this contract. Note: If the items are the same as the award do not repeat.

See Item

contracts/0/items/0/id

[string, integer]

Required

ID

A local identifier to reference and merge the items by. Must be unique within a given array of items.

contracts/0/items/0/description

[string, null]

Description

A description of the goods, services to be provided.

contracts/0/items/0/classification

object

Classification

The primary classification for the item.

See Classification

contracts/0/items/0/classification/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

contracts/0/items/0/classification/id

[string, integer, null]

ID

The classification code taken from the scheme.

contracts/0/items/0/classification/description

[string, null]

Description

A textual description or title for the classification code.

contracts/0/items/0/classification/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

contracts/0/items/0/additionalClassifications

array[Classification]

Additional classifications

An array of additional classifications for the item.

See Classification

contracts/0/items/0/additionalClassifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

contracts/0/items/0/additionalClassifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

contracts/0/items/0/additionalClassifications/0/description

[string, null]

Description

A textual description or title for the classification code.

contracts/0/items/0/additionalClassifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

contracts/0/items/0/quantity

[number, null]

Quantity

The number of units to be provided.

contracts/0/items/0/unit

object

Unit

A description of the unit in which the supplies, services or works are provided (e.g. hours, kilograms) and the unit-price.

contracts/0/items/0/unit/scheme

[string, null]

Scheme

The list from which identifiers for units of measure are taken, using the open unitClassificationScheme codelist. 'UNCEFACT' is recommended.

contracts/0/items/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. Check the unitClassificationScheme codelist for details of how to find and use identifiers from the scheme in use.

contracts/0/items/0/unit/name

[string, null]

Name

Name of the unit.

contracts/0/items/0/unit/value

object

Value

The monetary value of a single unit.

See Value

contracts/0/items/0/unit/value/amount

[number, null]

Amount

Amount as a number.

contracts/0/items/0/unit/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/items/0/unit/uri

[string, null]

uri

URI

The machine-readable URI for the unit of measure, provided by the scheme.

contracts/0/items/0/deliveryAddresses

array[Address]

Delivery Addresses

The addresses to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

contracts/0/items/0/deliveryAddresses/0/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

contracts/0/items/0/deliveryAddresses/0/locality

[string, null]

Locality

The locality. For example, Mountain View.

contracts/0/items/0/deliveryAddresses/0/region

[string, null]

Region

The region. For example, CA.

contracts/0/items/0/deliveryAddresses/0/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

contracts/0/items/0/deliveryAddresses/0/countryName

[string, null]

Country name

The country name. For example, United States.

contracts/0/items/0/deliveryAddresses/0/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

contracts/0/items/0/deliveryLocations

array[Delivery Location]

Delivery Locations

The locations where activity related to this tender, contract or license will be delivered

See Location

contracts/0/items/0/deliveryLocations/0/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

contracts/0/items/0/deliveryLocations/0/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

contracts/0/items/0/deliveryLocations/0/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

contracts/0/items/0/deliveryLocations/0/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

contracts/0/items/0/deliveryLocations/0/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

contracts/0/items/0/deliveryLocations/0/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

contracts/0/items/0/deliveryLocations/0/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

contracts/0/items/0/deliveryLocations/0/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

contracts/0/items/0/deliveryLocation

object

Delivery Location

The location where activity related to this tender, contract or license will be delivered, or will take place.

See Location

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryLocations` to support items with multiple delivery locations.

contracts/0/items/0/deliveryLocation/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

contracts/0/items/0/deliveryLocation/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

contracts/0/items/0/deliveryLocation/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

contracts/0/items/0/deliveryLocation/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

contracts/0/items/0/deliveryLocation/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

contracts/0/items/0/deliveryLocation/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

contracts/0/items/0/deliveryLocation/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

contracts/0/items/0/deliveryLocation/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

contracts/0/items/0/deliveryAddress

object

Delivery Address

The address to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryAddresses` to support items with multiple delivery locations.

contracts/0/items/0/deliveryAddress/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

contracts/0/items/0/deliveryAddress/locality

[string, null]

Locality

The locality. For example, Mountain View.

contracts/0/items/0/deliveryAddress/region

[string, null]

Region

The region. For example, CA.

contracts/0/items/0/deliveryAddress/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

contracts/0/items/0/deliveryAddress/countryName

[string, null]

Country name

The country name. For example, United States.

contracts/0/items/0/deliveryAddress/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

contracts/0/items/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this item relates.

contracts/0/dateSigned

[string, null]

date-time

Date signed

The date the contract was signed. In the case of multiple signatures, the date of the last signature.

contracts/0/documents

array[Document]

Documents

All documents and attachments related to the contract, including any notices.

See Document

contracts/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

contracts/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

contracts/0/documents/0/title

[string, null]

Title

The document title.

contracts/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

contracts/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

contracts/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

contracts/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

contracts/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

contracts/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

contracts/0/implementation

object

Implementation

Information related to the implementation of the contract in accordance with the obligations laid out therein.

See Implementation

contracts/0/implementation/transactions

array[Transaction information]

Transactions

A list of the spending transactions made against this contract

See Transaction

contracts/0/implementation/transactions/0/id

[string, integer]

Required

ID

A unique identifier for this transaction. This identifier should be possible to cross-reference against the provided data source. For IATI this is the transaction reference.

contracts/0/implementation/transactions/0/source

[string, null]

uri

Data source

Used to point either to a corresponding Fiscal Data Package, IATI file, or machine or human-readable source where users can find further information on the budget line item identifiers, or project identifiers, provided here.

contracts/0/implementation/transactions/0/date

[string, null]

date-time

Date

The date of the transaction

contracts/0/implementation/transactions/0/value

object

Value

The value of the transaction.

See Value

contracts/0/implementation/transactions/0/value/amount

[number, null]

Amount

Amount as a number.

contracts/0/implementation/transactions/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/implementation/transactions/0/payer

object

Payer

An organization reference for the organization from which the funds in this transaction originate.

See OrganizationReference

contracts/0/implementation/transactions/0/payer/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

contracts/0/implementation/transactions/0/payer/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

contracts/0/implementation/transactions/0/payer/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payer/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/implementation/transactions/0/payer/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/implementation/transactions/0/payer/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/implementation/transactions/0/payer/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/implementation/transactions/0/payer/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payer/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

contracts/0/implementation/transactions/0/payer/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

contracts/0/implementation/transactions/0/payer/address/region

[string, null]

Region

The region. For example, CA.

contracts/0/implementation/transactions/0/payer/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

contracts/0/implementation/transactions/0/payer/address/countryName

[string, null]

Country name

The country name. For example, United States.

contracts/0/implementation/transactions/0/payer/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

contracts/0/implementation/transactions/0/payer/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payer/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/implementation/transactions/0/payer/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/implementation/transactions/0/payer/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/implementation/transactions/0/payer/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/implementation/transactions/0/payer/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payer/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

contracts/0/implementation/transactions/0/payer/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

contracts/0/implementation/transactions/0/payer/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

contracts/0/implementation/transactions/0/payer/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

contracts/0/implementation/transactions/0/payer/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

contracts/0/implementation/transactions/0/payer/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/implementation/transactions/0/payee

object

Payee

An organization reference for the organization which receives the funds in this transaction.

See OrganizationReference

contracts/0/implementation/transactions/0/payee/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

contracts/0/implementation/transactions/0/payee/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

contracts/0/implementation/transactions/0/payee/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payee/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/implementation/transactions/0/payee/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/implementation/transactions/0/payee/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/implementation/transactions/0/payee/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/implementation/transactions/0/payee/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payee/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

contracts/0/implementation/transactions/0/payee/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

contracts/0/implementation/transactions/0/payee/address/region

[string, null]

Region

The region. For example, CA.

contracts/0/implementation/transactions/0/payee/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

contracts/0/implementation/transactions/0/payee/address/countryName

[string, null]

Country name

The country name. For example, United States.

contracts/0/implementation/transactions/0/payee/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

contracts/0/implementation/transactions/0/payee/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payee/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/implementation/transactions/0/payee/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/implementation/transactions/0/payee/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/implementation/transactions/0/payee/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/implementation/transactions/0/payee/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/implementation/transactions/0/payee/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

contracts/0/implementation/transactions/0/payee/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

contracts/0/implementation/transactions/0/payee/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

contracts/0/implementation/transactions/0/payee/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

contracts/0/implementation/transactions/0/payee/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

contracts/0/implementation/transactions/0/payee/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/implementation/transactions/0/uri

[string, null]

uri

Linked spending information

A URI pointing directly to a machine-readable record about this spending transaction.

contracts/0/implementation/transactions/0/amount

object

Amount

(Deprecated in 1.1. Use transaction.value instead) The value of the transaction. A negative value indicates a refund or correction.

See Value

This property was deprecated in version 1.1

This field has been replaced by the `transaction.value` field for consistency with the use of value and amount elsewhere in the standard.

contracts/0/implementation/transactions/0/amount/amount

[number, null]

Amount

Amount as a number.

contracts/0/implementation/transactions/0/amount/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/implementation/transactions/0/providerOrganization

object

Provider organization

(Deprecated in 1.1. Use transaction.payer instead.) The Organization Identifier for the organization from which the funds in this transaction originate. Expressed following the Organizational Identifier standard - consult the documentation and the codelist.

See Identifier

This property was deprecated in version 1.1

This field has been replaced by the `transaction.payer` field to resolve ambiguity arising from 'provider' being interpreted as relating to the goods or services procured rather than the flow of funds between the parties.

contracts/0/implementation/transactions/0/providerOrganization/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/implementation/transactions/0/providerOrganization/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/implementation/transactions/0/providerOrganization/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/implementation/transactions/0/providerOrganization/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/implementation/transactions/0/receiverOrganization

object

Receiver organization

(Deprecated in 1.1. Use transaction.payee instead). The Organization Identifier for the organization which receives the funds in this transaction. Expressed following the Organizational Identifier standard - consult the documentation and the codelist.

See Identifier

This property was deprecated in version 1.1

This field has been replaced by the `transaction.payee` field to resolve ambiguity arising from 'receiver' being interpreted as relating to the goods or services procured rather than the flow of funds between the parties.

contracts/0/implementation/transactions/0/receiverOrganization/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/implementation/transactions/0/receiverOrganization/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/implementation/transactions/0/receiverOrganization/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/implementation/transactions/0/receiverOrganization/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/implementation/milestones

array[Milestone]

Milestones

As milestones are completed, the milestone's status and dates should be updated.

See Milestone

contracts/0/implementation/milestones/0/id

[string, integer]

Required

ID

A local identifier for this milestone, unique within this block. This field is used to keep track of multiple revisions of a milestone through the compilation from release to record mechanism.

contracts/0/implementation/milestones/0/title

[string, null]

Title

Milestone title

contracts/0/implementation/milestones/0/type

[string, null]

Milestone type

The nature of the milestone, using the open milestoneType codelist.

contracts/0/implementation/milestones/0/description

[string, null]

Description

A description of the milestone.

contracts/0/implementation/milestones/0/code

[string, null]

Milestone code

Milestone codes can be used to track specific events that take place for a particular kind of contracting process. For example, a code of 'approvalLetter' can be used to allow applications to understand this milestone represents the date an approvalLetter is due or signed.

contracts/0/implementation/milestones/0/dueDate

[string, null]

date-time

Due date

The date the milestone is due.

contracts/0/implementation/milestones/0/dateMet

[string, null]

date-time

Date met

The date on which the milestone was met.

contracts/0/implementation/milestones/0/dateModified

[string, null]

date-time

Date modified

The date the milestone was last reviewed or modified and the status was altered or confirmed to still be correct.

contracts/0/implementation/milestones/0/status

[string, null]

Status

The status that was realized on the date provided in dateModified, from the closed milestoneStatus codelist.

contracts/0/implementation/milestones/0/documents

array[Document]

Documents

List of documents associated with this milestone (Deprecated in 1.1).

See Document

This property was deprecated in version 1.1

Inclusion of documents at the milestone level is now deprecated. Documentation should be attached in the tender, award, contract or implementation sections, and titles and descriptions used to highlight the related milestone. Publishers who wish to continue to provide documents at the milestone level should explicitly declare this by using the milestone documents extension.

contracts/0/implementation/milestones/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

contracts/0/implementation/milestones/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

contracts/0/implementation/milestones/0/documents/0/title

[string, null]

Title

The document title.

contracts/0/implementation/milestones/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

contracts/0/implementation/milestones/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

contracts/0/implementation/milestones/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

contracts/0/implementation/milestones/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

contracts/0/implementation/milestones/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

contracts/0/implementation/milestones/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/implementation/milestones/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

contracts/0/implementation/milestones/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this milestone relates.

contracts/0/implementation/documents

array[Document]

Documents

Documents and reports that are part of the implementation phase e.g. audit and evaluation reports.

See Document

contracts/0/implementation/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

contracts/0/implementation/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

contracts/0/implementation/documents/0/title

[string, null]

Title

The document title.

contracts/0/implementation/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

contracts/0/implementation/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

contracts/0/implementation/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

contracts/0/implementation/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

contracts/0/implementation/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

contracts/0/implementation/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/implementation/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

contracts/0/implementation/charges

array[Charge]

Charges

Information on the revenue to be raised through charges, as set out in the contract or as subsequently revised during the life of the project.

See Charge

contracts/0/implementation/charges/0/id

string

Required

Charge identifier

A local identifier for this specific charge. This field is used to keep track of revisions of a charge across multiple OCDS releases.

contracts/0/implementation/charges/0/title

[string, null]

Charge title

A descriptive title for this charge.

contracts/0/implementation/charges/0/paidBy

[string, null]

Paid by

Is this a user charge (paid by businesses or citizens using the facilities provided by the contract), or a charge paid by the government?

contracts/0/implementation/charges/0/period

object

Period

The period to which this charge applies.

See Period

contracts/0/implementation/charges/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

contracts/0/implementation/charges/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

contracts/0/implementation/charges/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

contracts/0/implementation/charges/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

contracts/0/implementation/charges/0/estimatedValue

object

Estimated value

What is the estimated total value to be raised from this charge during this period.

See Value

contracts/0/implementation/charges/0/estimatedValue/amount

[number, null]

Amount

Amount as a number.

contracts/0/implementation/charges/0/estimatedValue/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/implementation/charges/0/actualValue

object

Actual value

In the implementation section, this field may be updated with the total revenue raised from this charge during this period.

See Value

contracts/0/implementation/charges/0/actualValue/amount

[number, null]

Amount

Amount as a number.

contracts/0/implementation/charges/0/actualValue/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/implementation/charges/0/notes

[string, null]

Notes

Any notes on this charge. This may include clarifying information.

contracts/0/implementation/metrics

array[Metric]

Metrics

Reported results from the delivery of the contracted goods, works or services.

See Metric

contracts/0/implementation/metrics/0/id

[string]

Required

Identifier

An identifier for this metric. In some cases this may be drawn from a codelist of metrics required for this type of contracting process, or in other instances may be an arbitrary identifier.

contracts/0/implementation/metrics/0/title

[string, null]

Title

The title of this metric

contracts/0/implementation/metrics/0/description

[string, null]

Description

A short description of the metric. This may include short details of measurement methods.

contracts/0/implementation/metrics/0/observations

array[Observation]

Observations

An array of target or actual values for this metric.

See Observation

contracts/0/implementation/metrics/0/observations/0/id

string

Required

Identifier

A local identifier for this specific observation. This may be an arbitrary identifier, or could be a composite of the metric identifier, and the date and other dimensions of this observation.

contracts/0/implementation/metrics/0/observations/0/period

object

Period

The period over which this observation is measured.

See Period

contracts/0/implementation/metrics/0/observations/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

contracts/0/implementation/metrics/0/observations/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

contracts/0/implementation/metrics/0/observations/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

contracts/0/implementation/metrics/0/observations/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

contracts/0/implementation/metrics/0/observations/0/value

object

Value

For financial metrics, the value of this forecast, target or actual observation.

See Value

contracts/0/implementation/metrics/0/observations/0/value/amount

[number, null]

Amount

Amount as a number.

contracts/0/implementation/metrics/0/observations/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/implementation/metrics/0/observations/0/measure

[string, number, null]

Measure

For non-financial metrics, the measure of this forecast, target or actual observation. Measures may be provided as free text or numerical values.

contracts/0/implementation/metrics/0/observations/0/unit

object

Unit

Unit

contracts/0/implementation/metrics/0/observations/0/unit/name

[string, null]

Unit name

The name of the unit.

contracts/0/implementation/metrics/0/observations/0/unit/scheme

[string, null]

Scheme

The list from which units of measure identifiers are taken. Use of the scheme 'UNCEFACT' for the UN/CEFACT Recommendation 20 list of "Codes for Units of Measure Used in International Trade" is recommended.

contracts/0/implementation/metrics/0/observations/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. For example, with UNCEFACT, this is the value of the 'Common Code' column. From this identifier, applications can look-up the human readable name or symbol for this unit of measure.

contracts/0/implementation/metrics/0/observations/0/unit/uri

[string, null]

uri

URI

If the scheme used provide a machine-readable URI for this unit of measure, this can be given.

contracts/0/implementation/metrics/0/observations/0/dimensions

object

Dimensions

Any number of dimensions can be recorded within this object. Dimensions names should follow the camelCase conventions of OCDS.

contracts/0/implementation/metrics/0/observations/0/notes

[string, null]

Notes

Any notes on this observation. This may include clarifying information.

contracts/0/implementation/metrics/0/observations/0/relatedImplementationMilestone

object

Related implementation milestone

A link to the milestone in the implementation section of OCDS to which this forecast, target or actual observation relates.

See MilestoneReference

contracts/0/implementation/metrics/0/observations/0/relatedImplementationMilestone/id

string

Required

Milestone ID

The ID of the milestone being referenced, this must match the ID of a milestone described elsewhere in a release about this contracting process.

contracts/0/implementation/metrics/0/observations/0/relatedImplementationMilestone/title

[string, null]

Milestone title

The title of the milestone being referenced, this must match the title of a milestone described elsewhere in a release about this contracting process.

contracts/0/relatedProcesses

array[Related Process]

Related processes

The details of related processes: for example, if this process is followed by one or more contracting processes, represented under a separate open contracting identifier (ocid). This is commonly used to refer to subcontracts and to renewal or replacement processes for this contract.

See RelatedProcess

contracts/0/relatedProcesses/0/id

string

Relationship ID

A local identifier for this relationship, unique within this array.

contracts/0/relatedProcesses/0/relationship

array[string]

Relationship

The type of relationship, using the open relatedProcess codelist.

contracts/0/relatedProcesses/0/title

[string, null]

Related process title

The title of the related process, where referencing an open contracting process, this field should match the tender/title field in the related process.

contracts/0/relatedProcesses/0/scheme

[string, null]

Scheme

The identification scheme used by this cross-reference, using the open relatedProcessScheme codelist.

contracts/0/relatedProcesses/0/identifier

[string, null]

Identifier

The identifier of the related process. If the scheme is 'ocid', this must be an Open Contracting ID (ocid).

contracts/0/relatedProcesses/0/uri

[string, null]

uri

Related process URI

A URI pointing to a machine-readable document, release or record package containing the identified related process.

contracts/0/milestones

array[Milestone]

Contract milestones

A list of milestones associated with the finalization of this contract.

See Milestone

contracts/0/milestones/0/id

[string, integer]

Required

ID

A local identifier for this milestone, unique within this block. This field is used to keep track of multiple revisions of a milestone through the compilation from release to record mechanism.

contracts/0/milestones/0/title

[string, null]

Title

Milestone title

contracts/0/milestones/0/type

[string, null]

Milestone type

The nature of the milestone, using the open milestoneType codelist.

contracts/0/milestones/0/description

[string, null]

Description

A description of the milestone.

contracts/0/milestones/0/code

[string, null]

Milestone code

Milestone codes can be used to track specific events that take place for a particular kind of contracting process. For example, a code of 'approvalLetter' can be used to allow applications to understand this milestone represents the date an approvalLetter is due or signed.

contracts/0/milestones/0/dueDate

[string, null]

date-time

Due date

The date the milestone is due.

contracts/0/milestones/0/dateMet

[string, null]

date-time

Date met

The date on which the milestone was met.

contracts/0/milestones/0/dateModified

[string, null]

date-time

Date modified

The date the milestone was last reviewed or modified and the status was altered or confirmed to still be correct.

contracts/0/milestones/0/status

[string, null]

Status

The status that was realized on the date provided in dateModified, from the closed milestoneStatus codelist.

contracts/0/milestones/0/documents

array[Document]

Documents

List of documents associated with this milestone (Deprecated in 1.1).

See Document

This property was deprecated in version 1.1

Inclusion of documents at the milestone level is now deprecated. Documentation should be attached in the tender, award, contract or implementation sections, and titles and descriptions used to highlight the related milestone. Publishers who wish to continue to provide documents at the milestone level should explicitly declare this by using the milestone documents extension.

contracts/0/milestones/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

contracts/0/milestones/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

contracts/0/milestones/0/documents/0/title

[string, null]

Title

The document title.

contracts/0/milestones/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

contracts/0/milestones/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

contracts/0/milestones/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

contracts/0/milestones/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

contracts/0/milestones/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

contracts/0/milestones/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/milestones/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

contracts/0/milestones/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this milestone relates.

contracts/0/amendments

array[Amendment]

Amendments

A contract amendment is a formal change to, or extension of, a contract, and generally involves the publication of a new contract notice/release, or some other documents detailing the change. The rationale and a description of the changes made can be provided here.

See Amendment

contracts/0/amendments/0/date

[string, null]

date-time

Amendment date

The date of this amendment.

contracts/0/amendments/0/rationale

[string, null]

Rationale

An explanation for the amendment.

contracts/0/amendments/0/id

[string, null]

ID

An identifier for this amendment: often the amendment number

contracts/0/amendments/0/description

[string, null]

Description

A free text, or semi-structured, description of the changes made in this amendment.

contracts/0/amendments/0/amendsReleaseID

[string, null]

Amended release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process before the amendment was made.

contracts/0/amendments/0/releaseID

[string, null]

Amending release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process after the amendment was made.

contracts/0/amendments/0/changes

array[object]

Amended fields

An array of change objects describing the fields changed, and their former values. (Deprecated in 1.1)

This property was deprecated in version 1.1

A free-text or semi-structured string describing the changes made in each amendment can be provided in the amendment.description field. To provide structured information on the fields that have changed, publishers should provide releases indicating the state of the contracting process before and after the amendment.

contracts/0/amendments/0/changes/0/property

string

Property

The property name that has been changed relative to the place the amendment is. For example if the contract value has changed, then the property under changes within the contract.amendment would be value.amount. (Deprecated in 1.1)

contracts/0/amendments/0/unstructuredChanges

array[Unstructured change]

Unstructured changes

Unstructured or semi-structured changes to an earlier notice.

See UnstructuredChange

contracts/0/amendments/0/unstructuredChanges/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this change relates, if any.

contracts/0/amendments/0/unstructuredChanges/0/oldValue

object

Old value

The value of the data element referenced by the where field, before the change.

See UnstructuredChangeValue

contracts/0/amendments/0/unstructuredChanges/0/oldValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

contracts/0/amendments/0/unstructuredChanges/0/oldValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

contracts/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

contracts/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

contracts/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

contracts/0/amendments/0/unstructuredChanges/0/oldValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

contracts/0/amendments/0/unstructuredChanges/0/oldValue/date

[string, null]

Date

A date.

contracts/0/amendments/0/unstructuredChanges/0/newValue

object

New value

The value of the data element referenced by the where field, after the change.

See UnstructuredChangeValue

contracts/0/amendments/0/unstructuredChanges/0/newValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

contracts/0/amendments/0/unstructuredChanges/0/newValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

contracts/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

contracts/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

contracts/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

contracts/0/amendments/0/unstructuredChanges/0/newValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

contracts/0/amendments/0/unstructuredChanges/0/newValue/date

[string, null]

Date

A date.

contracts/0/amendments/0/unstructuredChanges/0/where

object

Where

A reference to a data element on an earlier notice that is being changed.

contracts/0/amendments/0/unstructuredChanges/0/where/section

[string, null]

Section

The identifier of the section containing the data element, if the earlier notice is organized into sections.

contracts/0/amendments/0/unstructuredChanges/0/where/label

[string, null]

Label

The label for the data element.

contracts/0/amendment

object

Amendment

The use of individual amendment objects has been deprecated. From OCDS 1.1 information should be provided in the amendments array.

See Amendment

This property was deprecated in version 1.1

The single amendment object has been deprecated in favour of including amendments in an amendments (plural) array.

contracts/0/amendment/date

[string, null]

date-time

Amendment date

The date of this amendment.

contracts/0/amendment/rationale

[string, null]

Rationale

An explanation for the amendment.

contracts/0/amendment/id

[string, null]

ID

An identifier for this amendment: often the amendment number

contracts/0/amendment/description

[string, null]

Description

A free text, or semi-structured, description of the changes made in this amendment.

contracts/0/amendment/amendsReleaseID

[string, null]

Amended release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process before the amendment was made.

contracts/0/amendment/releaseID

[string, null]

Amending release (identifier)

Provide the identifier (release.id) of the OCDS release (from this contracting process) that provides the values for this contracting process after the amendment was made.

contracts/0/amendment/changes

array[object]

Amended fields

An array of change objects describing the fields changed, and their former values. (Deprecated in 1.1)

This property was deprecated in version 1.1

A free-text or semi-structured string describing the changes made in each amendment can be provided in the amendment.description field. To provide structured information on the fields that have changed, publishers should provide releases indicating the state of the contracting process before and after the amendment.

contracts/0/amendment/changes/0/property

string

Property

The property name that has been changed relative to the place the amendment is. For example if the contract value has changed, then the property under changes within the contract.amendment would be value.amount. (Deprecated in 1.1)

contracts/0/amendment/unstructuredChanges

array[Unstructured change]

Unstructured changes

Unstructured or semi-structured changes to an earlier notice.

See UnstructuredChange

contracts/0/amendment/unstructuredChanges/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this change relates, if any.

contracts/0/amendment/unstructuredChanges/0/oldValue

object

Old value

The value of the data element referenced by the where field, before the change.

See UnstructuredChangeValue

contracts/0/amendment/unstructuredChanges/0/oldValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

contracts/0/amendment/unstructuredChanges/0/oldValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

contracts/0/amendment/unstructuredChanges/0/oldValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

contracts/0/amendment/unstructuredChanges/0/oldValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

contracts/0/amendment/unstructuredChanges/0/oldValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

contracts/0/amendment/unstructuredChanges/0/oldValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

contracts/0/amendment/unstructuredChanges/0/oldValue/date

[string, null]

Date

A date.

contracts/0/amendment/unstructuredChanges/0/newValue

object

New value

The value of the data element referenced by the where field, after the change.

See UnstructuredChangeValue

contracts/0/amendment/unstructuredChanges/0/newValue/text

[string, null]

Text value

A text. If the change deleted or erased the data element, use the empty string ("").

contracts/0/amendment/unstructuredChanges/0/newValue/classifications

array[Classification]

Classifications

A list of classifications.

See Classification

contracts/0/amendment/unstructuredChanges/0/newValue/classifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

contracts/0/amendment/unstructuredChanges/0/newValue/classifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

contracts/0/amendment/unstructuredChanges/0/newValue/classifications/0/description

[string, null]

Description

A textual description or title for the classification code.

contracts/0/amendment/unstructuredChanges/0/newValue/classifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

contracts/0/amendment/unstructuredChanges/0/newValue/date

[string, null]

Date

A date.

contracts/0/amendment/unstructuredChanges/0/where

object

Where

A reference to a data element on an earlier notice that is being changed.

contracts/0/amendment/unstructuredChanges/0/where/section

[string, null]

Section

The identifier of the section containing the data element, if the earlier notice is organized into sections.

contracts/0/amendment/unstructuredChanges/0/where/label

[string, null]

Label

The label for the data element.

contracts/0/periodRationale

[string, null]

Contract period rationale

The rationale for the duration of the contract.

contracts/0/publicPassengerTransportServicesKilometers

[number, null]

Kilometers of public passenger transport services

The number of kilometers of public passenger transport services provided by a public service contract.

contracts/0/finance

array[Financing arrangements]

Finance

An array with details of each source of finance arranged for this contract.

See Finance

contracts/0/finance/0/id

string

Required

ID

An identifier for this financing arrangement.

contracts/0/finance/0/title

[string, null]

Title

A short title for this financing arrangement.

contracts/0/finance/0/description

[string, null]

Description

A short description of this financing arrangement. This may include details of lender rights, step in arrangements, exchange rate guarantees, and for syndicated loans, details of syndication and any banks who are known parties to the loan.

contracts/0/finance/0/financingParty

object

Financing party

The party providing this financing arrangement.

See OrganizationReference

contracts/0/finance/0/financingParty/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

contracts/0/finance/0/financingParty/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

contracts/0/finance/0/financingParty/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/finance/0/financingParty/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/finance/0/financingParty/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/finance/0/financingParty/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/finance/0/financingParty/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/finance/0/financingParty/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/finance/0/financingParty/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

contracts/0/finance/0/financingParty/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

contracts/0/finance/0/financingParty/address/region

[string, null]

Region

The region. For example, CA.

contracts/0/finance/0/financingParty/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

contracts/0/finance/0/financingParty/address/countryName

[string, null]

Country name

The country name. For example, United States.

contracts/0/finance/0/financingParty/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

contracts/0/finance/0/financingParty/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/finance/0/financingParty/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

contracts/0/finance/0/financingParty/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

contracts/0/finance/0/financingParty/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

contracts/0/finance/0/financingParty/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

contracts/0/finance/0/financingParty/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

contracts/0/finance/0/financingParty/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

contracts/0/finance/0/financingParty/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

contracts/0/finance/0/financingParty/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

contracts/0/finance/0/financingParty/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

contracts/0/finance/0/financingParty/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

contracts/0/finance/0/financingParty/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

contracts/0/finance/0/financeType

[string, null]

Finance type

The type of finance arranged.

contracts/0/finance/0/financeCategory

[string, null]

Finance category

The nature of the finance. This information can be used when determining the order of preference for investors to get their money back in cases of liquidation.

contracts/0/finance/0/value

object

Value

The total value of this finance.

See Value

contracts/0/finance/0/value/amount

[number, null]

Amount

Amount as a number.

contracts/0/finance/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/finance/0/period

object

Finance period

What period is covered by this finance.

See Period

contracts/0/finance/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

contracts/0/finance/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

contracts/0/finance/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

contracts/0/finance/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

contracts/0/finance/0/interestRate

object

Interest rate

The interest rate associated with this finance.

contracts/0/finance/0/interestRate/base

[string, number, null]

Base

The variable to which an additional margin amount is added to get the Interest amount. This can be specified as a fixed number, as a known variable (e.g. LIBOR or LIBOR+1%), or can be omitted if margin specifies the entire interest rate.

contracts/0/finance/0/interestRate/margin

[number, null]

Margin

The variable added to the base to give the Interest amount expressed as a decimal fraction (e.g. 12.5% = 0.125).

contracts/0/finance/0/interestRate/fixed

[boolean, null]

Fixed rate

A boolean field. If this interest rate of fixed, set to true. Otherwise, set to false.

contracts/0/finance/0/interestRate/notes

[string, null]

Notes

Any explanatory notes concerning the interest rate.

contracts/0/finance/0/repaymentFrequency

[number, null]

Repayment frequency (days)

What is the average repayment frequency (in days) for this source of finance. For example, for yearly, use 365; for monthly repayment use 30.4; for daily use 1. User interfaces may wish to translate this into a more user-friendly presentation, such as 'daily','monthly' or 'yearly'.

contracts/0/finance/0/stepInRights

[boolean, null]

Step in rights

Does provision of this finance confer any step in rights on the financing party? Step in rights are the lender's option to assume certain contractual responsibilities of a project party through managing their contract in cases when that party is not meeting its obligations under such a contract. This is a true/false field to indicate when step in rights exist. If there are step in rights, details should be provided in the description field, and in additional contract documents.

contracts/0/finance/0/exchangeRateGuarantee

[boolean, null]

Exchange rate guarantees

Is there an associated exchange rate guarantee with this source of finance. This is a true/false field to indicate when exchange rate guarantees exist. Details of any guarantees can be provided in the finance description, or in associated documents.

contracts/0/finance/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this financing arrangement relates.

contracts/0/agreedMetrics

array[Metric]

Agreed metrics

Any target metrics set out as part of the contract documents.

See Metric

contracts/0/agreedMetrics/0/id

[string]

Required

Identifier

An identifier for this metric. In some cases this may be drawn from a codelist of metrics required for this type of contracting process, or in other instances may be an arbitrary identifier.

contracts/0/agreedMetrics/0/title

[string, null]

Title

The title of this metric

contracts/0/agreedMetrics/0/description

[string, null]

Description

A short description of the metric. This may include short details of measurement methods.

contracts/0/agreedMetrics/0/observations

array[Observation]

Observations

An array of target or actual values for this metric.

See Observation

contracts/0/agreedMetrics/0/observations/0/id

string

Required

Identifier

A local identifier for this specific observation. This may be an arbitrary identifier, or could be a composite of the metric identifier, and the date and other dimensions of this observation.

contracts/0/agreedMetrics/0/observations/0/period

object

Period

The period over which this observation is measured.

See Period

contracts/0/agreedMetrics/0/observations/0/period/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

contracts/0/agreedMetrics/0/observations/0/period/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

contracts/0/agreedMetrics/0/observations/0/period/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

contracts/0/agreedMetrics/0/observations/0/period/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

contracts/0/agreedMetrics/0/observations/0/value

object

Value

For financial metrics, the value of this forecast, target or actual observation.

See Value

contracts/0/agreedMetrics/0/observations/0/value/amount

[number, null]

Amount

Amount as a number.

contracts/0/agreedMetrics/0/observations/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

contracts/0/agreedMetrics/0/observations/0/measure

[string, number, null]

Measure

For non-financial metrics, the measure of this forecast, target or actual observation. Measures may be provided as free text or numerical values.

contracts/0/agreedMetrics/0/observations/0/unit

object

Unit

Unit

contracts/0/agreedMetrics/0/observations/0/unit/name

[string, null]

Unit name

The name of the unit.

contracts/0/agreedMetrics/0/observations/0/unit/scheme

[string, null]

Scheme

The list from which units of measure identifiers are taken. Use of the scheme 'UNCEFACT' for the UN/CEFACT Recommendation 20 list of "Codes for Units of Measure Used in International Trade" is recommended.

contracts/0/agreedMetrics/0/observations/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. For example, with UNCEFACT, this is the value of the 'Common Code' column. From this identifier, applications can look-up the human readable name or symbol for this unit of measure.

contracts/0/agreedMetrics/0/observations/0/unit/uri

[string, null]

uri

URI

If the scheme used provide a machine-readable URI for this unit of measure, this can be given.

contracts/0/agreedMetrics/0/observations/0/dimensions

object

Dimensions

Any number of dimensions can be recorded within this object. Dimensions names should follow the camelCase conventions of OCDS.

contracts/0/agreedMetrics/0/observations/0/notes

[string, null]

Notes

Any notes on this observation. This may include clarifying information.

contracts/0/agreedMetrics/0/observations/0/relatedImplementationMilestone

object

Related implementation milestone

A link to the milestone in the implementation section of OCDS to which this forecast, target or actual observation relates.

See MilestoneReference

contracts/0/agreedMetrics/0/observations/0/relatedImplementationMilestone/id

string

Required

Milestone ID

The ID of the milestone being referenced, this must match the ID of a milestone described elsewhere in a release about this contracting process.

contracts/0/agreedMetrics/0/observations/0/relatedImplementationMilestone/title

[string, null]

Milestone title

The title of the milestone being referenced, this must match the title of a milestone described elsewhere in a release about this contracting process.

contracts/0/statusDetails

[string, null]

Status Details

Additional detail on the status of the contract. This field can be used to provide the local name of the status

language

[string, null]

Release language

The default language of the data using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended.

relatedProcesses

array[Related Process]

Related processes

The details of related processes: for example, if this process follows on from one or more other processes, represented under a separate open contracting identifier (ocid). This is commonly used to relate mini-competitions to their parent frameworks or individual tenders to a broader planning process.

See RelatedProcess

relatedProcesses/0/id

string

Relationship ID

A local identifier for this relationship, unique within this array.

relatedProcesses/0/relationship

array[string]

Relationship

The type of relationship, using the open relatedProcess codelist.

relatedProcesses/0/title

[string, null]

Related process title

The title of the related process, where referencing an open contracting process, this field should match the tender/title field in the related process.

relatedProcesses/0/scheme

[string, null]

Scheme

The identification scheme used by this cross-reference, using the open relatedProcessScheme codelist.

relatedProcesses/0/identifier

[string, null]

Identifier

The identifier of the related process. If the scheme is 'ocid', this must be an Open Contracting ID (ocid).

relatedProcesses/0/uri

[string, null]

uri

Related process URI

A URI pointing to a machine-readable document, release or record package containing the identified related process.

bids

object

Bids

The bid section is used to publish summary statistics, and where applicable, individual bid information.

See Bids

bids/statistics

array[Bid Statistic]

Statistics

Summary statistics on the number and nature of bids received. Where information is provided on individual bids, these statistics should match those that can be calculated from the bid details array.

See BidsStatistic

bids/statistics/0/id

string

Required

ID

An internal identifier for this statistic.

bids/statistics/0/measure

string

Required

Measure

The statistic reported in the value.

bids/statistics/0/date

[string, null]

date-time

Date

The date when this 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.

bids/statistics/0/value

number

Required

Value

The value for the measure in question. Total counts should be provided as an integer. Percentages should be provided as a proportion of 1 (e.g. 10% = 0.1)

bids/statistics/0/valueGross

[number, null]

Gross value

The monetary value for the measure in question, including all taxes.

bids/statistics/0/currency

[string, null]

Currency

The currency of the amount in the value field, if the statistic has a monetary value.

bids/statistics/0/notes

[string, null]

Notes

Any notes needed to understand or interpret the given statistic.

bids/statistics/0/relatedLot

[string, null]

Related Lot

Where lots are in use, if this statistic relates to bids on a particular lot, provide the lot identifier here. If left blank, the statistic will be interpreted as applying to the whole tender.

bids/details

array[Bid]

Bid details

An array of bids, providing information on the bidders, and where applicable, bid status, bid values and related documents. The extent to which this information can be disclosed varies from jurisdiction to jurisdiction.

See Bid

bids/details/0/id

[string]

Required

ID

A local identifier for this bid

bids/details/0/date

[string, null]

date-time

Date

The date when this bid was received.

bids/details/0/description

[string, null]

Description

A description of this bid. The description field may be used to describe the terms and conditions for the bid.

bids/details/0/status

[string, null]

Status

The status of the bid.

bids/details/0/items

array[Item]

Items offered by the tenderer(s)

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.

See Item

bids/details/0/items/0/id

[string, integer]

Required

ID

A local identifier to reference and merge the items by. Must be unique within a given array of items.

bids/details/0/items/0/description

[string, null]

Description

A description of the goods, services to be provided.

bids/details/0/items/0/classification

object

Classification

The primary classification for the item.

See Classification

bids/details/0/items/0/classification/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

bids/details/0/items/0/classification/id

[string, integer, null]

ID

The classification code taken from the scheme.

bids/details/0/items/0/classification/description

[string, null]

Description

A textual description or title for the classification code.

bids/details/0/items/0/classification/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

bids/details/0/items/0/additionalClassifications

array[Classification]

Additional classifications

An array of additional classifications for the item.

See Classification

bids/details/0/items/0/additionalClassifications/0/scheme

[string, null]

Scheme

The scheme or codelist from which the classification code is taken. For line item classifications, this uses the open itemClassificationScheme codelist.

bids/details/0/items/0/additionalClassifications/0/id

[string, integer, null]

ID

The classification code taken from the scheme.

bids/details/0/items/0/additionalClassifications/0/description

[string, null]

Description

A textual description or title for the classification code.

bids/details/0/items/0/additionalClassifications/0/uri

[string, null]

uri

URI

A URI to uniquely identify the classification code.

bids/details/0/items/0/quantity

[number, null]

Quantity

The number of units to be provided.

bids/details/0/items/0/unit

object

Unit

A description of the unit in which the supplies, services or works are provided (e.g. hours, kilograms) and the unit-price.

bids/details/0/items/0/unit/scheme

[string, null]

Scheme

The list from which identifiers for units of measure are taken, using the open unitClassificationScheme codelist. 'UNCEFACT' is recommended.

bids/details/0/items/0/unit/id

[string, null]

ID

The identifier from the codelist referenced in the scheme field. Check the unitClassificationScheme codelist for details of how to find and use identifiers from the scheme in use.

bids/details/0/items/0/unit/name

[string, null]

Name

Name of the unit.

bids/details/0/items/0/unit/value

object

Value

The monetary value of a single unit.

See Value

bids/details/0/items/0/unit/value/amount

[number, null]

Amount

Amount as a number.

bids/details/0/items/0/unit/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

bids/details/0/items/0/unit/uri

[string, null]

uri

URI

The machine-readable URI for the unit of measure, provided by the scheme.

bids/details/0/items/0/deliveryAddresses

array[Address]

Delivery Addresses

The addresses to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

bids/details/0/items/0/deliveryAddresses/0/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

bids/details/0/items/0/deliveryAddresses/0/locality

[string, null]

Locality

The locality. For example, Mountain View.

bids/details/0/items/0/deliveryAddresses/0/region

[string, null]

Region

The region. For example, CA.

bids/details/0/items/0/deliveryAddresses/0/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

bids/details/0/items/0/deliveryAddresses/0/countryName

[string, null]

Country name

The country name. For example, United States.

bids/details/0/items/0/deliveryAddresses/0/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

bids/details/0/items/0/deliveryLocations

array[Delivery Location]

Delivery Locations

The locations where activity related to this tender, contract or license will be delivered

See Location

bids/details/0/items/0/deliveryLocations/0/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

bids/details/0/items/0/deliveryLocations/0/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

bids/details/0/items/0/deliveryLocations/0/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

bids/details/0/items/0/deliveryLocations/0/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

bids/details/0/items/0/deliveryLocations/0/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

bids/details/0/items/0/deliveryLocations/0/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

bids/details/0/items/0/deliveryLocations/0/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

bids/details/0/items/0/deliveryLocations/0/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

bids/details/0/items/0/deliveryLocation

object

Delivery Location

The location where activity related to this tender, contract or license will be delivered, or will take place.

See Location

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryLocations` to support items with multiple delivery locations.

bids/details/0/items/0/deliveryLocation/description

[string, null]

Description

A name or description of this location. This might include the name(s) of the location(s), or might provide a human-readable description of the location to be covered.

bids/details/0/items/0/deliveryLocation/geometry

object

Geometry

We follow the GeoJSON standard to express basic location information, using longitude, latitude, and optional elevation values in the WGS84 (EPSG:4326) projection. A point location can be identified by geocoding a delivery address. For concession licenses, or other contracts covering a polygon location which is not contained in a known gazetteer, polygon and multi-polygon can be used.

bids/details/0/items/0/deliveryLocation/geometry/type

[string, null]

Type

The type of GeoJSON Geometry Objects being provided. To provide longitude, latitude, and optional elevation, use 'Point', and enter an array of [longitude, latitude] or [longitude, latitude, elevation] as the value of the coordinates field: e.g. [-122.085, 37.42].

bids/details/0/items/0/deliveryLocation/geometry/coordinates

array[[number, array]]

Coordinates

The relevant array of points, e.g. [longitude, latitude] or [longitude, latitude, elevation], or a nested array of points, for the GeoJSON geometry being described. The longitude and latitude must be expressed in decimal degrees in the WGS84 (EPSG:4326) projection.

bids/details/0/items/0/deliveryLocation/gazetteer

object

Gazetteer

Identifiers from a gazetteer (a geographical index or directory) for the location.

bids/details/0/items/0/deliveryLocation/gazetteer/scheme

[string, null]

Gazetteer scheme

The identifier of the gazetteer. The locationGazetteers.csv codelist provides details of services, where available, that can resolve a gazetteer entry to provide location names.

bids/details/0/items/0/deliveryLocation/gazetteer/identifiers

array[[string]]

Identifiers

An array of one or more codes drawn from the gazetteer indicated by the scheme field.

bids/details/0/items/0/deliveryLocation/uri

[string, null]

uri

URI

A URI to a further description of the activity location. This might be a human-readable document with information on the location, or a machine-readable description of the location.

bids/details/0/items/0/deliveryAddress

object

Delivery Address

The address to which, or where, goods or services related to this tender, contract or license will be delivered.

See Address

This property was deprecated in version 1.1.6

This field is deprecated in favour of `.deliveryAddresses` to support items with multiple delivery locations.

bids/details/0/items/0/deliveryAddress/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

bids/details/0/items/0/deliveryAddress/locality

[string, null]

Locality

The locality. For example, Mountain View.

bids/details/0/items/0/deliveryAddress/region

[string, null]

Region

The region. For example, CA.

bids/details/0/items/0/deliveryAddress/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

bids/details/0/items/0/deliveryAddress/countryName

[string, null]

Country name

The country name. For example, United States.

bids/details/0/items/0/deliveryAddress/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

bids/details/0/items/0/relatedLot

[string, null]

Related lot

The identifier of the lot to which this item relates.

bids/details/0/tenderers

array[Organization reference]

Tenderer

The party, or parties, responsible for this bid.

See OrganizationReference

bids/details/0/tenderers/0/name

[string, null]

Organization name

The name of the party being referenced. This must match the name of an entry in the parties section.

bids/details/0/tenderers/0/id

[string, integer]

Organization ID

The id of the party being referenced. This must match the id of an entry in the parties section.

bids/details/0/tenderers/0/identifier

object

Primary identifier

The primary identifier for this organization. Identifiers that uniquely pick out a legal entity should be preferred. Consult the organization identifier guidance for the preferred scheme and identifier to use.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and detailed legal identifier information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

bids/details/0/tenderers/0/identifier/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

bids/details/0/tenderers/0/identifier/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

bids/details/0/tenderers/0/identifier/legalName

[string, null]

Legal Name

The legally registered name of the organization.

bids/details/0/tenderers/0/identifier/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

bids/details/0/tenderers/0/address

object

Address

(Deprecated outside the parties section)

See Address

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and address information should only be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

bids/details/0/tenderers/0/address/streetAddress

[string, null]

Street address

The street address. For example, 1600 Amphitheatre Pkwy.

bids/details/0/tenderers/0/address/locality

[string, null]

Locality

The locality. For example, Mountain View.

bids/details/0/tenderers/0/address/region

[string, null]

Region

The region. For example, CA.

bids/details/0/tenderers/0/address/postalCode

[string, null]

Postal code

The postal code. For example, 94043.

bids/details/0/tenderers/0/address/countryName

[string, null]

Country name

The country name. For example, United States.

bids/details/0/tenderers/0/address/countryCode

[string, null]

Country code

The country where the address is located. If you need to use a user-assigned code from ISO 3166-1 alpha-2, create an issue to discuss its addition to the country.csv codelist.

bids/details/0/tenderers/0/additionalIdentifiers

array[Identifier]

Additional identifiers

(Deprecated outside the parties section) A list of additional / supplemental identifiers for the organization, using the organization identifier guidance. This can be used to provide an internally used identifier for this organization in addition to the primary legal entity identifier.

See Identifier

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and additional identifiers for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

bids/details/0/tenderers/0/additionalIdentifiers/0/scheme

[string, null]

Scheme

Organization identifiers should be taken from an existing organization identifier list. The scheme field is used to indicate the list or register from which the identifier is taken. This value should be taken from the Organization Identifier Scheme codelist.

bids/details/0/tenderers/0/additionalIdentifiers/0/id

[string, integer, null]

ID

The identifier of the organization in the selected scheme.

bids/details/0/tenderers/0/additionalIdentifiers/0/legalName

[string, null]

Legal Name

The legally registered name of the organization.

bids/details/0/tenderers/0/additionalIdentifiers/0/uri

[string, null]

uri

URI

A URI to identify the organization, such as those provided by Open Corporates or some other relevant URI provider. This is not for listing the website of the organization: that can be done through the URL field of the Organization contact point.

bids/details/0/tenderers/0/contactPoint

object

Contact point

(Deprecated outside the parties section)

See ContactPoint

This property was deprecated in version 1.1

From version 1.1, organizations should be referenced by their identifier and name in a document, and contact point information for an organization should be provided in the relevant cross-referenced entry in the parties section at the top level of a release.

bids/details/0/tenderers/0/contactPoint/name

[string, null]

Name

The name of the contact person, department, or contact point, for correspondence relating to this contracting process.

bids/details/0/tenderers/0/contactPoint/email

[string, null]

Email

The e-mail address of the contact point/person.

bids/details/0/tenderers/0/contactPoint/telephone

[string, null]

Telephone

The telephone number of the contact point/person. This should include the international dialing code.

bids/details/0/tenderers/0/contactPoint/faxNumber

[string, null]

Fax number

The fax number of the contact point/person. This should include the international dialing code.

bids/details/0/tenderers/0/contactPoint/url

[string, null]

uri

URL

A web address for the contact point/person.

bids/details/0/tenderers/0/contactPoint/availableLanguage

array[string]

Available languages

The languages the contact point operates in, using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is strongly recommended unless there is a clear user need for distinguishing the language subtype.

bids/details/0/value

object

Value

The total value of the bid.

See Value

bids/details/0/value/amount

[number, null]

Amount

Amount as a number.

bids/details/0/value/currency

[string, null]

Currency

The currency of the amount, from the closed currency codelist.

bids/details/0/validityPeriod

object

Validity period

The period for which this bid is valid.

See Period

bids/details/0/validityPeriod/startDate

[string, null]

date-time

Start date

The start date for the period. When known, a precise start date must be provided.

bids/details/0/validityPeriod/endDate

[string, null]

date-time

End date

The end date for the period. When known, a precise end date must be provided.

bids/details/0/validityPeriod/maxExtentDate

[string, null]

date-time

Maximum extent

The period cannot be extended beyond this date. This field can be used to express the maximum available date for extension or renewal of this period.

bids/details/0/validityPeriod/durationInDays

[integer, null]

Duration (days)

The maximum duration of this period in days. A user interface can collect or display this data in months or years as appropriate, and then convert it into days when storing this field. This field can be used when exact dates are not known. If a startDate and endDate are set, this field, if used, should be equal to the difference between startDate and endDate. Otherwise, if a startDate and maxExtentDate are set, this field, if used, should be equal to the difference between startDate and maxExtentDate.

bids/details/0/documents

array[Document]

Documents

All documents and attachments related to the bid and its evaluation.

See Document

bids/details/0/documents/0/id

[string, integer]

Required

ID

A local, unique identifier for this document. This field is used to keep track of multiple revisions of a document through the compilation from release to record mechanism.

bids/details/0/documents/0/documentType

[string, null]

Document type

A classification of the document described, using the open documentType codelist.

bids/details/0/documents/0/title

[string, null]

Title

The document title.

bids/details/0/documents/0/description

[string, null]

Description

A short description of the document. Descriptions are recommended to not exceed 250 words. In the event the document is not accessible online, the description field can be used to describe arrangements for obtaining a copy of the document.

bids/details/0/documents/0/url

[string, null]

uri

URL

A direct link to the document or attachment. The server providing access to this document ought to be configured to correctly report the document mime type.

bids/details/0/documents/0/datePublished

[string, null]

date-time

Date published

The date on which the document was first published. This is particularly important for legally important documents such as notices of a tender.

bids/details/0/documents/0/dateModified

[string, null]

date-time

Date modified

Date that the document was last modified

bids/details/0/documents/0/format

[string, null]

Format

The format of the document, using the open IANA Media Types codelist (see the values in the 'Template' column), or using the 'offline/print' code if the described document is published offline. For example, web pages have a format of 'text/html'.

bids/details/0/documents/0/language

[string, null]

Language

The language of the linked document using either two-letter ISO639-1, or extended BCP47 language tags. The use of lowercase two-letter codes from ISO639-1 is recommended unless there is a clear user need for distinguishing the language subtype.

bids/details/0/documents/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this document relates.

bids/details/0/relatedLots

array[[string]]

Related lot(s)

The identifiers of the lots to which this bid relates.

title

[string, null]

Title

A overall title for this contracting process or release.

description

[string, null]

Description

An overall description of this contracting process or release. This does not replace a detailed breakdown of the objects of the contracting process in the planning, tender, award or contracts section.