Schema reference

This page presents the fields in the OC4IDS schema in tables with additional information in paragraphs. Required fields are indicated in the Required column.

For fields that reference a sub-schema, a link is provided to a table with details of the sub-schema. To see how the fields and sub-schemas fit together, consult the schema browser.

Examples are provided for each table, showing how to represent the fields in the table in JSON format. For more information on the examples, see examples.

Project

The top-level object in OC4IDS is a project.

A project is defined as:

The development of a set of infrastructure assets in a specified location, generally the responsibility of a single procuring entity and budget authority: for example, a highway overpass or a university campus.

A project's fields include:

• Metadata, such as the project's title, description and status.

• Budget data, which describes the projected costs or allocated budget for the project.

• Data about the parties (organizations and other participants) involved in the project.

• Links to documents relating to the project, such as needs assessments and project evaluations.

• Data about contracting processes for different aspects of the project, such as design, construction and supervision.

• Completion data, such as the final scope, duration and costs for the project.

Each project has the following fields.

Schema

Title	Description	Type	Format	Required
id		string		Required
Identifier or Reference	An identifier for this infrastructure project. The identifier must be globally unique and must begin with a registered project identifier prefix. For more information, see the project identifier guidance.
updated		string	date-time
Last updated	The date on which project-level information was last updated. This should not be changed when constituent contracting processes information changes, unless this project-level data has been updated as a result, or to provide explanations or justifications for those changes.
language		[string]
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.
identifiers		array[Simple identifier]
Identifiers	Identifiers for this project. This field can be used to provide internal identifiers for the project, such as identifiers from a project management system or procurement system. See SimpleIdentifier
publicAuthority		object
Public authority	The name and identifier of the public authority that is tendering and contracting the project. The full details of the entity should be added to the project-level parties array with a role of 'publicAuthority'. See OrganizationReference
title		string
Project title	The title of the project.
description		string
Project description	A description of this project. This should usually be no longer than a single paragraph.
budget		object
Total project value	Specify the allocated budget for the infrastructure project (currency and amount). This cost should include land and property acquisition, environmental mitigation measures, health and safety provisions, client, consultant and supplier costs, as well as applicable taxes. Where this value includes costs incurred directly by the project owner or other agencies, which are not subject to procurement, then this value is likely to be higher than the sum of all the linked contracting processes. To indicate the profile of a budget over time, or the budget coming from different sources, the extended budgetBreakdown section may be used.
budget/description		string
Description	A short free-text description of the budget that will fund the project. This may be used to provide human-readable information on: the budget category for the project and/or the nature and source of the budget allocation (e.g. conditional, confirmed, or any official authorizations given to the budget allocation).
budget/amount		object
Amount	The projected costs or allocated budget for the project. See Value
budget/requestDate		string	date-time
Request date	The date on which the project budget was requested.
budget/approvalDate		string	date-time
Approval date	The date on which the project budget was approved. Where documentary evidence for this exists, it may be included among the project documents with the documentType set to 'budgetApproval'.
budget/budgetBreakdowns		array[Budget breakdown group]
Budget breakdowns	Detailed breakdowns of the budget grouped together by, for example, period, funder or stage. See BudgetBreakdowns
budget/finance		array[Financing arrangement]
Finance	Information about financing arrangements for the project. See Finance
period		object
Project period	The period over which this project is planned to run. This may be updated during the preparation phase as information becomes available to more accurately specify anticipated start and end dates, but should not be updated during the implementation or completion phases. The planned completion date of the project should be provided in period.endDate, which can be compared with the actual completion date in completion.endDate See Period
locations		array[Delivery Location]
Project locations	Information about the location where a project is taking place. One or more locations may be provided, or the location may be described in a number of different ways, such as a point location for the central location of construction, and a gazetteer entry to describe the region where the project is taking place. See Location
status		string
Status	The current phase or status of this project, from the projectStatus codelist.
type		string
Project type	Whether the primary focus of this project is the construction of a new asset or the rehabilitation or replacement of an existing asset, from the projectType codelist.
sector		array[string]
Project sector	One or more values from the projectSector codelist representing the sector(s) this project relates to. More detailed sector breakdown information can be provided using the pattern [sector].[subsector]. Where subsector codes are used the parent code should also be included, e.g. ['transport', 'transport.air']
purpose		string
Project purpose	The socioeconomic purpose of this project.
additionalClassifications		array[Classification]
Additional classifications	Classifications of the project: for example, according to its social and economic purpose. See also the purpose field. See Classification
parties		array[Organization]
Parties	Information on the parties (organizations, economic operators and other participants) who are involved in the project 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
assetLifetime		object
Asset lifetime	The anticipated lifetime of the asset after this project is completed. This may be provided as either explicit dates or an estimated duration. See Period
identificationPeriod		object
Identification period	The period over which the identification stage is planned to run. See Period
preparationPeriod		object
Preparation period	The period over which the preparation stage is planned to run. See Period
implementationPeriod		object
Implementation period	The period over which the implementation stage is planned to run. See Period
completionPeriod		object
Completion period	The period over which the completion stage is planned to run. See Period
maintenancePeriod		object
Maintenance period	The period over which the maintenance stage is planned to run. See Period
decommissioningPeriod		object
Decommissioning period	The period over which the decommissioning stage is planned to run. See Period
forecasts		array[Metric]
Forecasts	Forecast metrics for this project, such as planned physical or financial progress over time. See Metric
metrics		array[Metric]
Metrics	Actual metrics for this project, such as the actual physical or financial progress over time. See Metric
milestones		array[Milestone]
Milestones	Milestones associated with this project. See Milestone
completion		object
Completion	This information is provided at project completion, and reflects the final timing and values relating to the project. The reason for any variation (not already explained) between the anticipated project scope, period and value should be detailed.
completion/endDate		string	date-time
End date	The actual completion date for the project (compare with the endDate in project period).
completion/endDateDetails		string
End date details	Details related to the endDate. This may be a justification for the project's completion date being different than in the original project.
completion/finalValue		object
Final value	The total cost of this project at completion (compare with project budget). See Value
completion/finalScope		string
Final scope	A short description of the final scope of the project at completion.
completion/finalScopeDetails		string
Final scope details	A reason, explanation or justification for any variation between the anticipated scope (compare to the projectScope document) and the final scope at completion. If appropriate, additional details may be included in the documents section, with a title indicating that these documents will describe and differences between the planned and completed scope of work.
costMeasurements		array[Cost measurement]
Cost measurements	Information about cost measurements for the project. See CostMeasurement
transactions		array[Transaction information]
Transactions	Financial transactions related to this project. For example, a disbursement from a funder to the project company. Transactions related to a contracting process, like a disbursement from a funder to a supplier, should be recorded in the contracting process summary's .transactions. See Transaction
documents		array[Document]
Documents	Documentation related to this project. Entries may include a short text summary (plain text, HTML or Markdown), and/or a link to a specific document accessible on the web. At the identification phase, a project scope (documentType: projectScope) is expected. At the preparation phase, environmental impact (documentType: environmentalImpact) and land and settlement impact (documentType: landAndSettlementImpact) documentation is expected. During implementation, procurement documents should be shared at the contracting process level, but key documents may also be provided here. At the completion phase, final audit (documentType: finalAudit) and evaluation (documentType: projectEvaluation) reports and documents are expected. See Document
contractingProcesses		array[Contracting process]
Contracting processes	A single project may have a number of related contracting processes (design, construction, monitoring etc.). Project-level data should contain (a) an index of those contracting process; (b) the latest summary information about them; (c) a change history with explanations for any major modifications to contract duration, price or scope. Where OCDS data is published on each contracting process, a link should be provided to each available release of OCDS data (e.g. to each notice or updated notice), and this OCDS data may be used to automatically populate the summary information. See ContractingProcess
relatedProjects		array[Related project]
Related projects	References to projects related to the same set of infrastructure assets as this project. For example, a project for the replacement of a bridge might reference the earlier project for its initial construction. See RelatedProject
policyAlignment		object
Policy alignment	Information about how the project aligns with international, national and/or sectoral policies.
policyAlignment/policies		array[string]
Policies	The policies the project aligns with, using the open policyAlignment codelist.
policyAlignment/description		string
Description	A short description of how the project aligns with the policies.
benefits		array[Benefit]
Benefits	The benefits and intended benefits of the project. See Benefit
social		object
Social	Information about the social impacts of the project and the actions the project will take to mitigate potentially negative impacts on adjacent populations and project workers. See Social
environment		object
Environment	Information about the environmental and climate impacts of the project and the actions the project will take to mitigate potentially negative impacts on adjacent populations and habitats.
environment/goals		array[string]
Environmental goals	The environmental goals pursued, using the closed environmentalGoal codelist.
environment/climateOversightTypes		array[string]
Climate oversight types	Whether the oversight of this project's climate impact is performed internally, externally or both, from the closed climateOversightTypes codelist.
environment/hasImpactAssessment		boolean
Has impact assessment	Whether an environmental impact assessment has been conducted.
environment/impactCategories		array[Classification]
Impact categories	The categories of the environmental impact of the project. See Classification
environment/conservationMeasures		array[Conservation measure]
Conservation measures	The measures adopted by the project to protect and enhance biodiversity. See ConservationMeasure
environment/abatementCost		object
Abatement cost	The lifetime abatement cost of the project, measured in cost per tonne of CO2 equivalent emissions. That is, the additional cost of reducing greenhouse gas emissions by one tonne compared to the most likely alternative scenario. See Value
environment/inProtectedArea		boolean
In protected area	Whether the project is located in a protected area.
environment/climateMeasures		array[Climate measure]
Climate measures	The measures adopted by the project to adapt to or mitigate against climate change. See ClimateMeasure
environment/climateMeasures/0/type		array[string]
Type	The type of climate measure, using the open climateMeasures codelist.
environment/climateMeasures/0/description		string
Description	A short description of the climate measure.
lobbyingMeetings		array[Meeting]
Lobbying meetings	Information about lobbying meetings in relation to the project. That is, meetings with public officials that are made, managed or directed with the purpose of influencing public decision-making in relation to the project, whether for private, public or collective ends, whether for compensation or without. Public decision-making is the creation and amendment of legislation or any other regulatory measures; the development, modification and implementation of public policies, strategies and programs; and the awarding of government contracts or grants, administrative decisions or any other public spending decisions. See Meeting

Examples

