Worked example¶
The OC4IDS schema sets out the structure and format of an OC4IDS JSON file.
This worked example is a filled-in example OC4IDS JSON file representing a fictional, completed infrastructure project to upgrade a motorway in the UK.
The full OC4IDS JSON file for the worked example is available to download.
Tip
You can also download a blank example OC4IDS JSON file as a starting point for your implementation.
This page contains excerpts from the example JSON file, showing how key sections of the schema ought to be populated.
Overview¶
An OC4IDS document is made up of a number of sections. These include:
Project package - a container for the data of multiple projects, as well as metadata about the publication.
Project data - for each project including:
Project metadata - contextual information about the project such as title, description, location and status.
Budget - information about the projected costs or allocated budget for the project.
Parties - information about the organizations and other participants involved in the project.
Documents - documents and documentation relating to the project.
Contracting processes - information about related contracting processes for different aspects of the project.
Completion - information on the final scope, duration and costs for the project.
Sections¶
Project package¶
The project package serves as a container for the data of multiple projects, through its projects array. It also provides metadata concerning all the data it contains, including the publisher, schema version, data license and publication policy.
{
"version": "0.9",
"uri": "https://standard.open-contracting.org/infrastructure/0.9/en/_static/example.json",
"publishedDate": "2018-12-10T15:53:00Z",
"publisher": {
"name": "Open Data Services Co-operative Limited",
"scheme": "GB-COH",
"uid": "9506232",
"uri": "http://data.companieshouse.gov.uk/doc/company/09506232"
},
"license": "http://opendatacommons.org/licenses/pddl/1.0/",
"publicationPolicy": "https://standard.open-contracting.org/1.1/en/implementation/publication_policy/",
"projects": [
{
"id": "oc4ids-bu3kcz-m75-junctions-4-to-5-smart-motorway",
"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
},
"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": {
"amount": {
"amount": 40000000,
"currency": "GBP"
},
"requestDate": "2015-05-30T00:00:00Z",
"approvalDate": "2015-06-24T00:00:00Z",
"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"
}
}
]
},
"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"
},
"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"
],
"people": [
{
"id": "1",
"name": "Jane Bloggs",
"jobTitle": "Chair"
}
]
},
{
"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"
]
},
{
"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"
}
]
}
],
"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"
}
},
{
"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"
}
},
{
"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-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",
"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"
},
"transactions": [
{
"id": "ocds-a1b1c1-a410a80d-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": {
"id": "GB-COH-11111111",
"name": "A1 Expert Smart Moto Design"
},
"uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123"
}
],
"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",
"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"
}
]
},
{
"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",
"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"
}
},
"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"
},
"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"
}
}
]
},
"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"
}
]
}
],
"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."
}
}
]
}
License¶
The license field ought to contain a link to the license that applies to the data in the package. Further information about licensing can be found in the OCDS licensing guidance.
Publication policy¶
The publicationPolicy field ought to contain a link to a data user guide. For more information about what to include in a publication policy, refer to Data user guide.
Project information¶
A project package can contain information about multiple infrastructure projects. Each infrastructure project is represented as an entry in the projects array. The example contains information about one infrastructure project.
{
"projects": [
{
"id": "oc4ids-bu3kcz-m75-junctions-4-to-5-smart-motorway",
"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
},
"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": {
"amount": {
"amount": 40000000,
"currency": "GBP"
},
"requestDate": "2015-05-30T00:00:00Z",
"approvalDate": "2015-06-24T00:00:00Z",
"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"
}
}
]
},
"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"
},
"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"
],
"people": [
{
"id": "1",
"name": "Jane Bloggs",
"jobTitle": "Chair"
}
]
},
{
"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"
]
},
{
"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"
}
]
}
],
"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"
}
},
{
"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"
}
},
{
"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-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",
"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"
},
"transactions": [
{
"id": "ocds-a1b1c1-a410a80d-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": {
"id": "GB-COH-11111111",
"name": "A1 Expert Smart Moto Design"
},
"uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123"
}
],
"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",
"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"
}
]
},
{
"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",
"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"
}
},
"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"
},
"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"
}
}
]
},
"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"
}
]
}
],
"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."
}
}
]
}
Each project object contains the following sections:
Project metadata¶
This section provides contextual information about the infrastructure project, including:
idfor the project identifier. To make the project identifier globally unique, a project identifier prefix needs to be added to a local identifier for the project. Project identifier prefixes are assigned by the OC4IDS Helpdesk. For more information on project identifiers, refer to the project identifiers guidance.statusfrom the Project Status codelist. In this example, the project status is 'completed'.typefrom the Project Type codelist. In this example, the project type is 'expansion'.sectorfrom the Project Sector codelist. In this example, the sector is 'transport.road', the parent sector 'transport' is also included in the sector list, in line with the guidance in the schema.one or more
relatedProjects, to reference other projects that are related to the same set of infrastructure assets, as outlined in the schema reference. In the relatedProject example below, a reference is made to the original project that initially constructed the motorway junctions, which are now being upgraded by this project.one or more
locations, which can be expressed in a variety of ways as outlined in the schema reference. In this example, one location is given: a motorway junction, using a point location, a gazetteer entry and an address.
[
{
"id": "1",
"scheme": "oc4ids",
"identifier": "oc4ids-bu3kcz-m75-junctions-4-to-5-construction",
"relationship": "construction",
"title": "Original construction of M75 J4-5"
}
]
[
{
"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 and budget breakdown¶
The budget section can be used to provide the overall budget for the project, and its budgetBreakdown array can be used to provide a breakdown of the budget by period and/or funding source.
In the budget example below, the overall budget for the infrastructure project covers 3 years and is broken down into amounts per year, with £10,000,000 allocated in 2016 – as highlighted in the budgetBreakdown example.
{
"amount": {
"amount": 40000000,
"currency": "GBP"
},
"requestDate": "2015-05-30T00:00:00Z",
"approvalDate": "2015-06-24T00:00:00Z",
"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"
}
}
]
}
{
"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"
}
}
Parties (organizations)¶
The parties array is used to provide details about organizations involved in the infrastructure project and their roles. Organization references elsewhere in the data refer back to entries in this section.
In the party example below, details are given about the fictional Motorways UK entity, which is referred to from the sourceParty section in the budgetBreakdown example above, using the name and id from the entry in the parties array.
{
"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"
},
"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"
],
"people": [
{
"id": "1",
"name": "Jane Bloggs",
"jobTitle": "Chair"
}
]
}
Public authority¶
The publicAuthority field indicates the project owner: the unit, body or department within a government that is tendering and contracting the project. It refers to an entry in the parties array, as described above.
{
"name": "Motorways UK",
"id": "GB-GOR-XX1234"
}
Documents¶
The documents array is used to provide information and links to documents and documentation relating to the infrastructure project. During different phases of the project, different document types are expected.
In the document example below, an environmental impact assessment is provided. The documentType field is used to categorize the document against the Document Type codelist.
{
"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."
}
Forecasts and metrics¶
Publish structured data on planned and actual physical and financial progress using Metric objects in the forecasts (planned progress) and metrics (actual progress) arrays. Refer to the implementation progress reports documentation for further detail.
In the example below, you can compare the planned forecasts/observations for 75% of physical progress completed with the actual metrics/observations for 75% of physical progress completed (note the difference in period).
{
"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": "2",
"measure": "75",
"unit": {
"name": "percent",
"id": "P1",
"scheme": "UNCEFACT"
},
"period": {
"startDate": "2018-08-07T00:00:00Z",
"endDate": "2018-08-07T00:00:00Z"
}
}
Contracting processes¶
The contractingProcesses array is used to provide information about each contracting process associated with the project, including summary information, a list of modifications and a list of OCDS releases.
In the contractingProcess example below, information is given about a contracting process for the design of the motorway upgrade, with one related document in the documents array (a tender notice) and two related OCDS releases (one for the tender and one for the contract award).
{
"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",
"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"
},
"transactions": [
{
"id": "ocds-a1b1c1-a410a80d-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": {
"id": "GB-COH-11111111",
"name": "A1 Expert Smart Moto Design"
},
"uri": "https://openspending.org/motorways-uk-spending/transaction/xyz123"
}
],
"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"
}
]
}
Modifications¶
Each contracting process includes a modifications array which is used to list any changes to the duration, price, scope or other significant aspect of the contracting process.
In the modification example below, a change in duration is shown, using the oldContractPeriod and newContractPeriod fields.
{
"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"
}
}
Completion¶
The completion section provides final details of the scope, duration and cost for the project.
Since in this example there were variations to related contracting processes, the finalValue of the project exceeds its original planned budget.
{
"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."
}