{
    "id": "oc4ids-bu3kcz-m75-junctions-4-to-5-smart-motorway",
    "identifiers": [
        {
            "id": "M75/SM/4-5",
            "scheme": "internal"
        }
    ],
    "updated": "2018-12-10T15:53:00Z",
    "title": "M75 Junctions 4 to 5 upgrade smart motorway",
    "description": "Upgrading the 5km stretch of the M75 near Birmingham Airport, between junction 4 near Patcham and junction 5 at Windlesham, to an all-lane running smart motorway.",
    "status": "completed",
    "period": {
        "startDate": "2016-01-01T00:00:00Z",
        "endDate": "2018-12-10T00:00:00Z",
        "durationInDays": 1074
    },
    "identificationPeriod": {
        "startDate": "2016-01-01T00:00:00Z",
        "endDate": "2016-06-30T00:00:00Z"
    },
    "preparationPeriod": {
        "startDate": "2016-07-01T00:00:00Z",
        "endDate": "2016-12-31T00:00:00Z"
    },
    "implementationPeriod": {
        "startDate": "2017-01-01T00:00:00Z",
        "endDate": "2017-06-30T00:00:00Z"
    },
    "completionPeriod": {
        "startDate": "2017-07-01T00:00:00Z",
        "endDate": "2017-12-31T00:00:00Z"
    },
    "maintenancePeriod": {
        "startDate": "2018-01-01T00:00:00Z",
        "endDate": "2040-07-01T00:00:00Z"
    },
    "decommissioningPeriod": {
        "startDate": "2040-07-01T00:00:00Z",
        "endDate": "2041-06-30T00:00:00Z"
    },
    "sector": [
        "transport",
        "transport.road"
    ],
    "additionalClassifications": [
        {
            "scheme": "COFOG",
            "id": "04.5.1",
            "description": "Road transport (CS)"
        }
    ],
    "type": "expansion",
    "purpose": "To help support local economic growth and maintain mobility.",
    "relatedProjects": [
        {
            "id": "1",
            "scheme": "oc4ids",
            "identifier": "oc4ids-bu3kcz-m75-junctions-4-to-5-construction",
            "relationship": "construction",
            "title": "Original construction of M75 J4-5"
        }
    ],
    "assetLifetime": {
        "startDate": "2018-07-01T00:00:00Z",
        "endDate": "2040-07-01T00:00:00Z",
        "durationInDays": 8027
    },
    "locations": [
        {
            "id": "001",
            "description": "M75 J4 Patcham Interchange",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    52.2571843,
                    -0.1163333
                ]
            },
            "gazetteer": {
                "scheme": "GEONAMES",
                "identifiers": [
                    "2657507"
                ]
            },
            "address": {
                "streetAddress": "Patcham Interchange, New Road",
                "locality": "Patcham",
                "region": "Westshire",
                "postalCode": "WS20 5TV",
                "countryName": "United Kingdom"
            },
            "uri": "https://www.openstreetmap.org/node/202995"
        },
        {
            "id": "002",
            "description": "M75 J5 Windlesham interchange",
            "geometry": {
                "type": "Point",
                "coordinates": [
                    52.1373584,
                    -0.1198955
                ]
            },
            "gazetteer": {
                "scheme": "OSMN",
                "identifiers": [
                    "https://www.openstreetmap.org/node/26571091"
                ]
            },
            "address": {
                "streetAddress": "Windlesham Interchange, Old Road",
                "locality": "Windlesham",
                "region": "Westshire",
                "postalCode": "WS21 6RZ",
                "countryName": "United Kingdom"
            },
            "uri": "https://www.openstreetmap.org/node/1638915385"
        }
    ],
    "budget": {
        "description": "Budget allocation for Motorways UK, aligned with the 2016-2018 strategic plan.",
        "amount": {
            "amount": 40000000,
            "currency": "GBP"
        },
        "requestDate": "2015-05-30T00:00:00Z",
        "approvalDate": "2015-06-24T00:00:00Z",
        "budgetBreakdowns": [
            {
                "id": "1",
                "description": "Breakdown by year of implementation",
                "budgetBreakdown": [
                    {
                        "id": "2016",
                        "description": "2016 budget allocation",
                        "amount": {
                            "amount": 10000000,
                            "currency": "GBP"
                        },
                        "period": {
                            "startDate": "2016-01-01T00:00:00Z",
                            "endDate": "2016-12-31T00:00:00Z"
                        },
                        "sourceParty": {
                            "name": "Motorways UK",
                            "id": "GB-GOR-XX1234"
                        }
                    },
                    {
                        "id": "2017",
                        "description": "2017 budget allocation",
                        "amount": {
                            "amount": 20000000,
                            "currency": "GBP"
                        },
                        "period": {
                            "startDate": "2017-01-01T00:00:00Z",
                            "endDate": "2017-12-31T00:00:00Z"
                        },
                        "sourceParty": {
                            "name": "Motorways UK",
                            "id": "GB-GOR-XX1234"
                        }
                    },
                    {
                        "id": "2018",
                        "description": "2018 budget allocation",
                        "amount": {
                            "amount": 10000000,
                            "currency": "GBP"
                        },
                        "period": {
                            "startDate": "2018-01-01T00:00:00Z",
                            "endDate": "2018-12-31T00:00:00Z"
                        },
                        "sourceParty": {
                            "name": "Motorways UK",
                            "id": "GB-GOR-XX1234"
                        }
                    }
                ]
            }
        ],
        "finance": [
            {
                "id": "1",
                "assetClass": "debt",
                "type": "loan",
                "concessional": true,
                "value": {
                    "amount": 50000000,
                    "currency": "USD"
                },
                "source": "Green Climate Fund",
                "financingParty": {
                    "id": "1",
                    "name": "United Nations Development Programme"
                },
                "period": {
                    "startDate": "2024-01-01T00:00:00Z",
                    "endDate": "2043-12-31T00:00:00Z"
                },
                "paymentPeriod": {
                    "startDate": "2029-01-01T00:00:00Z",
                    "endDate": "2043-12-31T00:00:00Z"
                },
                "interestRate": {
                    "margin": 0.0075
                },
                "description": "Annual principal repayment years 11\u201320 (% of initial principal): 6.7%. Service fee (per annum): 0.50%. Commitment fee (per annum): Up to 0.75%."
            }
        ]
    },
    "costMeasurements": [
        {
            "id": "1",
            "date": "2024-05-01T00:00:00Z",
            "lifeCycleCosting": {
                "value": {
                    "amount": 10000000,
                    "currency": "USD"
                }
            },
            "costGroups": [
                {
                    "id": "1",
                    "category": "endOfLife",
                    "costs": [
                        {
                            "id": "1",
                            "value": {
                                "amount": 50000000,
                                "currency": "USD"
                            },
                            "classification": {
                                "id": "4.02",
                                "scheme": "icms",
                                "description": "Decommissioning and decontamination"
                            }
                        }
                    ]
                }
            ]
        }
    ],
    "parties": [
        {
            "name": "Motorways UK",
            "id": "GB-GOR-XX1234",
            "identifier": {
                "scheme": "GB-GOR",
                "legalName": "Motorways UK",
                "id": "XX1234",
                "uri": "https://government-organisation.register.gov.uk/records/XX1234"
            },
            "additionalIdentifiers": [
                {
                    "scheme": "GB-GOV",
                    "legalName": "Motorways UK",
                    "id": "ABCDE"
                }
            ],
            "address": {
                "postalCode": "LL55 4NY",
                "countryName": "United Kingdom",
                "streetAddress": "8 Mountain Walk",
                "region": "Westshire",
                "locality": "Patcham"
            },
            "contactPoint": {
                "name": "Motorways Manager",
                "email": "EX12345@motorwaysuk.gov.uk",
                "telephone": "+44 0123 456 7890",
                "faxNumber": "+44 0123 456 7891"
            },
            "roles": [
                "procuringEntity",
                "buyer",
                "publicAuthority",
                "funder",
                "payee"
            ],
            "people": [
                {
                    "id": "1",
                    "name": "Jane Bloggs",
                    "jobTitle": "Chair"
                }
            ],
            "classifications": [
                {
                    "id": "national",
                    "scheme": "costIdsAdministrativeLevel"
                }
            ]
        },
        {
            "name": "A1 Expert Smart Moto Design",
            "id": "GB-COH-11111111",
            "identifier": {
                "scheme": "GB-COH",
                "id": "11111111",
                "legalName": "A1 Expert Smart Moto Design Ltd",
                "uri": "https://beta.companieshouse.gov.uk/company/11111111"
            },
            "address": {
                "streetAddress": "Farm Grove, Prince Road",
                "locality": "Patcham",
                "region": "Westshire",
                "postalCode": "WS18 5BW",
                "countryName": "United Kingdom"
            },
            "contactPoint": {
                "name": "Kim Designer",
                "email": "kim.designerd@a1expertsmart.com",
                "telephone": "+44 0123 456 7890",
                "url": "https://www.example.com"
            },
            "roles": [
                "supplier",
                "tenderer"
            ]
        },
        {
            "name": "Motorway Design Services PLC",
            "id": "GB-COH-12345678",
            "identifier": {
                "scheme": "GB-COH",
                "id": "12345678",
                "legalName": "Motorway Design Services PLC",
                "uri": "https://beta.companieshouse.gov.uk/company/22222222"
            },
            "address": {
                "streetAddress": "567 High Street",
                "locality": "Mareham",
                "region": "Eastshire",
                "postalCode": "ES22 3TW",
                "countryName": "United Kingdom"
            },
            "roles": [
                "tenderer"
            ]
        },
        {
            "name": "Expert Motorway Supervisors Ltd",
            "id": "GB-COH-22222222",
            "identifier": {
                "scheme": "GB-COH",
                "id": "22222222",
                "legalName": "Expert Motorway Supervisors Ltd",
                "uri": "https://beta.companieshouse.gov.uk/company/22222222"
            },
            "address": {
                "streetAddress": "9 Seaview Road",
                "locality": "London",
                "region": "London",
                "postalCode": "SE1 1EZ",
                "countryName": "United Kingdom"
            },
            "contactPoint": {
                "name": "Supervisor Manager",
                "email": "supervisor.manager@example.com",
                "telephone": "+44 0123 456 7890",
                "faxNumber": "+44 0123 456 7891",
                "url": "https://www.example.com"
            },
            "roles": [
                "supplier",
                "tenderer"
            ]
        },
        {
            "name": "Concrete Motorways Construction",
            "id": "GB-COH-33333333",
            "identifier": {
                "scheme": "GB-COH",
                "id": "33333333",
                "legalName": "Concrete Motorways Construction Ltd",
                "uri": "https://beta.companieshouse.gov.uk/company/33333333"
            },
            "address": {
                "streetAddress": "5 Example Grove",
                "locality": "London",
                "region": "London",
                "postalCode": "SW1A 1AA",
                "countryName": "United Kingdom"
            },
            "contactPoint": {
                "name": "Construction Manager",
                "email": "construction.example@example.com",
                "telephone": "+44 0123 456 7890",
                "faxNumber": "+44 0123 456 7891",
                "url": "https://www.example.com"
            },
            "roles": [
                "supplier",
                "tenderer"
            ],
            "beneficialOwners": [
                {
                    "id": "1",
                    "name": "Juan Perez",
                    "identifier": {
                        "scheme": "PRY-IDCARD",
                        "id": "12345"
                    },
                    "nationalities": [
                        "PY"
                    ],
                    "address": {
                        "streetAddress": "Avenida Eusebio Ayala 1347",
                        "locality": "Asunci\u00f3n",
                        "region": "Gran Asunci\u00f3n",
                        "postalCode": "1001",
                        "countryName": "Paraguay"
                    },
                    "email": "jperez@example.com",
                    "faxNumber": "+595210000001",
                    "telephone": "+595210000000"
                }
            ]
        },
        {
            "name": "Motorways Administrator UK",
            "id": "GB-GOR-XX9876",
            "identifier": {
                "scheme": "GB-GOR",
                "legalName": "Motorways Administrator UK",
                "id": "XX9876",
                "uri": "https://government-organisation.register.gov.uk/records/XX9876"
            },
            "address": {
                "postalCode": "BN18 9AB",
                "countryName": "United Kingdom",
                "streetAddress": "High Street, Arundel",
                "region": "West Sussex"
            },
            "contactPoint": {
                "name": "Motorways Administrator",
                "email": "EX6789@motorways-administration-uk.gov.uk",
                "telephone": "+44 0678 456 7890",
                "faxNumber": "+44 0678 456 7891"
            },
            "roles": [
                "administrativeEntity"
            ],
            "people": [
                {
                    "id": "1",
                    "name": "Elstra Lovelace",
                    "jobTitle": "Commercial Contract Officer"
                }
            ]
        },
        {
            "id": "1",
            "name": "United Nations Development Programme",
            "roles": [
                "payer",
                "funder"
            ]
        }
    ],
    "publicAuthority": {
        "name": "Motorways UK",
        "id": "GB-GOR-XX1234"
    },
    "documents": [
        {
            "id": "plan-1234",
            "documentType": "procurementPlan",
            "title": "M75 Junction 4 to 5 Smart Motorway procurement plan.",
            "description": "Procurement plan for the M75 Junction 4 to 5 Smart Motorway covering the full life-cycle of the Smart Motorway junction upgrade.",
            "url": "https://example.com/he/M75-junctions-4-to-5-smart-motorway/results/M75J4-5+procurement+plan.pdf",
            "datePublished": "2016-05-01T00:00:00Z",
            "dateModified": "2016-05-11T00:00:00Z",
            "format": "application/pdf",
            "language": "en",
            "author": "Fred Consulter"
        },
        {
            "id": "environmental-impact-5678-r4",
            "documentType": "environmentalImpact",
            "title": "Environmental Study Report",
            "description": "An Environmental Study Report into the M75 Junction 4 to 5 Smart Motorway Upgrade",
            "url": "http://example.com/roads/road-projects/M75+junctions+4+to+5++smart+motorway/M75+J4-5SM+Environmental+Study+Report.pdf",
            "datePublished": "2016-02-10T00:00:00Z",
            "dateModified": "2016-12-15T00:00:00Z",
            "format": "application/pdf",
            "author": "Jane Environment, Environment Motorway Consultants Ltd."
        },
        {
            "id": "budget-approval-5678",
            "documentType": "budgetApproval",
            "title": "Approval of Budget for M75 J4-5 upgrade",
            "description": "A full budget approval document for the M75 J4-5 upgrade with budgeting for design, build and supervision.",
            "url": "http://example.com/roads/road-projects/M75+unctions+4+to+5+budget+approval.pdf",
            "datePublished": "2015-10-01T00:00:00Z",
            "dateModified": "2018-03-01T00:00:00Z",
            "format": "application/pdf",
            "author": "UK Motorways Budget Agency",
            "pageStart": "55",
            "pageEnd": "60",
            "accessDetails": "Documents can be inspected in the Motoways UK Example Archive or users can register for free to access."
        },
        {
            "id": "feasibility-study-8976",
            "documentType": "feasibilityStudy",
            "title": "Feasibility Study for Smart Motorway project: benefits and costs",
            "description": "A report commissioned by Motorways UK to carry out initial investigations and site visits to esablish the suitability of upgrading the existing motorway junctions M75 J4-5 to Smart Motorways.\n\nThe survey recorded existing motorway infrastructures and concluded that upgrading to Smart Motorways is feasible. \n\nAdditional design issues are noted in the report.",
            "datePublished": "2015-10-10T00:00:00Z",
            "format": "application/pdf",
            "author": "Feasibility Consultants Example Limited",
            "pageStart": "55"
        }
    ],
    "forecasts": [
        {
            "id": "physicalProgress",
            "title": "Physical progress",
            "observations": [
                {
                    "id": "1",
                    "measure": "50",
                    "unit": {
                        "name": "percent",
                        "id": "P1",
                        "scheme": "UNCEFACT"
                    },
                    "period": {
                        "startDate": "2018-01-07T00:00:00Z",
                        "endDate": "2018-01-07T00:00:00Z"
                    },
                    "value": {}
                },
                {
                    "id": "2",
                    "measure": "75",
                    "unit": {
                        "name": "percent",
                        "id": "P1",
                        "scheme": "UNCEFACT"
                    },
                    "period": {
                        "startDate": "2018-04-07T00:00:00Z",
                        "endDate": "2018-04-07T00:00:00Z"
                    }
                },
                {
                    "id": "3",
                    "measure": "100",
                    "unit": {
                        "name": "percent",
                        "id": "P1",
                        "scheme": "UNCEFACT"
                    },
                    "period": {
                        "startDate": "2018-07-01T00:00:00Z",
                        "endDate": "2018-07-01T00:00:00Z"
                    }
                }
            ]
        }
    ],
    "metrics": [
        {
            "id": "physicalProgress",
            "title": "Physical progress",
            "observations": [
                {
                    "id": "1",
                    "measure": "50",
                    "unit": {
                        "name": "percent",
                        "id": "P1",
                        "scheme": "UNCEFACT"
                    },
                    "period": {
                        "startDate": "2018-01-07T00:00:00Z",
                        "endDate": "2018-01-07T00:00:00Z"
                    },
                    "value": {}
                },
                {
                    "id": "2",
                    "measure": "75",
                    "unit": {
                        "name": "percent",
                        "id": "P1",
                        "scheme": "UNCEFACT"
                    },
                    "period": {
                        "startDate": "2018-08-07T00:00:00Z",
                        "endDate": "2018-08-07T00:00:00Z"
                    }
                },
                {
                    "id": "3",
                    "measure": "100",
                    "unit": {
                        "name": "percent",
                        "id": "P1",
                        "scheme": "UNCEFACT"
                    },
                    "period": {
                        "startDate": "2018-12-01T00:00:00Z",
                        "endDate": "2018-12-01T00:00:00Z"
                    }
                }
            ]
        }
    ],
    "contractingProcesses": [
        {
            "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b",
            "summary": {
                "ocid": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b",
                "externalReference": "2016-SMP-M75-J4_J5-construction",
                "nature": [
                    "construction"
                ],
                "title": "Smart Motorways Programme - Construction - Package 3 - M75 J8 - 10",
                "description": "Collaborative Delivery Framework (CDF) - Lot 3B - Construction  \u00a310 to  \u00a350m",
                "status": "closed",
                "tender": {
                    "procurementMethod": "limited",
                    "procurementMethodDetails": "Restricted procedure",
                    "datePublished": "2016-04-01T00:00:00Z",
                    "costEstimate": {
                        "amount": 33000000,
                        "currency": "GBP"
                    },
                    "numberOfTenderers": 1,
                    "tenderers": [
                        {
                            "name": "Concrete Motorways Construction",
                            "id": "GB-COH-33333333"
                        }
                    ],
                    "procuringEntity": {
                        "name": "Motorways UK",
                        "id": "GB-GOR-XX1234"
                    },
                    "administrativeEntity": {
                        "name": "Motorways Administrator UK",
                        "id": "GB-GOR-XX9876"
                    },
                    "sustainability": [
                        {
                            "strategies": [
                                "awardCriteria"
                            ]
                        }
                    ]
                },
                "suppliers": [
                    {
                        "name": "Concrete Motorways Construction",
                        "id": "GB-COH-33333333"
                    }
                ],
                "contractValue": {
                    "amount": 29000000,
                    "currency": "GBP"
                },
                "contractPeriod": {
                    "startDate": "2017-07-07T00:00:00Z",
                    "endDate": "2018-07-01T00:00:00Z"
                },
                "finalValue": {
                    "amount": 35250000,
                    "currency": "GBP"
                },
                "milestones": [
                    {
                        "id": "1",
                        "title": "Construction payment",
                        "status": "met",
                        "dueDate": "2017-08-07T00:00:00Z",
                        "dateMet": "2017-08-07T00:00:00Z",
                        "type": "payment",
                        "value": {
                            "amount": 1950000,
                            "currency": "GBP"
                        }
                    }
                ],
                "transactions": [
                    {
                        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-00001-1",
                        "source": "https://openspending.org/motorways-uk-spending/",
                        "date": "2017-08-07T00:00:00Z",
                        "value": {
                            "amount": 1950000,
                            "currency": "GBP"
                        },
                        "payer": {
                            "id": "GB-GOR-XX1234",
                            "name": "Motorways UK"
                        },
                        "payee": {
                            "name": "Concrete Motorways Construction",
                            "id": "GB-COH-33333333"
                        },
                        "uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123",
                        "relatedImplementationMilestone": {
                            "id": "1",
                            "title": "Construction payment"
                        }
                    }
                ],
                "documents": [
                    {
                        "id": "a1b1c1-construction-excavation-report",
                        "documentType": "physicalProgressReport",
                        "title": "Report on construction excavation",
                        "description": "A report on the construction at Junction 5 where excavation damaged a watercourse.",
                        "url": "https://example.com/Published/a1b1c1-construction-monitoring.html",
                        "datePublished": "2018-02-01T00:00:00Z",
                        "dateModified": "2018-02-11T00:00:00Z",
                        "format": "text/html",
                        "language": "en",
                        "accessDetails": "Register for document access.",
                        "author": "Motorways UK"
                    },
                    {
                        "id": "a1b1c1-construction-completion",
                        "documentType": "completionCertificate",
                        "title": "Completion certificate for construction at M75 J4-5 upgrade",
                        "description": "Completion certificate for the construction upgrading motorway M75 Junctions 4-5.",
                        "url": "https://example.com/Published/a1b1c1-construction-completion.html",
                        "datePublished": "2018-12-10T00:00:00Z",
                        "format": "text/html",
                        "language": "en",
                        "accessDetails": "Register for document access.",
                        "author": "Motorways UK"
                    }
                ],
                "modifications": [
                    {
                        "id": "m27-4-5-construction-modification-001",
                        "date": "2018-04-01T15:15:00Z",
                        "description": "Construction extended for 5 months",
                        "rationale": "Excavation damaged a watercourse. Construction extended for repairs.",
                        "type": "duration",
                        "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b005",
                        "oldContractPeriod": {
                            "startDate": "2017-07-07T00:00:00Z",
                            "endDate": "2018-07-01T00:00:00Z"
                        },
                        "newContractPeriod": {
                            "startDate": "2017-07-07T00:00:00Z",
                            "endDate": "2018-12-01T00:00:00Z"
                        }
                    },
                    {
                        "id": "m27-4-5-construction-modification-002",
                        "date": "2018-04-01T15:15:00Z",
                        "description": "Construction scope extended to include repairing a watercourse",
                        "rationale": "Excavation damaged a watercourse. Construction scope extended for repairs.",
                        "type": "scope",
                        "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015"
                    },
                    {
                        "id": "m27-4-5-construction-modification-003",
                        "date": "2018-04-01T15:15:00Z",
                        "description": "Contract value increased from 29000000 to 35250000 to include repairing a watercourse",
                        "rationale": "Excavation damaged a watercourse. Construction budget extended for repairs.",
                        "type": "value",
                        "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
                        "oldContractValue": {
                            "amount": 29000000,
                            "currency": "GBP"
                        },
                        "newContractValue": {
                            "amount": 35250000,
                            "currency": "GBP"
                        }
                    }
                ],
                "social": {
                    "laborBudget": {
                        "amount": "150000",
                        "currency": "USD"
                    },
                    "laborObligations": {
                        "obligations": [
                            "minimumWage"
                        ],
                        "description": "The local minimum wage will be paid to all contracted workers."
                    }
                }
            },
            "releases": [
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0011",
                    "date": "2015-09-16T15:12:32Z",
                    "tag": [
                        "tender"
                    ],
                    "url": "https://example.com/Published/releases/5553-b55.json"
                },
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0012",
                    "date": "2015-12-16T15:15:00Z",
                    "tag": [
                        "award"
                    ],
                    "url": "https://example.com/Published/releases/5553-b56.json"
                },
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0013",
                    "date": "2015-12-16T15:15:00Z",
                    "tag": [
                        "contract"
                    ],
                    "url": "https://example.com/Published/releases/5553-b57.json"
                },
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0014",
                    "date": "2015-12-16T15:15:00Z",
                    "tag": [
                        "implementation"
                    ],
                    "url": "https://example.com/Published/releases/5553-b58.json"
                },
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
                    "date": "2018-04-01T15:15:00Z",
                    "tag": [
                        "implementationUpdate"
                    ],
                    "url": "https://example.com/Published/releases/5553-b59.json"
                },
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0016",
                    "date": "2018-12-10T09:15:00Z",
                    "tag": [
                        "contractTermination"
                    ],
                    "url": "https://example.com/Published/releases/5553-b60.json"
                }
            ]
        },
        {
            "id": "ocds-a1b1c1-a410a80d-adc8-11e6-9901-0019b9f3037b",
            "summary": {
                "ocid": "ocds-a1b1c1-a410a80d-adc8-11e6-9901-0019b9f3037b",
                "externalReference": "2016-SMP-M75-J4_J5-design",
                "nature": [
                    "design"
                ],
                "title": "Smart Motorway Design M75 J4-5",
                "description": "Design of Smart Motorway upgrade M75 J4-5",
                "status": "closed",
                "tender": {
                    "procurementMethod": "limited",
                    "datePublished": "2017-01-01T00:00:00Z",
                    "procurementMethodDetails": "Restricted procedure",
                    "costEstimate": {
                        "amount": 2000000,
                        "currency": "GBP"
                    },
                    "numberOfTenderers": 2,
                    "tenderers": [
                        {
                            "name": "A1 Expert Smart Moto Design",
                            "id": "GB-COH-11111111"
                        },
                        {
                            "name": "Motorway Design Services PLC",
                            "id": "GB-COH-12345678"
                        }
                    ],
                    "procuringEntity": {
                        "name": "Motorways UK",
                        "id": "GB-GOR-XX1234"
                    },
                    "administrativeEntity": {
                        "name": "Motorways Administrator UK",
                        "id": "GB-GOR-XX9876"
                    }
                },
                "suppliers": [
                    {
                        "name": "A1 Expert Smart Moto Design",
                        "id": "GB-COH-11111111"
                    }
                ],
                "contractValue": {
                    "amount": 1950000,
                    "currency": "GBP"
                },
                "contractPeriod": {
                    "startDate": "2016-06-01T00:00:00Z",
                    "endDate": "2017-07-07T00:00:00Z"
                },
                "finalValue": {
                    "amount": 1950000,
                    "currency": "GBP"
                },
                "documents": [
                    {
                        "id": "a1b1c1-tender-doc-001",
                        "documentType": "tenderNotice",
                        "title": "M72 improvements at J4-5: Tender Notice",
                        "description": "A tender notice for the design of improvements to M75 J4-5",
                        "url": "https://example.com/Published/a1b1c1-design-001.html",
                        "datePublished": "2015-12-10T16:45:00Z",
                        "format": "text/html",
                        "author": "Motorways UK"
                    }
                ]
            },
            "releases": [
                {
                    "id": "ocds-cdf-pc10008",
                    "date": "2016-04-01T00:00:00Z",
                    "tag": [
                        "tender"
                    ],
                    "url": "https://www.example.com/releases/ocds-cdf-pc10008.json"
                },
                {
                    "id": "ocds-cdf-pc10009",
                    "date": "2016-06-01T15:49:19Z",
                    "tag": [
                        "award"
                    ],
                    "url": "https://www.example.com/releases/ocds-cdf-pc10009.json"
                },
                {
                    "id": "ocds-cdf-pc10010",
                    "date": "2017-08-17T00:00:00Z",
                    "tag": [
                        "implementation",
                        "contractTermination"
                    ],
                    "url": "https://www.example.com/releases/ocds-cdf-pc10010.json"
                }
            ]
        },
        {
            "id": "ocds-a1b1c1-370ad85a-097f-4b8c-adf8-09d840c7c48b",
            "summary": {
                "ocid": "ocds-a1b1c1-370ad85a-097f-4b8c-adf8-09d840c7c48b",
                "externalReference": "2016-SMP-M75-J4_J5-supervision",
                "nature": [
                    "supervision"
                ],
                "title": "Commercial Management and Assurance for the Motorways Upgrade Programme M75 J4-5",
                "description": "Specialist Professional and Technical Services Framework: Commercial Management and Assurance for the Motorways Upgrade Programme M75 J4-5",
                "status": "closed",
                "tender": {
                    "procurementMethod": "limited",
                    "datePublished": "2017-01-01T00:00:00Z",
                    "procurementMethodDetails": "Framework",
                    "costEstimate": {
                        "amount": 5000000,
                        "currency": "GBP"
                    },
                    "numberOfTenderers": 1,
                    "tenderers": [
                        {
                            "name": "Expert Motorway Supervisors",
                            "id": "GB-COH-22222222"
                        }
                    ],
                    "procuringEntity": {
                        "name": "Motorways UK",
                        "id": "GB-GOR-XX1234"
                    },
                    "administrativeEntity": {
                        "name": "Motorways Administrator UK",
                        "id": "GB-GOR-XX9876"
                    }
                },
                "suppliers": [
                    {
                        "name": "Expert Motorway Supervisors",
                        "id": "GB-COH-22222222"
                    }
                ],
                "contractValue": {
                    "amount": 4900000,
                    "currency": "GBP"
                },
                "contractPeriod": {
                    "startDate": "2017-02-24T00:00:00Z",
                    "endDate": "2018-10-10T00:00:00Z"
                },
                "finalValue": {
                    "amount": 4900000,
                    "currency": "GBP"
                },
                "documents": [
                    {
                        "id": "a1b1c1-spats-2-033-completion",
                        "documentType": "completionCertificate",
                        "title": "Completion Certificate for supervision",
                        "description": "A completion certificate for Expert Motorway Supervisors supervision of M75 J4-5",
                        "url": "https://example.com/Published/a1b1c1-spats-2-033-completion.html",
                        "datePublished": "2018-12-10T16:45:00Z",
                        "format": "text/html"
                    }
                ]
            },
            "releases": [
                {
                    "id": "ocds-a1b1c1-spats-2-033e",
                    "date": "2017-03-02T17:14:37Z",
                    "tag": [
                        "tender"
                    ],
                    "url": "https://example.com/releases/ex-a1b1c1--033e.json"
                },
                {
                    "id": "ocds-a1b1c1-spats-2-033f",
                    "date": "2017-05-02T17:14:37Z",
                    "tag": [
                        "award"
                    ],
                    "url": "https://example.com/releases/ex-a1b1c1--033f.json"
                },
                {
                    "id": "ocds-a1b1c1-spats-2-033g",
                    "date": "2017-07-02T17:14:37Z",
                    "tag": [
                        "implementation"
                    ],
                    "url": "https://example.com/Published/releases/ex-a1b1c1--033g.json"
                },
                {
                    "id": "ocds-a1b1c1-spats-2-033h",
                    "date": "2018-12-10T14:45:00Z",
                    "tag": [
                        "contractTermination"
                    ],
                    "url": "https://example.com/releases/ex-a1b1c1--033h.json"
                }
            ]
        }
    ],
    "milestones": [
        {
            "id": "1",
            "title": "Grant disbursement",
            "status": "met",
            "dueDate": "2016-01-01T00:00:00Z",
            "dateMet": "2016-01-01T00:00:00Z",
            "type": "payment",
            "value": {
                "amount": 5000000,
                "currency": "GBP"
            }
        }
    ],
    "transactions": [
        {
            "id": "1",
            "date": "2016-01-01T00:00:00Z",
            "value": {
                "amount": 5000000,
                "currency": "GBP"
            },
            "payer": {
                "id": "1",
                "name": "United Nations Development Programme"
            },
            "payee": {
                "id": "GB-GOR-XX1234",
                "name": "Motorways UK"
            },
            "relatedImplementationMilestone": {
                "id": "1",
                "title": "Grant disbursement"
            }
        }
    ],
    "completion": {
        "endDate": "2018-12-10T00:00:00Z",
        "endDateDetails": "Construction was delayed due to excavation problems when a watercourse was damaged.",
        "finalValue": {
            "amount": 42100000,
            "currency": "GBP"
        },
        "finalValueDetails": "Budget increase due to construction delay.",
        "finalScope": "Upgrade of Junctions 4 and 5 and repairs to the watercourse at Junction 5.",
        "finalScopeDetails": "Scope was expanded to include repairs to a watercourse damaged during construction excavation."
    },
    "lobbyingMeetings": [
        {
            "id": "1",
            "date": "2024-01-01T00:00:00Z",
            "address": {
                "streetAddress": "1600 Amphitheatre Pkwy",
                "locality": "London",
                "region": "London",
                "postalCode": "WC1 8HG",
                "countryName": "United Kingdom"
            },
            "numberOfParticipants": 4,
            "publicOffice": {
                "person": {
                    "name": "Brett Gliddon"
                },
                "organization": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                },
                "jobTitle": "Group General Manager Transport Services"
            }
        }
    ],
    "social": {
        "consultationMeetings": [
            {
                "id": "1",
                "address": {
                    "streetAddress": "1600 Amphitheatre Pkwy",
                    "locality": "London",
                    "region": "London",
                    "postalCode": "WC1 8HG",
                    "countryName": "United Kingdom"
                },
                "date": "2024-01-15T00:00:00Z",
                "numberOfParticipants": "25",
                "publicOffice": {
                    "person": {
                        "name": "Brett Gliddon"
                    },
                    "organization": {
                        "name": "Motorways UK",
                        "id": "GB-GOR-XX1234"
                    },
                    "jobTitle": "Group General Manager Transport Services"
                }
            }
        ],
        "landCompensationBudget": {
            "amount": 10000,
            "currency": "USD"
        },
        "inIndigenousLand": false,
        "healthAndSafety": {
            "materialTests": {
                "test": [
                    "masonry",
                    "metal"
                ],
                "description": "Onsite tests were conducted on the steel frames and masonry according to relevant ASTM International standards."
            }
        }
    },
    "environment": {
        "goals": [
            "climateChangeMitigation"
        ],
        "conservationMeasures": [
            {
                "type": "locationAnalysis",
                "description": "Detailed GIS analysis was undertaken comparing multiple potential locations to select the final project site with the lowest potentially negative ecological impact."
            }
        ],
        "climateOversightTypes": [
            "internal"
        ],
        "hasImpactAssessment": true,
        "impactCategories": [
            {
                "scheme": "ifc-environmental-social",
                "id": "a"
            }
        ],
        "abatementCost": {
            "amount": 12.29,
            "currency": "USD"
        },
        "inProtectedArea": true,
        "climateMeasures": [
            {
                "type": "regenerativeDesign",
                "description": "Regenerative design measures for the project include biomimicry to imitate nature."
            }
        ]
    },
    "policyAlignment": {
        "policies": [
            "infrastructurePlan"
        ],
        "description": "The project is intended to contribute towards the goals set out in the 2021 Australian Infrastructure Plan."
    },
    "benefits": [
        {
            "title": "Environmental",
            "description": "The new water management plant will mean less water is removed from the delta meaning more is left in place for use by the local biome.",
            "beneficiaries": [
                {
                    "description": "Local population of water plant.",
                    "numberOfPeople": 1000,
                    "location": {
                        "id": "1",
                        "address": {
                            "countryName": "United Kingdom"
                        }
                    }
                }
            ]
        }
    ]
}

Sub-schemas

This section lists each sub-schema in the OC4IDS schema. Sub-schemas are parts of the schema that are represented as objects in OC4IDS data. Some sub-schemas are referenced from multiple places in the schema.

ContractingProcess

ContractingProcess is defined as:

Within OC4IDS, a contracting process provides both summary information, and a log of changes over time, either manually curated, or automatically generated through linked OCDS releases.

This sub-schema is referenced by the following properties:

• contractingProcesses

Each ContractingProcess has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Identifier	An identifier for this contracting process. If this contracting process has been assigned an Open Contracting Identifier (OCID) by an external platform (e.g. national procurement system), that OCID must be recorded here. If information about this contracting process has been entered manually, or from a non-OCDS system, then an identifier may be created by the system data is entered into.
summary		object
Summary	Summary information about a contracting process, including a log of changes over time. See ContractingProcessSummary
releases		array[Release]
Linked releases	The information known about a contracting process changes over time, both as new information becomes available, and as changes are made (such as amendments to scope and value). In the OCDS, each new update of information is known as a 'release'. This section provides space to record a link to each available release. See LinkedRelease

Examples

[
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b",
        "summary": {
            "ocid": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b",
            "externalReference": "2016-SMP-M75-J4_J5-construction",
            "nature": [
                "construction"
            ],
            "title": "Smart Motorways Programme - Construction - Package 3 - M75 J8 - 10",
            "description": "Collaborative Delivery Framework (CDF) - Lot 3B - Construction  \u00a310 to  \u00a350m",
            "status": "closed",
            "tender": {
                "procurementMethod": "limited",
                "procurementMethodDetails": "Restricted procedure",
                "datePublished": "2016-04-01T00:00:00Z",
                "costEstimate": {
                    "amount": 33000000,
                    "currency": "GBP"
                },
                "numberOfTenderers": 1,
                "tenderers": [
                    {
                        "name": "Concrete Motorways Construction",
                        "id": "GB-COH-33333333"
                    }
                ],
                "procuringEntity": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                },
                "administrativeEntity": {
                    "name": "Motorways Administrator UK",
                    "id": "GB-GOR-XX9876"
                },
                "sustainability": [
                    {
                        "strategies": [
                            "awardCriteria"
                        ]
                    }
                ]
            },
            "suppliers": [
                {
                    "name": "Concrete Motorways Construction",
                    "id": "GB-COH-33333333"
                }
            ],
            "contractValue": {
                "amount": 29000000,
                "currency": "GBP"
            },
            "contractPeriod": {
                "startDate": "2017-07-07T00:00:00Z",
                "endDate": "2018-07-01T00:00:00Z"
            },
            "finalValue": {
                "amount": 35250000,
                "currency": "GBP"
            },
            "milestones": [
                {
                    "id": "1",
                    "title": "Construction payment",
                    "status": "met",
                    "dueDate": "2017-08-07T00:00:00Z",
                    "dateMet": "2017-08-07T00:00:00Z",
                    "type": "payment",
                    "value": {
                        "amount": 1950000,
                        "currency": "GBP"
                    }
                }
            ],
            "transactions": [
                {
                    "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-00001-1",
                    "source": "https://openspending.org/motorways-uk-spending/",
                    "date": "2017-08-07T00:00:00Z",
                    "value": {
                        "amount": 1950000,
                        "currency": "GBP"
                    },
                    "payer": {
                        "id": "GB-GOR-XX1234",
                        "name": "Motorways UK"
                    },
                    "payee": {
                        "name": "Concrete Motorways Construction",
                        "id": "GB-COH-33333333"
                    },
                    "uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123",
                    "relatedImplementationMilestone": {
                        "id": "1",
                        "title": "Construction payment"
                    }
                }
            ],
            "documents": [
                {
                    "id": "a1b1c1-construction-excavation-report",
                    "documentType": "physicalProgressReport",
                    "title": "Report on construction excavation",
                    "description": "A report on the construction at Junction 5 where excavation damaged a watercourse.",
                    "url": "https://example.com/Published/a1b1c1-construction-monitoring.html",
                    "datePublished": "2018-02-01T00:00:00Z",
                    "dateModified": "2018-02-11T00:00:00Z",
                    "format": "text/html",
                    "language": "en",
                    "accessDetails": "Register for document access.",
                    "author": "Motorways UK"
                },
                {
                    "id": "a1b1c1-construction-completion",
                    "documentType": "completionCertificate",
                    "title": "Completion certificate for construction at M75 J4-5 upgrade",
                    "description": "Completion certificate for the construction upgrading motorway M75 Junctions 4-5.",
                    "url": "https://example.com/Published/a1b1c1-construction-completion.html",
                    "datePublished": "2018-12-10T00:00:00Z",
                    "format": "text/html",
                    "language": "en",
                    "accessDetails": "Register for document access.",
                    "author": "Motorways UK"
                }
            ],
            "modifications": [
                {
                    "id": "m27-4-5-construction-modification-001",
                    "date": "2018-04-01T15:15:00Z",
                    "description": "Construction extended for 5 months",
                    "rationale": "Excavation damaged a watercourse. Construction extended for repairs.",
                    "type": "duration",
                    "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b005",
                    "oldContractPeriod": {
                        "startDate": "2017-07-07T00:00:00Z",
                        "endDate": "2018-07-01T00:00:00Z"
                    },
                    "newContractPeriod": {
                        "startDate": "2017-07-07T00:00:00Z",
                        "endDate": "2018-12-01T00:00:00Z"
                    }
                },
                {
                    "id": "m27-4-5-construction-modification-002",
                    "date": "2018-04-01T15:15:00Z",
                    "description": "Construction scope extended to include repairing a watercourse",
                    "rationale": "Excavation damaged a watercourse. Construction scope extended for repairs.",
                    "type": "scope",
                    "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015"
                },
                {
                    "id": "m27-4-5-construction-modification-003",
                    "date": "2018-04-01T15:15:00Z",
                    "description": "Contract value increased from 29000000 to 35250000 to include repairing a watercourse",
                    "rationale": "Excavation damaged a watercourse. Construction budget extended for repairs.",
                    "type": "value",
                    "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
                    "oldContractValue": {
                        "amount": 29000000,
                        "currency": "GBP"
                    },
                    "newContractValue": {
                        "amount": 35250000,
                        "currency": "GBP"
                    }
                }
            ],
            "social": {
                "laborBudget": {
                    "amount": "150000",
                    "currency": "USD"
                },
                "laborObligations": {
                    "obligations": [
                        "minimumWage"
                    ],
                    "description": "The local minimum wage will be paid to all contracted workers."
                }
            }
        },
        "releases": [
            {
                "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0011",
                "date": "2015-09-16T15:12:32Z",
                "tag": [
                    "tender"
                ],
                "url": "https://example.com/Published/releases/5553-b55.json"
            },
            {
                "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0012",
                "date": "2015-12-16T15:15:00Z",
                "tag": [
                    "award"
                ],
                "url": "https://example.com/Published/releases/5553-b56.json"
            },
            {
                "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0013",
                "date": "2015-12-16T15:15:00Z",
                "tag": [
                    "contract"
                ],
                "url": "https://example.com/Published/releases/5553-b57.json"
            },
            {
                "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0014",
                "date": "2015-12-16T15:15:00Z",
                "tag": [
                    "implementation"
                ],
                "url": "https://example.com/Published/releases/5553-b58.json"
            },
            {
                "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
                "date": "2018-04-01T15:15:00Z",
                "tag": [
                    "implementationUpdate"
                ],
                "url": "https://example.com/Published/releases/5553-b59.json"
            },
            {
                "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0016",
                "date": "2018-12-10T09:15:00Z",
                "tag": [
                    "contractTermination"
                ],
                "url": "https://example.com/Published/releases/5553-b60.json"
            }
        ]
    },
    {
        "id": "ocds-a1b1c1-a410a80d-adc8-11e6-9901-0019b9f3037b",
        "summary": {
            "ocid": "ocds-a1b1c1-a410a80d-adc8-11e6-9901-0019b9f3037b",
            "externalReference": "2016-SMP-M75-J4_J5-design",
            "nature": [
                "design"
            ],
            "title": "Smart Motorway Design M75 J4-5",
            "description": "Design of Smart Motorway upgrade M75 J4-5",
            "status": "closed",
            "tender": {
                "procurementMethod": "limited",
                "datePublished": "2017-01-01T00:00:00Z",
                "procurementMethodDetails": "Restricted procedure",
                "costEstimate": {
                    "amount": 2000000,
                    "currency": "GBP"
                },
                "numberOfTenderers": 2,
                "tenderers": [
                    {
                        "name": "A1 Expert Smart Moto Design",
                        "id": "GB-COH-11111111"
                    },
                    {
                        "name": "Motorway Design Services PLC",
                        "id": "GB-COH-12345678"
                    }
                ],
                "procuringEntity": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                },
                "administrativeEntity": {
                    "name": "Motorways Administrator UK",
                    "id": "GB-GOR-XX9876"
                }
            },
            "suppliers": [
                {
                    "name": "A1 Expert Smart Moto Design",
                    "id": "GB-COH-11111111"
                }
            ],
            "contractValue": {
                "amount": 1950000,
                "currency": "GBP"
            },
            "contractPeriod": {
                "startDate": "2016-06-01T00:00:00Z",
                "endDate": "2017-07-07T00:00:00Z"
            },
            "finalValue": {
                "amount": 1950000,
                "currency": "GBP"
            },
            "documents": [
                {
                    "id": "a1b1c1-tender-doc-001",
                    "documentType": "tenderNotice",
                    "title": "M72 improvements at J4-5: Tender Notice",
                    "description": "A tender notice for the design of improvements to M75 J4-5",
                    "url": "https://example.com/Published/a1b1c1-design-001.html",
                    "datePublished": "2015-12-10T16:45:00Z",
                    "format": "text/html",
                    "author": "Motorways UK"
                }
            ]
        },
        "releases": [
            {
                "id": "ocds-cdf-pc10008",
                "date": "2016-04-01T00:00:00Z",
                "tag": [
                    "tender"
                ],
                "url": "https://www.example.com/releases/ocds-cdf-pc10008.json"
            },
            {
                "id": "ocds-cdf-pc10009",
                "date": "2016-06-01T15:49:19Z",
                "tag": [
                    "award"
                ],
                "url": "https://www.example.com/releases/ocds-cdf-pc10009.json"
            },
            {
                "id": "ocds-cdf-pc10010",
                "date": "2017-08-17T00:00:00Z",
                "tag": [
                    "implementation",
                    "contractTermination"
                ],
                "url": "https://www.example.com/releases/ocds-cdf-pc10010.json"
            }
        ]
    },
    {
        "id": "ocds-a1b1c1-370ad85a-097f-4b8c-adf8-09d840c7c48b",
        "summary": {
            "ocid": "ocds-a1b1c1-370ad85a-097f-4b8c-adf8-09d840c7c48b",
            "externalReference": "2016-SMP-M75-J4_J5-supervision",
            "nature": [
                "supervision"
            ],
            "title": "Commercial Management and Assurance for the Motorways Upgrade Programme M75 J4-5",
            "description": "Specialist Professional and Technical Services Framework: Commercial Management and Assurance for the Motorways Upgrade Programme M75 J4-5",
            "status": "closed",
            "tender": {
                "procurementMethod": "limited",
                "datePublished": "2017-01-01T00:00:00Z",
                "procurementMethodDetails": "Framework",
                "costEstimate": {
                    "amount": 5000000,
                    "currency": "GBP"
                },
                "numberOfTenderers": 1,
                "tenderers": [
                    {
                        "name": "Expert Motorway Supervisors",
                        "id": "GB-COH-22222222"
                    }
                ],
                "procuringEntity": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                },
                "administrativeEntity": {
                    "name": "Motorways Administrator UK",
                    "id": "GB-GOR-XX9876"
                }
            },
            "suppliers": [
                {
                    "name": "Expert Motorway Supervisors",
                    "id": "GB-COH-22222222"
                }
            ],
            "contractValue": {
                "amount": 4900000,
                "currency": "GBP"
            },
            "contractPeriod": {
                "startDate": "2017-02-24T00:00:00Z",
                "endDate": "2018-10-10T00:00:00Z"
            },
            "finalValue": {
                "amount": 4900000,
                "currency": "GBP"
            },
            "documents": [
                {
                    "id": "a1b1c1-spats-2-033-completion",
                    "documentType": "completionCertificate",
                    "title": "Completion Certificate for supervision",
                    "description": "A completion certificate for Expert Motorway Supervisors supervision of M75 J4-5",
                    "url": "https://example.com/Published/a1b1c1-spats-2-033-completion.html",
                    "datePublished": "2018-12-10T16:45:00Z",
                    "format": "text/html"
                }
            ]
        },
        "releases": [
            {
                "id": "ocds-a1b1c1-spats-2-033e",
                "date": "2017-03-02T17:14:37Z",
                "tag": [
                    "tender"
                ],
                "url": "https://example.com/releases/ex-a1b1c1--033e.json"
            },
            {
                "id": "ocds-a1b1c1-spats-2-033f",
                "date": "2017-05-02T17:14:37Z",
                "tag": [
                    "award"
                ],
                "url": "https://example.com/releases/ex-a1b1c1--033f.json"
            },
            {
                "id": "ocds-a1b1c1-spats-2-033g",
                "date": "2017-07-02T17:14:37Z",
                "tag": [
                    "implementation"
                ],
                "url": "https://example.com/Published/releases/ex-a1b1c1--033g.json"
            },
            {
                "id": "ocds-a1b1c1-spats-2-033h",
                "date": "2018-12-10T14:45:00Z",
                "tag": [
                    "contractTermination"
                ],
                "url": "https://example.com/releases/ex-a1b1c1--033h.json"
            }
        ]
    }
]

ContractingProcessSummary

ContractingProcessSummary is defined as:

Summary information about a contracting process and any modifications to it.

Summary information can be manually entered and the modifications list can be used to manually record a log of changes, with the date and details of each modification.

Where OCDS data is available, most summary fields can be derived from OCDS releases, although the exact method to derive data might vary between implementations; and modifications can be identified by comparing a new release to previous releases to check for relevant changes, with the release identifier recorded in modifications.

This sub-schema is referenced by the following properties:

• ContractingProcess/summary

Each ContractingProcessSummary has the following fields:

Schema

Title	Description	Type	Format	Required
ocid		string
Open Contracting Identifier	If this contracting process has been assigned an Open Contracting Identifier (OCID) by an external platform (e.g. national procurement system), that OCID must be recorded here. Otherwise this field should be omitted.
externalReference		string
External reference	If this contracting process is identified by some external reference number it may be recorded here.
nature		array[[string]]
Nature	Whether this contracting process relates to the design, construction and/or supervision of the project, from the contractNature codelist. More than one value may be provided if the contract is for both design and construction, or both design and supervision, etc.
title		string
Title	The formal name of this contracting process. Once set, this should not normally by changed.
description		string
Description	The description should summarize the purpose of this contract and the initial scope of the work to be carried out under the contract.
status		string
Status	The status of this contracting process. Drawn from the contractingProcessStatus codelist.
tender		object
Tender	The activities undertaken in order to enter into a contract.
tender/procurementMethod		string
Procurement method	Specify tendering method using the method codelist (open, selective, limited, direct).
tender/procurementMethodDetails		string
Procurement method details	Additional detail on the procurement method used. This field should be used to record an agreed list of procurement process types, such as: International Competitive Bidding, National Competitive Bidding, Donor Procurement Rules, Framework or Direct Award.
tender/datePublished		[string]	date-time
Date published	The date on which the tender was published.
tender/costEstimate		object
Cost estimate	The pre-tender estimated value of the contracting process. See Value
tender/costEstimate/amount		[number]
Amount	Amount as a number.
tender/costEstimate/currency		[string]
Currency	The currency of the amount, from the closed currency codelist.
tender/numberOfTenderers		number
Number of tenderers	The number of parties who placed a bid during this contracting process.
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 in a linked OCDS release. See OrganizationReference
tender/tenderers/0/name		[string]
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
Organization ID	The id of the party being referenced. This must match the id of an entry in the parties section.
tender/procuringEntity		object
Procuring entity	The name and identifier of the procuring entity responsible for this contracting process. The full details of the entity should be added to the project-level parties array with a role of 'procuringEntity'. See OrganizationReference
tender/procuringEntity/name		[string]
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
Organization ID	The id of the party being referenced. This must match the id of an entry in the parties section.
tender/administrativeEntity		object
Administrative entity	The name and identifier of the entity responsible for contract administration if this is different from the procuring entity. The full details of the entity should be added to the project-level parties array with a role of 'administrativeEntity'. See OrganizationReference
tender/administrativeEntity/name		[string]
Organization name	The name of the party being referenced. This must match the name of an entry in the parties section.
tender/administrativeEntity/id		string
Organization ID	The id of the party being referenced. This must match the id of an entry in the parties section.
tender/sustainability		array[Sustainability]
Sustainability	Information about how the contracting process incorporates sustainable public procurement. See Sustainability
tender/sustainability/0/strategies		array[string]
Strategies	The strategies used to pursue the sustainability goal(s), using the open sustainabilityStrategy codelist.
suppliers		array[Organization reference]
Suppliers	The name and identifier for each supplier for this contracting process. The full details of each supplier should be added to the project-level parties array with a role of 'supplier'. See OrganizationReference
contractValue		object
Contract value	The initial value of the contract. Changes to the initial value of the contract should be recorded in modifications. See Value
contractPeriod		object
Contract period	The initial duration of the contract. Changes to the initial duration of the contract should be recorded in modifications. See Period
finalValue		object
Final value	This should be provided when the contracting process is complete. This can be derived from the sum of contract.implementation.transactions values in linked OCDS data where available. In other cases, it might need to be identified and entered manually based on other project documentation. See Value
documents		array[Document]
Documents	Additional documentation about this contracting process may be provided here, including reports and evaluations produced through a monitoring process, or links to web pages where further information about this process can be found. Where OCDS releases are published, further documents can be found by looking at the published releases. See Document
modifications		array[Modification]
Modifications	Details of changes to the duration, price, scope or other significant features of the contracting process should be logged here. See Modification
transactions		array[Transaction information]
Transactions	The spending transactions made against this contracting process. See Transaction
milestones		array[Milestone]
Milestones	Milestones associated with this contracting process. See Milestone
finance		array[Financing arrangement]
Finance	Information about financing arrangements for the contracting process. See Finance
social		object
Social	Information about the social impact of the project and actions the project will take to mitigate potentially negative impacts on adjacent populations and project workers.
social/laborBudget		object
Labor budget	The budget allocated in the contract for labor costs. See Value
social/laborBudget/amount		[number]
Amount	Amount as a number.
social/laborBudget/currency		[string]
Currency	The currency of the amount, from the closed currency codelist.
social/laborObligations		object
Labor obligations	Information about labor obligations stipulated in the construction contract(s). See LaborObligations
social/laborObligations/obligations		array[string]
Obligations	The labor obligations stipulated in the construction contract(s), using the open laborObligations codelist.
social/laborObligations/description		string
Description	A short description of the labor obligations.

Examples

{
    "ocid": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b",
    "externalReference": "2016-SMP-M75-J4_J5-construction",
    "nature": [
        "construction"
    ],
    "title": "Smart Motorways Programme - Construction - Package 3 - M75 J8 - 10",
    "description": "Collaborative Delivery Framework (CDF) - Lot 3B - Construction  \u00a310 to  \u00a350m",
    "status": "closed",
    "tender": {
        "procurementMethod": "limited",
        "procurementMethodDetails": "Restricted procedure",
        "datePublished": "2016-04-01T00:00:00Z",
        "costEstimate": {
            "amount": 33000000,
            "currency": "GBP"
        },
        "numberOfTenderers": 1,
        "tenderers": [
            {
                "name": "Concrete Motorways Construction",
                "id": "GB-COH-33333333"
            }
        ],
        "procuringEntity": {
            "name": "Motorways UK",
            "id": "GB-GOR-XX1234"
        },
        "administrativeEntity": {
            "name": "Motorways Administrator UK",
            "id": "GB-GOR-XX9876"
        },
        "sustainability": [
            {
                "strategies": [
                    "awardCriteria"
                ]
            }
        ]
    },
    "suppliers": [
        {
            "name": "Concrete Motorways Construction",
            "id": "GB-COH-33333333"
        }
    ],
    "contractValue": {
        "amount": 29000000,
        "currency": "GBP"
    },
    "contractPeriod": {
        "startDate": "2017-07-07T00:00:00Z",
        "endDate": "2018-07-01T00:00:00Z"
    },
    "finalValue": {
        "amount": 35250000,
        "currency": "GBP"
    },
    "milestones": [
        {
            "id": "1",
            "title": "Construction payment",
            "status": "met",
            "dueDate": "2017-08-07T00:00:00Z",
            "dateMet": "2017-08-07T00:00:00Z",
            "type": "payment",
            "value": {
                "amount": 1950000,
                "currency": "GBP"
            }
        }
    ],
    "transactions": [
        {
            "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-00001-1",
            "source": "https://openspending.org/motorways-uk-spending/",
            "date": "2017-08-07T00:00:00Z",
            "value": {
                "amount": 1950000,
                "currency": "GBP"
            },
            "payer": {
                "id": "GB-GOR-XX1234",
                "name": "Motorways UK"
            },
            "payee": {
                "name": "Concrete Motorways Construction",
                "id": "GB-COH-33333333"
            },
            "uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123",
            "relatedImplementationMilestone": {
                "id": "1",
                "title": "Construction payment"
            }
        }
    ],
    "documents": [
        {
            "id": "a1b1c1-construction-excavation-report",
            "documentType": "physicalProgressReport",
            "title": "Report on construction excavation",
            "description": "A report on the construction at Junction 5 where excavation damaged a watercourse.",
            "url": "https://example.com/Published/a1b1c1-construction-monitoring.html",
            "datePublished": "2018-02-01T00:00:00Z",
            "dateModified": "2018-02-11T00:00:00Z",
            "format": "text/html",
            "language": "en",
            "accessDetails": "Register for document access.",
            "author": "Motorways UK"
        },
        {
            "id": "a1b1c1-construction-completion",
            "documentType": "completionCertificate",
            "title": "Completion certificate for construction at M75 J4-5 upgrade",
            "description": "Completion certificate for the construction upgrading motorway M75 Junctions 4-5.",
            "url": "https://example.com/Published/a1b1c1-construction-completion.html",
            "datePublished": "2018-12-10T00:00:00Z",
            "format": "text/html",
            "language": "en",
            "accessDetails": "Register for document access.",
            "author": "Motorways UK"
        }
    ],
    "modifications": [
        {
            "id": "m27-4-5-construction-modification-001",
            "date": "2018-04-01T15:15:00Z",
            "description": "Construction extended for 5 months",
            "rationale": "Excavation damaged a watercourse. Construction extended for repairs.",
            "type": "duration",
            "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b005",
            "oldContractPeriod": {
                "startDate": "2017-07-07T00:00:00Z",
                "endDate": "2018-07-01T00:00:00Z"
            },
            "newContractPeriod": {
                "startDate": "2017-07-07T00:00:00Z",
                "endDate": "2018-12-01T00:00:00Z"
            }
        },
        {
            "id": "m27-4-5-construction-modification-002",
            "date": "2018-04-01T15:15:00Z",
            "description": "Construction scope extended to include repairing a watercourse",
            "rationale": "Excavation damaged a watercourse. Construction scope extended for repairs.",
            "type": "scope",
            "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015"
        },
        {
            "id": "m27-4-5-construction-modification-003",
            "date": "2018-04-01T15:15:00Z",
            "description": "Contract value increased from 29000000 to 35250000 to include repairing a watercourse",
            "rationale": "Excavation damaged a watercourse. Construction budget extended for repairs.",
            "type": "value",
            "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
            "oldContractValue": {
                "amount": 29000000,
                "currency": "GBP"
            },
            "newContractValue": {
                "amount": 35250000,
                "currency": "GBP"
            }
        }
    ],
    "social": {
        "laborBudget": {
            "amount": "150000",
            "currency": "USD"
        },
        "laborObligations": {
            "obligations": [
                "minimumWage"
            ],
            "description": "The local minimum wage will be paid to all contracted workers."
        }
    }
}

LinkedRelease

LinkedRelease is defined as:

A release of data represents the information known or updated at a particular point in time.

This sub-schema is referenced by the following properties:

• ContractingProcess/releases

Each LinkedRelease has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	A unique identifier for this update of information. This should be taken from the OCDS release.id, if available.
tag		array[string]		Required
Release tag	One or more values from the releaseTag codelist used to indicate the information contained in this release, and the stage of the contracting process it represents. This should be filled from the OCDS release.tag, if available.
date		string	date-time	Required
Date	The effective date of this release/update. This should be filled from the OCDS release.date, if available.
url		string	uri	Required
URL	A URL (web link) to a release package containing the OCDS release, if available.

Examples

[
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0011",
        "date": "2015-09-16T15:12:32Z",
        "tag": [
            "tender"
        ],
        "url": "https://example.com/Published/releases/5553-b55.json"
    },
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0012",
        "date": "2015-12-16T15:15:00Z",
        "tag": [
            "award"
        ],
        "url": "https://example.com/Published/releases/5553-b56.json"
    },
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0013",
        "date": "2015-12-16T15:15:00Z",
        "tag": [
            "contract"
        ],
        "url": "https://example.com/Published/releases/5553-b57.json"
    },
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0014",
        "date": "2015-12-16T15:15:00Z",
        "tag": [
            "implementation"
        ],
        "url": "https://example.com/Published/releases/5553-b58.json"
    },
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
        "date": "2018-04-01T15:15:00Z",
        "tag": [
            "implementationUpdate"
        ],
        "url": "https://example.com/Published/releases/5553-b59.json"
    },
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0016",
        "date": "2018-12-10T09:15:00Z",
        "tag": [
            "contractTermination"
        ],
        "url": "https://example.com/Published/releases/5553-b60.json"
    }
]

Modification

Modification is defined as:

Contains a structured description of any changes, along with a free text justification.

This sub-schema is referenced by the following properties:

• ContractingProcessSummary/modifications

Each Modification has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Identifier	A local identifier for this modification.
date		[string]	date-time
Date	The date this modification was recorded.
description		[string]
Description	Details of the modification. This may be free text, or may be generated automatically and provide a structured description of the change.
rationale		[string]
Rationale	A summary of the reasons which have led to this modification to the originally planned scope, period or value.
type		[string]
Type	A value from the modificationType codelist, indicating whether the modification relates to the duration, value, scope or other aspect of the contract.
releaseID		[string]
Release ID	The identifier for the OCDS release this modification relates to. The referenced release should appear in the list of linked releases for this contracting process.
oldContractValue		object
Old contract value	Contract value before the modification, taking into account any prior modifications. See Value
newContractValue		object
New contract value	Contract value after the modification. See Value
oldContractPeriod		object
Old contract period	Contract period before the modification, taking into account any prior modifications. See Period
newContractPeriod		object
New contract period	Contract period after the modification. See Period

Examples

[
    {
        "id": "m27-4-5-construction-modification-001",
        "date": "2018-04-01T15:15:00Z",
        "description": "Construction extended for 5 months",
        "rationale": "Excavation damaged a watercourse. Construction extended for repairs.",
        "type": "duration",
        "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b005",
        "oldContractPeriod": {
            "startDate": "2017-07-07T00:00:00Z",
            "endDate": "2018-07-01T00:00:00Z"
        },
        "newContractPeriod": {
            "startDate": "2017-07-07T00:00:00Z",
            "endDate": "2018-12-01T00:00:00Z"
        }
    },
    {
        "id": "m27-4-5-construction-modification-002",
        "date": "2018-04-01T15:15:00Z",
        "description": "Construction scope extended to include repairing a watercourse",
        "rationale": "Excavation damaged a watercourse. Construction scope extended for repairs.",
        "type": "scope",
        "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015"
    },
    {
        "id": "m27-4-5-construction-modification-003",
        "date": "2018-04-01T15:15:00Z",
        "description": "Contract value increased from 29000000 to 35250000 to include repairing a watercourse",
        "rationale": "Excavation damaged a watercourse. Construction budget extended for repairs.",
        "type": "value",
        "releaseID": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-cdfpc3b0015",
        "oldContractValue": {
            "amount": 29000000,
            "currency": "GBP"
        },
        "newContractValue": {
            "amount": 35250000,
            "currency": "GBP"
        }
    }
]

Period

Dates MUST be expressed using a full ISO 8601 date-time including a timezone. E.g.:

2018-09-18T11:26:04+01:00

Where the source system does not contain time information, a judgment ought to be made as to the relevant time to attach (e.g. start of the day; end of the working day etc.).

Period is defined as:

Key events during a project or contracting process may have a known start date, end date, duration, or maximum extent (the latest date the period can extend to). In some cases, not all of these fields will have known or relevant values.

This sub-schema is referenced by the following properties:

• period

• assetLifetime

• identificationPeriod

• preparationPeriod

• implementationPeriod

• completionPeriod

• maintenancePeriod

• decommissioningPeriod

• ContractingProcessSummary/contractPeriod

• Modification/oldContractPeriod

• Modification/newContractPeriod

• BudgetBreakdown/period

• Observation/period

• Finance/period

• Finance/paymentPeriod

Each Period has the following fields:

Schema

Title	Description	Type	Format	Required
startDate		[string]	date-time
Start date	The start date for the period. When known, a precise start date must be provided.
endDate		[string]	date-time
End date	The end date for the period. When known, a precise end date must be provided.
maxExtentDate		[string]	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.
durationInDays		[integer]
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.

Examples

{
    "startDate": "2016-01-01T00:00:00Z",
    "endDate": "2016-12-31T00:00:00Z"
}

{
    "startDate": "2024-01-01T00:00:00Z",
    "endDate": "2043-12-31T00:00:00Z"
}

{
    "startDate": "2029-01-01T00:00:00Z",
    "endDate": "2043-12-31T00:00:00Z"
}

{
    "startDate": "2016-01-01T00:00:00Z",
    "endDate": "2018-12-10T00:00:00Z",
    "durationInDays": 1074
}

{
    "startDate": "2018-07-01T00:00:00Z",
    "endDate": "2040-07-01T00:00:00Z",
    "durationInDays": 8027
}

{
    "startDate": "2016-01-01T00:00:00Z",
    "endDate": "2016-06-30T00:00:00Z"
}

{
    "startDate": "2016-07-01T00:00:00Z",
    "endDate": "2016-12-31T00:00:00Z"
}

{
    "startDate": "2017-01-01T00:00:00Z",
    "endDate": "2017-06-30T00:00:00Z"
}

{
    "startDate": "2017-07-01T00:00:00Z",
    "endDate": "2017-12-31T00:00:00Z"
}

{
    "startDate": "2018-01-01T00:00:00Z",
    "endDate": "2040-07-01T00:00:00Z"
}

{
    "startDate": "2040-07-01T00:00:00Z",
    "endDate": "2041-06-30T00:00:00Z"
}

{
    "startDate": "2018-01-07T00:00:00Z",
    "endDate": "2018-01-07T00:00:00Z"
}

{
    "startDate": "2018-01-07T00:00:00Z",
    "endDate": "2018-01-07T00:00:00Z"
}

{
    "startDate": "2017-07-07T00:00:00Z",
    "endDate": "2018-07-01T00:00:00Z"
}

{
    "startDate": "2017-07-07T00:00:00Z",
    "endDate": "2018-07-01T00:00:00Z"
}

{
    "startDate": "2017-07-07T00:00:00Z",
    "endDate": "2018-12-01T00:00:00Z"
}

Classification

Classification is defined as:

A classification consists of at least two parts: an identifier for the list (scheme) from which the classification is taken, and an identifier for the category from that list being applied. It is useful to also publish a text label and/or URI that users can draw on to interpret the classification.

This sub-schema is referenced by the following properties:

• additionalClassifications

• environment/impactCategories

• Organization/classifications

• Cost/classification

Each Classification has the following fields:

Schema

Title	Description	Type	Format	Required
scheme		[string]
Scheme	The scheme or codelist from which the classification code is taken, using the open classificationScheme codelist.
id		string
ID	The classification code taken from the scheme.
description		[string]
Description	A textual description or title for the classification code.
uri		[string]	uri
URI	A URI to uniquely identify the classification code.

Examples

[
    {
        "scheme": "COFOG",
        "id": "04.5.1",
        "description": "Road transport (CS)"
    }
]

[
    {
        "id": "national",
        "scheme": "costIdsAdministrativeLevel"
    }
]

{
    "id": "4.02",
    "scheme": "icms",
    "description": "Decommissioning and decontamination"
}

[
    {
        "scheme": "ifc-environmental-social",
        "id": "a"
    }
]

Location

Location is defined as:

The location where activity related to this project will be delivered, or will take place. A location may be described using a geometry (point location, line or polygon), a gazetteer entry, an address, or a combination of these.

This sub-schema is referenced by the following properties:

• locations

• Beneficiary/location

Each Location has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Identifier	A local identifier for this location, unique within the array this location appears in.
description		[string]
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.
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.
geometry/type		[string]
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].
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.
gazetteer		object
Gazetteer	Identifiers from a gazetteer (a geographical index or directory) for the location.
gazetteer/scheme		[string]
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.
gazetteer/identifiers		array[[string]]
Identifiers	An array of one or more codes drawn from the gazetteer indicated by the scheme field.
uri		[string]
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.
address		object
Address	A physical address where works will take place. See Address

Examples

[
    {
        "id": "001",
        "description": "M75 J4 Patcham Interchange",
        "geometry": {
            "type": "Point",
            "coordinates": [
                52.2571843,
                -0.1163333
            ]
        },
        "gazetteer": {
            "scheme": "GEONAMES",
            "identifiers": [
                "2657507"
            ]
        },
        "address": {
            "streetAddress": "Patcham Interchange, New Road",
            "locality": "Patcham",
            "region": "Westshire",
            "postalCode": "WS20 5TV",
            "countryName": "United Kingdom"
        },
        "uri": "https://www.openstreetmap.org/node/202995"
    },
    {
        "id": "002",
        "description": "M75 J5 Windlesham interchange",
        "geometry": {
            "type": "Point",
            "coordinates": [
                52.1373584,
                -0.1198955
            ]
        },
        "gazetteer": {
            "scheme": "OSMN",
            "identifiers": [
                "https://www.openstreetmap.org/node/26571091"
            ]
        },
        "address": {
            "streetAddress": "Windlesham Interchange, Old Road",
            "locality": "Windlesham",
            "region": "Westshire",
            "postalCode": "WS21 6RZ",
            "countryName": "United Kingdom"
        },
        "uri": "https://www.openstreetmap.org/node/1638915385"
    }
]

{
    "id": "1",
    "address": {
        "countryName": "United Kingdom"
    }
}

Value

Value is defined as:

Financial values should be published with a currency attached.

This sub-schema is referenced by the following properties:

• budget/amount

• completion/finalValue

• environment/abatementCost

• ContractingProcessSummary/tender/costEstimate

• ContractingProcessSummary/contractValue

• ContractingProcessSummary/finalValue

• ContractingProcessSummary/social/laborBudget

• Modification/oldContractValue

• Modification/newContractValue

• BudgetBreakdown/amount

• Observation/value

• Transaction/value

• Milestone/value

• Finance/value

• CostMeasurement/lifeCycleCosting/value

• Cost/value

• Social/landCompensationBudget

Each Value has the following fields:

Schema

Title	Description	Type	Format	Required
amount		[number]
Amount	Amount as a number.
currency		[string]
Currency	The currency of the amount, from the closed currency codelist.

Examples

{
    "amount": 40000000,
    "currency": "GBP"
}

{
    "amount": 10000000,
    "currency": "GBP"
}

{
    "amount": 50000000,
    "currency": "USD"
}

{
    "amount": 5000000,
    "currency": "GBP"
}

{
    "amount": 42100000,
    "currency": "GBP"
}

{
    "amount": 10000000,
    "currency": "USD"
}

{
    "amount": 50000000,
    "currency": "USD"
}

{
    "amount": 5000000,
    "currency": "GBP"
}

{
    "amount": 33000000,
    "currency": "GBP"
}

{
    "amount": 29000000,
    "currency": "GBP"
}

{
    "amount": 35250000,
    "currency": "GBP"
}

{
    "amount": 29000000,
    "currency": "GBP"
}

{
    "amount": 35250000,
    "currency": "GBP"
}

{
    "amount": 1950000,
    "currency": "GBP"
}

{
    "amount": 1950000,
    "currency": "GBP"
}

{
    "amount": "150000",
    "currency": "USD"
}

{
    "amount": 10000,
    "currency": "USD"
}

{
    "amount": 12.29,
    "currency": "USD"
}

Organization

Organization is defined as:

A party (organization)

This sub-schema is referenced by the following properties:

• parties

Each Organization has the following fields:

Schema

Title	Description	Type	Format	Required
name		[string]
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.
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}).
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
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
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
contactPoint		object
Contact point	Contact details that can be used for this party. See ContactPoint
roles		array[string]
Party roles	The party's role(s) in the project, using the open partyRole codelist.
beneficialOwners		array[Person]
Beneficial owners	The beneficial owners of the organization. See Person
classifications		array[Classification]
Organization classifications	The classifications that categorize the organization. See Classification
people		array[Person]
People	People associated with, representing, or working on behalf of this organization in respect of this project. See Person

Examples

[
    {
        "name": "Motorways UK",
        "id": "GB-GOR-XX1234",
        "identifier": {
            "scheme": "GB-GOR",
            "legalName": "Motorways UK",
            "id": "XX1234",
            "uri": "https://government-organisation.register.gov.uk/records/XX1234"
        },
        "additionalIdentifiers": [
            {
                "scheme": "GB-GOV",
                "legalName": "Motorways UK",
                "id": "ABCDE"
            }
        ],
        "address": {
            "postalCode": "LL55 4NY",
            "countryName": "United Kingdom",
            "streetAddress": "8 Mountain Walk",
            "region": "Westshire",
            "locality": "Patcham"
        },
        "contactPoint": {
            "name": "Motorways Manager",
            "email": "EX12345@motorwaysuk.gov.uk",
            "telephone": "+44 0123 456 7890",
            "faxNumber": "+44 0123 456 7891"
        },
        "roles": [
            "procuringEntity",
            "buyer",
            "publicAuthority",
            "funder",
            "payee"
        ],
        "people": [
            {
                "id": "1",
                "name": "Jane Bloggs",
                "jobTitle": "Chair"
            }
        ],
        "classifications": [
            {
                "id": "national",
                "scheme": "costIdsAdministrativeLevel"
            }
        ]
    },
    {
        "name": "A1 Expert Smart Moto Design",
        "id": "GB-COH-11111111",
        "identifier": {
            "scheme": "GB-COH",
            "id": "11111111",
            "legalName": "A1 Expert Smart Moto Design Ltd",
            "uri": "https://beta.companieshouse.gov.uk/company/11111111"
        },
        "address": {
            "streetAddress": "Farm Grove, Prince Road",
            "locality": "Patcham",
            "region": "Westshire",
            "postalCode": "WS18 5BW",
            "countryName": "United Kingdom"
        },
        "contactPoint": {
            "name": "Kim Designer",
            "email": "kim.designerd@a1expertsmart.com",
            "telephone": "+44 0123 456 7890",
            "url": "https://www.example.com"
        },
        "roles": [
            "supplier",
            "tenderer"
        ]
    },
    {
        "name": "Motorway Design Services PLC",
        "id": "GB-COH-12345678",
        "identifier": {
            "scheme": "GB-COH",
            "id": "12345678",
            "legalName": "Motorway Design Services PLC",
            "uri": "https://beta.companieshouse.gov.uk/company/22222222"
        },
        "address": {
            "streetAddress": "567 High Street",
            "locality": "Mareham",
            "region": "Eastshire",
            "postalCode": "ES22 3TW",
            "countryName": "United Kingdom"
        },
        "roles": [
            "tenderer"
        ]
    },
    {
        "name": "Expert Motorway Supervisors Ltd",
        "id": "GB-COH-22222222",
        "identifier": {
            "scheme": "GB-COH",
            "id": "22222222",
            "legalName": "Expert Motorway Supervisors Ltd",
            "uri": "https://beta.companieshouse.gov.uk/company/22222222"
        },
        "address": {
            "streetAddress": "9 Seaview Road",
            "locality": "London",
            "region": "London",
            "postalCode": "SE1 1EZ",
            "countryName": "United Kingdom"
        },
        "contactPoint": {
            "name": "Supervisor Manager",
            "email": "supervisor.manager@example.com",
            "telephone": "+44 0123 456 7890",
            "faxNumber": "+44 0123 456 7891",
            "url": "https://www.example.com"
        },
        "roles": [
            "supplier",
            "tenderer"
        ]
    },
    {
        "name": "Concrete Motorways Construction",
        "id": "GB-COH-33333333",
        "identifier": {
            "scheme": "GB-COH",
            "id": "33333333",
            "legalName": "Concrete Motorways Construction Ltd",
            "uri": "https://beta.companieshouse.gov.uk/company/33333333"
        },
        "address": {
            "streetAddress": "5 Example Grove",
            "locality": "London",
            "region": "London",
            "postalCode": "SW1A 1AA",
            "countryName": "United Kingdom"
        },
        "contactPoint": {
            "name": "Construction Manager",
            "email": "construction.example@example.com",
            "telephone": "+44 0123 456 7890",
            "faxNumber": "+44 0123 456 7891",
            "url": "https://www.example.com"
        },
        "roles": [
            "supplier",
            "tenderer"
        ],
        "beneficialOwners": [
            {
                "id": "1",
                "name": "Juan Perez",
                "identifier": {
                    "scheme": "PRY-IDCARD",
                    "id": "12345"
                },
                "nationalities": [
                    "PY"
                ],
                "address": {
                    "streetAddress": "Avenida Eusebio Ayala 1347",
                    "locality": "Asunci\u00f3n",
                    "region": "Gran Asunci\u00f3n",
                    "postalCode": "1001",
                    "countryName": "Paraguay"
                },
                "email": "jperez@example.com",
                "faxNumber": "+595210000001",
                "telephone": "+595210000000"
            }
        ]
    },
    {
        "name": "Motorways Administrator UK",
        "id": "GB-GOR-XX9876",
        "identifier": {
            "scheme": "GB-GOR",
            "legalName": "Motorways Administrator UK",
            "id": "XX9876",
            "uri": "https://government-organisation.register.gov.uk/records/XX9876"
        },
        "address": {
            "postalCode": "BN18 9AB",
            "countryName": "United Kingdom",
            "streetAddress": "High Street, Arundel",
            "region": "West Sussex"
        },
        "contactPoint": {
            "name": "Motorways Administrator",
            "email": "EX6789@motorways-administration-uk.gov.uk",
            "telephone": "+44 0678 456 7890",
            "faxNumber": "+44 0678 456 7891"
        },
        "roles": [
            "administrativeEntity"
        ],
        "people": [
            {
                "id": "1",
                "name": "Elstra Lovelace",
                "jobTitle": "Commercial Contract Officer"
            }
        ]
    },
    {
        "id": "1",
        "name": "United Nations Development Programme",
        "roles": [
            "payer",
            "funder"
        ]
    }
]

OrganizationReference

OrganizationReference is defined as:

The id and name of the party being referenced. Used to cross-reference to the parties section

This sub-schema is referenced by the following properties:

• publicAuthority

• ContractingProcessSummary/tender/tenderers

• ContractingProcessSummary/tender/procuringEntity

• ContractingProcessSummary/tender/administrativeEntity

• ContractingProcessSummary/suppliers

• BudgetBreakdown/sourceParty

• Transaction/payer

• Transaction/payee

• Finance/financingParty

• PublicOffice/organization

Each OrganizationReference has the following fields:

Schema

Title	Description	Type	Format	Required
name		[string]
Organization name	The name of the party being referenced. This must match the name of an entry in the parties section.
id		string
Organization ID	The id of the party being referenced. This must match the id of an entry in the parties section.

Examples

{
    "name": "Motorways UK",
    "id": "GB-GOR-XX1234"
}

{
    "name": "Motorways UK",
    "id": "GB-GOR-XX1234"
}

{
    "id": "1",
    "name": "United Nations Development Programme"
}

{
    "id": "1",
    "name": "United Nations Development Programme"
}

{
    "id": "GB-GOR-XX1234",
    "name": "Motorways UK"
}

[
    {
        "name": "Concrete Motorways Construction",
        "id": "GB-COH-33333333"
    }
]

{
    "name": "Motorways UK",
    "id": "GB-GOR-XX1234"
}

{
    "name": "Motorways Administrator UK",
    "id": "GB-GOR-XX9876"
}

[
    {
        "name": "Concrete Motorways Construction",
        "id": "GB-COH-33333333"
    }
]

{
    "id": "GB-GOR-XX1234",
    "name": "Motorways UK"
}

{
    "name": "Concrete Motorways Construction",
    "id": "GB-COH-33333333"
}

{
    "name": "Motorways UK",
    "id": "GB-GOR-XX1234"
}

Address

The address sub-schema re-uses fields from schema.org and vCard. In the event source data cannot be broken down into these parts, data should contain at least a streetAddress and postalCode.

When working with data, users ought to be aware that addresses might not always be broken down using all the fields the schema provides.

Address is defined as:

An address.

This sub-schema is referenced by the following properties:

• Location/address

• Organization/address

• Person/address

• Meeting/address

Each Address has the following fields:

Schema

Title	Description	Type	Format	Required
streetAddress		[string]
Street address	The street address. For example, 1600 Amphitheatre Pkwy.
locality		[string]
Locality	The locality. For example, Mountain View.
region		[string]
Region	The region. For example, CA.
postalCode		[string]
Postal code	The postal code. For example, 94043.
countryName		[string]
Country name	The country name. For example, United States.

Examples

{
    "streetAddress": "Patcham Interchange, New Road",
    "locality": "Patcham",
    "region": "Westshire",
    "postalCode": "WS20 5TV",
    "countryName": "United Kingdom"
}

{
    "postalCode": "LL55 4NY",
    "countryName": "United Kingdom",
    "streetAddress": "8 Mountain Walk",
    "region": "Westshire",
    "locality": "Patcham"
}

{
    "countryName": "United Kingdom"
}

{
    "streetAddress": "1600 Amphitheatre Pkwy",
    "locality": "London",
    "region": "London",
    "postalCode": "WC1 8HG",
    "countryName": "United Kingdom"
}

{
    "streetAddress": "1600 Amphitheatre Pkwy",
    "locality": "London",
    "region": "London",
    "postalCode": "WC1 8HG",
    "countryName": "United Kingdom"
}

ContactPoint

ContactPoint is defined as:

A person, contact point or department to contact in relation to this contracting process.

This sub-schema is referenced by the following properties:

• Organization/contactPoint

Each ContactPoint has the following fields:

Schema

Title	Description	Type	Format	Required
name		[string]
Name	The name of the contact person, department, or contact point, for correspondence relating to this project.
email		[string]
Email	The e-mail address of the contact point/person.
telephone		[string]
Telephone	The telephone number of the contact point/person. This should include the international dialing code.
faxNumber		[string]
Fax number	The fax number of the contact point/person. This should include the international dialing code.
url		[string]	uri
URL	A web address for the contact point/person.

Examples

{
    "name": "Motorways Manager",
    "email": "EX12345@motorwaysuk.gov.uk",
    "telephone": "+44 0123 456 7890",
    "faxNumber": "+44 0123 456 7891"
}

BudgetBreakdowns

BudgetBreakdowns is defined as:

Details of a breakdown of the budget grouped by a common dimension.

This sub-schema is referenced by the following properties:

• budget/budgetBreakdowns

Each BudgetBreakdowns has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	An identifier for the budget breakdown group.
description		string
Description	A short description of the budget breakdown group including the common dimension used to create the breakdown.
budgetBreakdown		array[Detailed budget breakdown]
Budget breakdown	A detailed breakdown of the budget. See BudgetBreakdown

Examples

[
    {
        "id": "1",
        "description": "Breakdown by year of implementation",
        "budgetBreakdown": [
            {
                "id": "2016",
                "description": "2016 budget allocation",
                "amount": {
                    "amount": 10000000,
                    "currency": "GBP"
                },
                "period": {
                    "startDate": "2016-01-01T00:00:00Z",
                    "endDate": "2016-12-31T00:00:00Z"
                },
                "sourceParty": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                }
            },
            {
                "id": "2017",
                "description": "2017 budget allocation",
                "amount": {
                    "amount": 20000000,
                    "currency": "GBP"
                },
                "period": {
                    "startDate": "2017-01-01T00:00:00Z",
                    "endDate": "2017-12-31T00:00:00Z"
                },
                "sourceParty": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                }
            },
            {
                "id": "2018",
                "description": "2018 budget allocation",
                "amount": {
                    "amount": 10000000,
                    "currency": "GBP"
                },
                "period": {
                    "startDate": "2018-01-01T00:00:00Z",
                    "endDate": "2018-12-31T00:00:00Z"
                },
                "sourceParty": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                }
            }
        ]
    }
]

BudgetBreakdown

For more information about this sub-schema, see the OCDS Budget Breakdown extension documentation. BudgetBreakdown can also be extended further to include budget classifications data following the pattern described in the OCDS Budgets and Spend extension.

BudgetBreakdown is defined as:

This section allows a detailed budget breakdown to be expressed, covering multiple budget sources and multiple periods

This sub-schema is referenced by the following properties:

• BudgetBreakdowns/budgetBreakdown

Each BudgetBreakdown has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Identifier	An identifier for this particular budget entry.
description		[string]
Description	A short free text description of this budget entry.
amount		object
Amount	The value of the budget line item. A positive amount means the source organization funds the project. A negative amount means the project pays the source organization. See Value
uri		[string]	uri
Linked budget information	A URI pointing directly to a machine-readable information about this budget entry.
period		object
Budget period	The period covered by this budget entry. See Period
sourceParty		object
Source organization	The organization providing the funds for this budget entry. The corresponding entry in the parties array must have 'sourceParty' in its roles array. See OrganizationReference
approvalDate		string	date-time
Approval date	The date on which this budget entry was approved. Where documentary evidence for this exists, it may be included among the project documents with .documentType set to 'budgetApproval'.

Examples

[
    {
        "id": "2016",
        "description": "2016 budget allocation",
        "amount": {
            "amount": 10000000,
            "currency": "GBP"
        },
        "period": {
            "startDate": "2016-01-01T00:00:00Z",
            "endDate": "2016-12-31T00:00:00Z"
        },
        "sourceParty": {
            "name": "Motorways UK",
            "id": "GB-GOR-XX1234"
        }
    },
    {
        "id": "2017",
        "description": "2017 budget allocation",
        "amount": {
            "amount": 20000000,
            "currency": "GBP"
        },
        "period": {
            "startDate": "2017-01-01T00:00:00Z",
            "endDate": "2017-12-31T00:00:00Z"
        },
        "sourceParty": {
            "name": "Motorways UK",
            "id": "GB-GOR-XX1234"
        }
    },
    {
        "id": "2018",
        "description": "2018 budget allocation",
        "amount": {
            "amount": 10000000,
            "currency": "GBP"
        },
        "period": {
            "startDate": "2018-01-01T00:00:00Z",
            "endDate": "2018-12-31T00:00:00Z"
        },
        "sourceParty": {
            "name": "Motorways UK",
            "id": "GB-GOR-XX1234"
        }
    }
]

Document

Document is defined as:

Links to, or descriptions of, external documents can be attached at various locations within the standard. Documents can be supporting information, formal notices, downloadable forms, or any other kind of resource that ought to be made public as part of full open contracting.

This sub-schema is referenced by the following properties:

• documents

• ContractingProcessSummary/documents

Each Document has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		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.
documentType		[string]
Document type	A classification of the document described, using the open documentType codelist.
title		[string]
Title	The document title.
description		[string]
Description	Where a link to a full document is provided, the description should provide a 1 - 3 paragraph summary of the information the document contains, and the pageStart field should be used to make sure readers can find the correct section of the document containing more information. Where there is no linked document available, the description field may contain all the information required by the current documentType. Line breaks in text (represented in JSON using \n\n) must be respected by systems displaying this information, and systems may also support basic HTML tags (H1-H6, B, I, U, strong, A and optionally IMG) or markdown syntax for formatting.
url		[string]	uri
URL	This should be a direct link to the document or web page where the information described by the current documentType exists.
datePublished		[string]	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.
dateModified		[string]	date-time
Date modified	Date that the document was last modified
format		[string]
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'.
language		[string]
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.
pageStart		[string]
Page start	When the information referenced exists within a large document, indicate the first page on which it can be found. This should refer to the printed page number, not the page number reported by software applications.
pageEnd		[string]
Page end	When the information referenced exists within a large document, indicate the last page on which it can be found. This should refer to the printed page number, not the page number reported by software applications.
accessDetails		[string]
Access details	A description of any special arrangements needed to access this document, for example: registering for access, paying a fee, or visiting a location to inspect the document.
author		[string]
Author	The names of the authors of the document.

Examples

[
    {
        "id": "plan-1234",
        "documentType": "procurementPlan",
        "title": "M75 Junction 4 to 5 Smart Motorway procurement plan.",
        "description": "Procurement plan for the M75 Junction 4 to 5 Smart Motorway covering the full life-cycle of the Smart Motorway junction upgrade.",
        "url": "https://example.com/he/M75-junctions-4-to-5-smart-motorway/results/M75J4-5+procurement+plan.pdf",
        "datePublished": "2016-05-01T00:00:00Z",
        "dateModified": "2016-05-11T00:00:00Z",
        "format": "application/pdf",
        "language": "en",
        "author": "Fred Consulter"
    },
    {
        "id": "environmental-impact-5678-r4",
        "documentType": "environmentalImpact",
        "title": "Environmental Study Report",
        "description": "An Environmental Study Report into the M75 Junction 4 to 5 Smart Motorway Upgrade",
        "url": "http://example.com/roads/road-projects/M75+junctions+4+to+5++smart+motorway/M75+J4-5SM+Environmental+Study+Report.pdf",
        "datePublished": "2016-02-10T00:00:00Z",
        "dateModified": "2016-12-15T00:00:00Z",
        "format": "application/pdf",
        "author": "Jane Environment, Environment Motorway Consultants Ltd."
    },
    {
        "id": "budget-approval-5678",
        "documentType": "budgetApproval",
        "title": "Approval of Budget for M75 J4-5 upgrade",
        "description": "A full budget approval document for the M75 J4-5 upgrade with budgeting for design, build and supervision.",
        "url": "http://example.com/roads/road-projects/M75+unctions+4+to+5+budget+approval.pdf",
        "datePublished": "2015-10-01T00:00:00Z",
        "dateModified": "2018-03-01T00:00:00Z",
        "format": "application/pdf",
        "author": "UK Motorways Budget Agency",
        "pageStart": "55",
        "pageEnd": "60",
        "accessDetails": "Documents can be inspected in the Motoways UK Example Archive or users can register for free to access."
    },
    {
        "id": "feasibility-study-8976",
        "documentType": "feasibilityStudy",
        "title": "Feasibility Study for Smart Motorway project: benefits and costs",
        "description": "A report commissioned by Motorways UK to carry out initial investigations and site visits to esablish the suitability of upgrading the existing motorway junctions M75 J4-5 to Smart Motorways.\n\nThe survey recorded existing motorway infrastructures and concluded that upgrading to Smart Motorways is feasible. \n\nAdditional design issues are noted in the report.",
        "datePublished": "2015-10-10T00:00:00Z",
        "format": "application/pdf",
        "author": "Feasibility Consultants Example Limited",
        "pageStart": "55"
    }
]

[
    {
        "id": "a1b1c1-construction-excavation-report",
        "documentType": "physicalProgressReport",
        "title": "Report on construction excavation",
        "description": "A report on the construction at Junction 5 where excavation damaged a watercourse.",
        "url": "https://example.com/Published/a1b1c1-construction-monitoring.html",
        "datePublished": "2018-02-01T00:00:00Z",
        "dateModified": "2018-02-11T00:00:00Z",
        "format": "text/html",
        "language": "en",
        "accessDetails": "Register for document access.",
        "author": "Motorways UK"
    },
    {
        "id": "a1b1c1-construction-completion",
        "documentType": "completionCertificate",
        "title": "Completion certificate for construction at M75 J4-5 upgrade",
        "description": "Completion certificate for the construction upgrading motorway M75 Junctions 4-5.",
        "url": "https://example.com/Published/a1b1c1-construction-completion.html",
        "datePublished": "2018-12-10T00:00:00Z",
        "format": "text/html",
        "language": "en",
        "accessDetails": "Register for document access.",
        "author": "Motorways UK"
    }
]

Identifier

Use of stable official organization identifiers can help join up data between systems.

Organization identifiers should be constructed by collecting an official company (or government body) registration number for the organization, and then finding the org-id.guide list code for the list this identifier is taken from to use in the scheme field.

For example, if identifying a company in Colombia, look up its identifier in the Unified Commercial and Social Registry and use the list code CO-RUE.

Identifier is defined as:

A unique identifier for a party (organization).

This sub-schema is referenced by the following properties:

• Organization/identifier

• Organization/additionalIdentifiers

• Person/identifier

Each Identifier has the following fields:

Schema

Title	Description	Type	Format	Required
scheme		[string]
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.
id		string
ID	The identifier of the organization in the selected scheme.
legalName		[string]
Legal Name	The legally registered name of the organization.
uri		[string]	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.

Examples

{
    "scheme": "GB-GOR",
    "legalName": "Motorways UK",
    "id": "XX1234",
    "uri": "https://government-organisation.register.gov.uk/records/XX1234"
}

[
    {
        "scheme": "GB-GOV",
        "legalName": "Motorways UK",
        "id": "ABCDE"
    }
]

RelatedProject

RelatedProject is defined as:

A reference to a project related to the same set of infrastructure assets as this project. Generally, related projects either precede or follow on from the current project.

This sub-schema is referenced by the following properties:

• relatedProjects

Each RelatedProject has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Relationship ID	A local identifier for this relationship, unique within this array.
scheme		string
Scheme	The identification scheme used by this cross-reference, using the open relatedProjectScheme codelist.
identifier		string
Identifier	The identifier of the related project. If the scheme is 'oc4ids', this must be an OC4IDS project ID.
relationship		string
Relationship	The type of relationship, using the open relatedProject codelist.
title		string
Related project title	The title of the related project. If referencing an OC4IDS project, this should match the value of the title field of the related project.
uri		string	uri
Related project URI	A URI pointing to a machine-readable document or project package containing the identified related project.

Examples

[
    {
        "id": "1",
        "scheme": "oc4ids",
        "identifier": "oc4ids-bu3kcz-m75-junctions-4-to-5-construction",
        "relationship": "construction",
        "title": "Original construction of M75 J4-5"
    }
]

Metric

Metric is defined as:

Metrics are used to set out forecast and actual metrics targets for a project: for example, planned and actual physical and financial progress over time.

This sub-schema is referenced by the following properties:

• forecasts

• metrics

Each Metric has the following fields:

Schema

Title	Description	Type	Format	Required
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 project, or in other instances may be an arbitrary identifier.
title		[string]
Title	The title of this metric
description		[string]
Description	A short description of the metric. This may include short details of measurement methods.
observations		array[Observation]
Observations	An array of target or actual values for this metric. See Observation

Examples

[
    {
        "id": "physicalProgress",
        "title": "Physical progress",
        "observations": [
            {
                "id": "1",
                "measure": "50",
                "unit": {
                    "name": "percent",
                    "id": "P1",
                    "scheme": "UNCEFACT"
                },
                "period": {
                    "startDate": "2018-01-07T00:00:00Z",
                    "endDate": "2018-01-07T00:00:00Z"
                },
                "value": {}
            },
            {
                "id": "2",
                "measure": "75",
                "unit": {
                    "name": "percent",
                    "id": "P1",
                    "scheme": "UNCEFACT"
                },
                "period": {
                    "startDate": "2018-04-07T00:00:00Z",
                    "endDate": "2018-04-07T00:00:00Z"
                }
            },
            {
                "id": "3",
                "measure": "100",
                "unit": {
                    "name": "percent",
                    "id": "P1",
                    "scheme": "UNCEFACT"
                },
                "period": {
                    "startDate": "2018-07-01T00:00:00Z",
                    "endDate": "2018-07-01T00:00:00Z"
                }
            }
        ]
    }
]

[
    {
        "id": "physicalProgress",
        "title": "Physical progress",
        "observations": [
            {
                "id": "1",
                "measure": "50",
                "unit": {
                    "name": "percent",
                    "id": "P1",
                    "scheme": "UNCEFACT"
                },
                "period": {
                    "startDate": "2018-01-07T00:00:00Z",
                    "endDate": "2018-01-07T00:00:00Z"
                },
                "value": {}
            },
            {
                "id": "2",
                "measure": "75",
                "unit": {
                    "name": "percent",
                    "id": "P1",
                    "scheme": "UNCEFACT"
                },
                "period": {
                    "startDate": "2018-08-07T00:00:00Z",
                    "endDate": "2018-08-07T00:00:00Z"
                }
            },
            {
                "id": "3",
                "measure": "100",
                "unit": {
                    "name": "percent",
                    "id": "P1",
                    "scheme": "UNCEFACT"
                },
                "period": {
                    "startDate": "2018-12-01T00:00:00Z",
                    "endDate": "2018-12-01T00:00:00Z"
                }
            }
        ]
    }
]

Observation

Observation is defined as:

An actual or target observation. Observations should include either a value (for financial metrics) or measure (for other metrics).

This sub-schema is referenced by the following properties:

• Metric/observations

Each Observation has the following fields:

Schema

Title	Description	Type	Format	Required
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.
period		object
Period	The period over which this observation is measured. See Period
value		object
Value	For financial metrics, the value of this forecast, target or actual observation. See Value
measure		[string, number]
Measure	For non-financial metrics, the measure of this forecast, target or actual observation. Measures may be provided as free text or numerical values.
unit		object
Unit	Unit
unit/name		[string]
Unit name	The name of the unit.
unit/scheme		[string]
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.
unit/id		string
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.
unit/uri		[string]	uri
URI	If the scheme used provide a machine-readable URI for this unit of measure, this can be given.
dimensions		object
Dimensions	Any number of dimensions can be recorded within this object. Dimensions names should follow the camelCase conventions of OCDS.
notes		[string]
Notes	Any notes on this observation. This may include clarifying information.

Examples

[
    {
        "id": "1",
        "measure": "50",
        "unit": {
            "name": "percent",
            "id": "P1",
            "scheme": "UNCEFACT"
        },
        "period": {
            "startDate": "2018-01-07T00:00:00Z",
            "endDate": "2018-01-07T00:00:00Z"
        },
        "value": {}
    },
    {
        "id": "2",
        "measure": "75",
        "unit": {
            "name": "percent",
            "id": "P1",
            "scheme": "UNCEFACT"
        },
        "period": {
            "startDate": "2018-04-07T00:00:00Z",
            "endDate": "2018-04-07T00:00:00Z"
        }
    },
    {
        "id": "3",
        "measure": "100",
        "unit": {
            "name": "percent",
            "id": "P1",
            "scheme": "UNCEFACT"
        },
        "period": {
            "startDate": "2018-07-01T00:00:00Z",
            "endDate": "2018-07-01T00:00:00Z"
        }
    }
]

[
    {
        "id": "1",
        "measure": "50",
        "unit": {
            "name": "percent",
            "id": "P1",
            "scheme": "UNCEFACT"
        },
        "period": {
            "startDate": "2018-01-07T00:00:00Z",
            "endDate": "2018-01-07T00:00:00Z"
        },
        "value": {}
    },
    {
        "id": "2",
        "measure": "75",
        "unit": {
            "name": "percent",
            "id": "P1",
            "scheme": "UNCEFACT"
        },
        "period": {
            "startDate": "2018-08-07T00:00:00Z",
            "endDate": "2018-08-07T00:00:00Z"
        }
    },
    {
        "id": "3",
        "measure": "100",
        "unit": {
            "name": "percent",
            "id": "P1",
            "scheme": "UNCEFACT"
        },
        "period": {
            "startDate": "2018-12-01T00:00:00Z",
            "endDate": "2018-12-01T00:00:00Z"
        }
    }
]

Person

Use this object when you need to disclose the details of people associated with, representing or working on behalf of an organization involved in the project.

Person is defined as:

A natural person.

This sub-schema is referenced by the following properties:

• Organization/beneficialOwners

• Organization/people

Each Person has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	A local identifier for the person.
name		[string]
Name	The full name of the person.
identifier		object
Identifier	An official identifier for the person. The scheme should follow the pattern {JURISDICTION}-{TYPE}, where JURISDICTION is a three-letter, uppercase ISO 3166-1 alpha-3 country code, and TYPE is one of "PASSPORT", "TAXID" or "IDCARD". See Identifier
nationalities		array[string]
Nationalities	The nationalities of the person, from the closed country codelist.
address		object
Address	The address of the person. See Address
email		[string]	email
Email	The e-mail address of the person.
faxNumber		[string]
Fax number	The fax number of the person. This must include the international dialing code.
telephone		[string]
Telephone	The telephone number of the person. This must include the international dialing code.
jobTitle		string
Job title	The job title of the person (for example, Financial Manager).

Examples

[
    {
        "id": "1",
        "name": "Jane Bloggs",
        "jobTitle": "Chair"
    }
]

Transaction

A spending transaction related to a contracting process.

Transaction is defined as:

A financial transaction related to a project or contracting process. Draws upon the data models of the Fiscal Data Package and the International Aid Transparency Initiative and should be used to cross-reference to more detailed information held using a Fiscal Data Package, IATI file, or to provide enough information to allow a user to manually or automatically cross-reference with some other published source of transactional data.

This sub-schema is referenced by the following properties:

• transactions

• ContractingProcessSummary/transactions

Each Transaction has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		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.
source		[string]	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.
date		[string]	date-time
Date	The date of the transaction
value		object
Value	The value of the transaction. See Value
payer		object
Payer	An organization reference for the organization from which the funds in this transaction originate. See OrganizationReference
payee		object
Payee	An organization reference for the organization which receives the funds in this transaction. See OrganizationReference
uri		[string]	uri
Linked spending information	A URI pointing directly to a machine-readable record about this spending transaction.
relatedImplementationMilestone		object
Related implementation milestone	A link to the milestone in the implementation section of OCDS to which this transaction relates. See MilestoneReference

Examples

[
    {
        "id": "1",
        "date": "2016-01-01T00:00:00Z",
        "value": {
            "amount": 5000000,
            "currency": "GBP"
        },
        "payer": {
            "id": "1",
            "name": "United Nations Development Programme"
        },
        "payee": {
            "id": "GB-GOR-XX1234",
            "name": "Motorways UK"
        },
        "relatedImplementationMilestone": {
            "id": "1",
            "title": "Grant disbursement"
        }
    }
]

[
    {
        "id": "ocds-a1b1c1-c9b14c18-adc8-11e6-9901-0019b9f3037b-00001-1",
        "source": "https://openspending.org/motorways-uk-spending/",
        "date": "2017-08-07T00:00:00Z",
        "value": {
            "amount": 1950000,
            "currency": "GBP"
        },
        "payer": {
            "id": "GB-GOR-XX1234",
            "name": "Motorways UK"
        },
        "payee": {
            "name": "Concrete Motorways Construction",
            "id": "GB-COH-33333333"
        },
        "uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123",
        "relatedImplementationMilestone": {
            "id": "1",
            "title": "Construction payment"
        }
    }
]

SimpleIdentifier

SimpleIdentifier is defined as:

An unambiguous reference to a resource within a given context.

This sub-schema is referenced by the following properties:

• identifiers

Each SimpleIdentifier has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	The identifier taken from the scheme.
scheme		string
Scheme	The list, register or system from which the identifier is taken.

Examples

[
    {
        "id": "M75/SM/4-5",
        "scheme": "internal"
    }
]

Milestone

Milestone is defined as:

An event in the lifetime of a project or contracting process.

This sub-schema is referenced by the following properties:

• milestones

• ContractingProcessSummary/milestones

Each Milestone has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	A local identifier for this milestone, unique within this block.
title		[string]
Title	Milestone title
type		[string]
Milestone type	The nature of the milestone, using the open milestoneType codelist.
description		[string]
Description	A description of the milestone.
code		[string]
Milestone code	Milestone codes can be used to track specific events that take place for a particular kind of project or 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.
dueDate		[string]	date-time
Due date	The date the milestone is due.
dateMet		[string]	date-time
Date met	The date on which the milestone was met.
dateModified		[string]	date-time
Date modified	The date the milestone was last reviewed or modified and the status was altered or confirmed to still be correct.
status		[string]
Status	The status that was realized on the date provided in dateModified, from the closed milestoneStatus codelist.
value		object
Value	The payment's value, if the milestone represents a planned payment. See Value

Examples

[
    {
        "id": "1",
        "title": "Grant disbursement",
        "status": "met",
        "dueDate": "2016-01-01T00:00:00Z",
        "dateMet": "2016-01-01T00:00:00Z",
        "type": "payment",
        "value": {
            "amount": 5000000,
            "currency": "GBP"
        }
    }
]

[
    {
        "id": "1",
        "title": "Construction payment",
        "status": "met",
        "dueDate": "2017-08-07T00:00:00Z",
        "dateMet": "2017-08-07T00:00:00Z",
        "type": "payment",
        "value": {
            "amount": 1950000,
            "currency": "GBP"
        }
    }
]

MilestoneReference

MilestoneReference is defined as:

A block used to reference a milestone, including the ID and title of the milestone being referenced.

This sub-schema is referenced by the following properties:

• Transaction/relatedImplementationMilestone

Each MilestoneReference has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Milestone ID	The ID of the milestone being referenced, this must match the ID of a milestone in this project or contracting process's .milestones.
title		[string]
Milestone title	The title of the milestone being referenced, this must match the title of a milestone in this project or contracting process's .milestones.

Examples

{
    "id": "1",
    "title": "Grant disbursement"
}

{
    "id": "1",
    "title": "Construction payment"
}

ConservationMeasure

ConservationMeasure is defined as:

A measure adopted by the project to protect and enhance biodiversity.

This sub-schema is referenced by the following properties:

• environment/conservationMeasures

Each ConservationMeasure has the following fields:

Schema

Title	Description	Type	Format	Required
type		string
Type	The type of conservation measure, using the open conservationMeasure codelist.
description		string
Description	A short description of the conservation measure.

Examples

[
    {
        "type": "locationAnalysis",
        "description": "Detailed GIS analysis was undertaken comparing multiple potential locations to select the final project site with the lowest potentially negative ecological impact."
    }
]

Finance

Finance is defined as:

An arrangement between two parties for raising money.

This sub-schema is referenced by the following properties:

• budget/finance

• ContractingProcessSummary/finance

Each Finance has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	An identifier for the financing arrangement.
title		string
Title	A short title for the financing arrangement.
description		string
Description	A short description of the financing arrangement. This may include details of service fees, commitment fees, lender rights, step in arrangements, exchange rate guarantees, and for syndicated loans, details of syndication and any members of the syndicate.
value		object
Value	The total value of the finance. See Value
financingParty		object
Financing organization	The organization providing the financing arrangement. See OrganizationReference
financingPartyType		string
Financing organization type	The type of the financing organization, using the closed financingPartyType codelist.
source		string
Funding source	The source of funds for the financing arrangement. For example, the Green Climate Fund.
assetClass		array[string]
Asset class	The asset classes used in the financing arrangement, using the closed assetClass codelist.
type		string
Type	The type of the financing arrangement, using the closed financingArrangementType codelist.
repaymentPriority		string
Repayment priority	The order in which the debt in the financing arrangement will be repaid in case of default, using the closed debtRepaymentPriority codelist.
concessional		boolean
Concessional	Whether the financing arrangement is provided below market rate in order to accelerate climate or development objectives. Also called soft financing and subsidized funding.
resultsBased		boolean
Results based	Whether payments under the financing arrangement are contingent on the achievement of pre-defined results.
period		object
Finance period	The period covered by the financing arrangement. Also called maturity. See Period
paymentPeriod		object
Payment period	The period over which the borrower in the financing arrangement is obliged to make payments. See Period
paymentFrequency		number
Payment frequency (days)	The average payment frequency (in days) of the financing arrangement. For example, 365 for yearly, 30.4 for monthly, or 1 for daily.
interestRate		object
Interest rate	The interest rate associated with the finance.
interestRate/base		[string, number]
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.
interestRate/margin		[number]
Margin	The variable added to the base to give the Interest amount expressed as a decimal fraction (e.g. 12.5% = 0.125).
interestRate/fixed		[boolean]
Fixed rate	A boolean field. If the interest rate of fixed, set to true. Otherwise, set to false.
interestRate/notes		[string]
Notes	Any explanatory notes concerning the interest rate.
exchangeRateGuarantee		[boolean]
Exchange rate guarantees	Whether there is an associated exchange rate guarantee with the source of finance.
stepInRights		[boolean]
Step in rights	Whether provision of the finance confers any step in rights to the financing organization.
relatedLots		array[string]
Related lot(s)	The identifiers of the lots to which the financing arrangement relates.

Examples

[
    {
        "id": "1",
        "assetClass": "debt",
        "type": "loan",
        "concessional": true,
        "value": {
            "amount": 50000000,
            "currency": "USD"
        },
        "source": "Green Climate Fund",
        "financingParty": {
            "id": "1",
            "name": "United Nations Development Programme"
        },
        "period": {
            "startDate": "2024-01-01T00:00:00Z",
            "endDate": "2043-12-31T00:00:00Z"
        },
        "paymentPeriod": {
            "startDate": "2029-01-01T00:00:00Z",
            "endDate": "2043-12-31T00:00:00Z"
        },
        "interestRate": {
            "margin": 0.0075
        },
        "description": "Annual principal repayment years 11\u201320 (% of initial principal): 6.7%. Service fee (per annum): 0.50%. Commitment fee (per annum): Up to 0.75%."
    }
]

CostMeasurement

CostMeasurement is defined as:

A measurement of costs for a project.

This sub-schema is referenced by the following properties:

• costMeasurements

Each CostMeasurement has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Local identifier	A local identifier for the cost measurement.
date		string	date-time
Date	The date on which the cost measurement was reported.
lifeCycleCosting		object
Life-cycle costing	Information about life-cycle costing for the cost measurement.
lifeCycleCosting/value		object
Life-cycle cost	The life-cycle cost of the project. See Value
lifeCycleCosting/value/amount		[number]
Amount	Amount as a number.
lifeCycleCosting/value/currency		[string]
Currency	The currency of the amount, from the closed currency codelist.
costGroups		array[Cost group]
Cost groups	The cost groups included in the cost measurement. See CostGroup

Examples

[
    {
        "id": "1",
        "date": "2024-05-01T00:00:00Z",
        "lifeCycleCosting": {
            "value": {
                "amount": 10000000,
                "currency": "USD"
            }
        },
        "costGroups": [
            {
                "id": "1",
                "category": "endOfLife",
                "costs": [
                    {
                        "id": "1",
                        "value": {
                            "amount": 50000000,
                            "currency": "USD"
                        },
                        "classification": {
                            "id": "4.02",
                            "scheme": "icms",
                            "description": "Decommissioning and decontamination"
                        }
                    }
                ]
            }
        ]
    }
]

CostGroup

CostGroup is defined as:

A group of costs relating to a project.

This sub-schema is referenced by the following properties:

• CostMeasurement/costGroups

Each CostGroup has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
Local identifier	A local identifier for the cost group.
category		string
Category	The category of costs included in the cost group, using the open costCategory codelist.
costs		array[Cost]
Costs	The costs included in the cost group. See Cost

Examples

[
    {
        "id": "1",
        "category": "endOfLife",
        "costs": [
            {
                "id": "1",
                "value": {
                    "amount": 50000000,
                    "currency": "USD"
                },
                "classification": {
                    "id": "4.02",
                    "scheme": "icms",
                    "description": "Decommissioning and decontamination"
                }
            }
        ]
    }
]

Cost

Cost is defined as:

A cost relating to a project.

This sub-schema is referenced by the following properties:

• CostGroup/costs

Each Cost has the following fields:

Schema

Title	Description	Type	Format	Required
id		string
Local Identifier	A local identifier for the cost.
classification		object
Classification	A classification of the cost. See Classification
value		object
Value	The monetary value of the cost. See Value

Examples

[
    {
        "id": "1",
        "value": {
            "amount": 50000000,
            "currency": "USD"
        },
        "classification": {
            "id": "4.02",
            "scheme": "icms",
            "description": "Decommissioning and decontamination"
        }
    }
]

LaborObligations

LaborObligations is defined as:

Information about labor obligations stipulated in the construction contract(s).

This sub-schema is referenced by the following properties:

• ContractingProcessSummary/social/laborObligations

Each LaborObligations has the following fields:

Schema

Title	Description	Type	Format	Required
obligations		array[string]
Obligations	The labor obligations stipulated in the construction contract(s), using the open laborObligations codelist.
description		string
Description	A short description of the labor obligations.

Examples

{
    "obligations": [
        "minimumWage"
    ],
    "description": "The local minimum wage will be paid to all contracted workers."
}

Benefit

Benefit is defined as:

A benefit or intended benefit of the project.

This sub-schema is referenced by the following properties:

• benefits

Each Benefit has the following fields:

Schema

Title	Description	Type	Format	Required
title		string
Title	A title for the benefit.
description		string
Description	A short description of the benefit.
beneficiaries		array[Beneficiary]
Beneficiaries	Whom the benefit will aid. See Beneficiary

Examples

[
    {
        "title": "Environmental",
        "description": "The new water management plant will mean less water is removed from the delta meaning more is left in place for use by the local biome.",
        "beneficiaries": [
            {
                "description": "Local population of water plant.",
                "numberOfPeople": 1000,
                "location": {
                    "id": "1",
                    "address": {
                        "countryName": "United Kingdom"
                    }
                }
            }
        ]
    }
]

Beneficiary

Beneficiary is defined as:

Information about a beneficiary of the project.

This sub-schema is referenced by the following properties:

• Benefit/beneficiaries

Each Beneficiary has the following fields:

Schema

Title	Description	Type	Format	Required
location		object
Location	The location of the beneficiary. See Location
description		string
Description	A short description of the beneficiary.
numberOfPeople		integer
Number of people	The total size of the beneficiary population.

Examples

[
    {
        "description": "Local population of water plant.",
        "numberOfPeople": 1000,
        "location": {
            "id": "1",
            "address": {
                "countryName": "United Kingdom"
            }
        }
    }
]

Sustainability

Sustainability is defined as:

Information about how the contracting process incorporates sustainable public procurement.

This sub-schema is referenced by the following properties:

• ContractingProcessSummary/tender/sustainability

Each Sustainability has the following fields:

Schema

Title	Description	Type	Format	Required
strategies		array[string]
Strategies	The strategies used to pursue the sustainability goal(s), using the open sustainabilityStrategy codelist.

Examples

[
    {
        "strategies": [
            "awardCriteria"
        ]
    }
]

Meeting

Meeting is defined as:

Information about a meeting.

This sub-schema is referenced by the following properties:

• lobbyingMeetings

• Social/consultationMeetings

Each Meeting has the following fields:

Schema

Title	Description	Type	Format	Required
id		string		Required
ID	The locally unique identifier for the meeting.
date		[string]	date-time
Date	The date of the meeting.
address		object
Address	The address of the meeting. See Address
numberOfParticipants		integer
Number of participants	The number of people in attendance at the meeting.
publicOffice		object
Public office	A position held by a person (or advisor to a person) with decision-making powers, who is elected, appointed or employed within the executive or legislative branches of power at national, sub-national, or supra-national levels; within private bodies performing public functions; and within public international organizations domiciled or operational in the country concerned. See PublicOffice

Examples

[
    {
        "id": "1",
        "address": {
            "streetAddress": "1600 Amphitheatre Pkwy",
            "locality": "London",
            "region": "London",
            "postalCode": "WC1 8HG",
            "countryName": "United Kingdom"
        },
        "date": "2024-01-15T00:00:00Z",
        "numberOfParticipants": "25",
        "publicOffice": {
            "person": {
                "name": "Brett Gliddon"
            },
            "organization": {
                "name": "Motorways UK",
                "id": "GB-GOR-XX1234"
            },
            "jobTitle": "Group General Manager Transport Services"
        }
    }
]

[
    {
        "id": "1",
        "date": "2024-01-01T00:00:00Z",
        "address": {
            "streetAddress": "1600 Amphitheatre Pkwy",
            "locality": "London",
            "region": "London",
            "postalCode": "WC1 8HG",
            "countryName": "United Kingdom"
        },
        "numberOfParticipants": 4,
        "publicOffice": {
            "person": {
                "name": "Brett Gliddon"
            },
            "organization": {
                "name": "Motorways UK",
                "id": "GB-GOR-XX1234"
            },
            "jobTitle": "Group General Manager Transport Services"
        }
    }
]

PublicOffice

PublicOffice is defined as:

A position held by a person (or advisor to a person) with decision-making powers, who is elected, appointed or employed within the executive or legislative branches of power at national, sub-national, or supra-national levels; within private bodies performing public functions; and within public international organizations domiciled or operational in the country concerned.

This sub-schema is referenced by the following properties:

• Meeting/publicOffice

Each PublicOffice has the following fields:

Schema

Title	Description	Type	Format	Required
person		object
Person	The person holding the public office.
person/name		string
Name	The full name of the person.
organization		object
Organization	The organization in which the public office exists. See OrganizationReference
jobTitle		string
Job title	The job title of the person holding the public office.

Examples

{
    "person": {
        "name": "Brett Gliddon"
    },
    "organization": {
        "name": "Motorways UK",
        "id": "GB-GOR-XX1234"
    },
    "jobTitle": "Group General Manager Transport Services"
}

Social

Social is defined as:

Information about the social impacts of the project and the actions the project will take to mitigate potentially negative impacts on adjacent populations and project workers.

This sub-schema is referenced by the following properties:

• social

Each Social has the following fields:

Schema

Title	Description	Type	Format	Required
consultationMeetings		array[Meeting]
Public consultation meetings	Information about public consultation meetings held during the project preparation stage. See Meeting
landCompensationBudget		object
Land compensation budget	The budget allocated for land compensation. See Value
inIndigenousLand		boolean
In indigenous land	Whether the project is located in or cuts through indigenous land.
healthAndSafety		object
Health and safety	Information about health and safety in regards to the construction and ongoing use of the project asset. See HealthAndSafety

Examples

{
    "consultationMeetings": [
        {
            "id": "1",
            "address": {
                "streetAddress": "1600 Amphitheatre Pkwy",
                "locality": "London",
                "region": "London",
                "postalCode": "WC1 8HG",
                "countryName": "United Kingdom"
            },
            "date": "2024-01-15T00:00:00Z",
            "numberOfParticipants": "25",
            "publicOffice": {
                "person": {
                    "name": "Brett Gliddon"
                },
                "organization": {
                    "name": "Motorways UK",
                    "id": "GB-GOR-XX1234"
                },
                "jobTitle": "Group General Manager Transport Services"
            }
        }
    ],
    "landCompensationBudget": {
        "amount": 10000,
        "currency": "USD"
    },
    "inIndigenousLand": false,
    "healthAndSafety": {
        "materialTests": {
            "test": [
                "masonry",
                "metal"
            ],
            "description": "Onsite tests were conducted on the steel frames and masonry according to relevant ASTM International standards."
        }
    }
}

HealthAndSafety

HealthAndSafety is defined as:

Information about health and safety in regards to the construction and ongoing use of the project asset.

This sub-schema is referenced by the following properties:

• Social/healthAndSafety

Each HealthAndSafety has the following fields:

Schema

Title	Description	Type	Format	Required
materialTests		object
Material tests	Information about tests conducted on materials used in the construction of the assets.
materialTests/tests		array[string]
Tests	The construction materials that were tested, using the open constructionMaterial codelist.
materialTests/description		string
Description	A short description of the tests conducted on the construction materials.

Examples

{
    "materialTests": {
        "test": [
            "masonry",
            "metal"
        ],
        "description": "Onsite tests were conducted on the steel frames and masonry according to relevant ASTM International standards."
    }
}

ClimateMeasure

ClimateMeasure is defined as:

A measure adopted by the project to adapt to or mitigate against climate change.

This sub-schema is referenced by the following properties:

• environment/climateMeasures

Each ClimateMeasure has the following fields:

Schema

Title	Description	Type	Format	Required
type		array[string]
Type	The type of climate measure, using the open climateMeasures codelist.
description		string
Description	A short description of the climate measure.

Examples

[
    {
        "type": "regenerativeDesign",
        "description": "Regenerative design measures for the project include biomimicry to imitate nature."
    }
]