Amendments

Information about a contracting process will often change over time.

Each time information changes, a new OCDS release should be published.

There are three kinds of changes:

  • New information. For example, when information about the award of a contract is first released.
  • Updates to existing information. For example, to correct errors in earlier releases, or to make minor adjustments to titles, descriptions or date.
  • Amendments. For example, when the value or duration of a contract is changed. The term amendment often has a specific legal meaning for a publisher. Certain changes to a tender, award or contract may only be allowed as part of an amendment.

The nature of a change can be made explicit using:

  • The release tag (tag). For example, for a release with a new contract, use ‘contract’. For an update to the award, use ‘contractUpdate’, and for an amendment to the contract, use ‘contractAmendment’.
  • The amendments building block. This can contain an array of amendment explanations, and clearly identify the releases that contain before and after values.

Worked example

In the example below:

  • A tender is issued for a “Data merge tool” in a release with the tag ‘tender’.
  • This is updated in a release with the tag ‘tenderUpdate’ to provide an expanded description of the item. The publisher did not consider this to be a formal ‘amendment’ to the tender, so did not publish any amendment information.
  • The tender is then formally amended, with an increased value. This is published in a release with the tag ‘tenderAmendment’, and an amendments block under tender.
{
    "uri": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json",
    "publishedDate": "2016-01-01T09:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "http://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "extensions": [],
    "releases": [
        {
            "ocid": "ocds-213czf-000-00002",
            "id": "ocds-213czf-000-00002-01-tender",
            "date": "2016-01-01T09:30:00Z",
            "language": "en",
            "tag": [
                "tender"
            ],
            "initiationType": "tender",
            "parties": [
                {
                    "name": "Open Data Services",
                    "identifier": {
                        "scheme": "GB-COH",
                        "id": "09506232",
                        "legalName": "Open Data Services Co-operative",
                        "uri": "https://opencorporates.com/companies/gb/09506232"
                    },
                    "roles": [
                        "buyer"
                    ],
                    "id": "GB-COH-09506232"
                }
            ],
            "buyer": {
                "id": "GB-COH-09506232",
                "name": "Open Data Services"
            },
            "tender": {
                "id": "ocds-213czf-000-00001-01-tender",
                "title": "Data merging tool",
                "description": "Data merge tool.",
                "status": "active",
                "value": {
                    "amount": 1000,
                    "currency": "USD"
                },
                "procurementMethod": "open",
                "awardCriteria": "bestProposal",
                "submissionMethod": [
                    "electronicSubmission"
                ],
                "tenderPeriod": {
                    "startDate": "2016-01-31T09:00:00Z",
                    "endDate": "2016-02-15T18:00:00Z"
                },
                "awardPeriod": {
                    "startDate": "2016-04-01T00:00:00Z",
                    "endDate": "2016-06-01T23:59:59Z"
                }
            }
        }
    ]
}
{
    "uri": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json",
    "publishedDate": "2016-01-31T09:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "http://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "extensions": [],
    "releases": [
        {
            "ocid": "ocds-213czf-000-00002",
            "id": "ocds-213czf-000-00002-01-tender-update",
            "date": "2016-01-31T09:30:00Z",
            "language": "en",
            "tag": [
                "tenderUpdate"
            ],
            "initiationType": "tender",
            "parties": [
                {
                    "name": "Open Data Services",
                    "identifier": {
                        "scheme": "GB-COH",
                        "id": "09506232",
                        "legalName": "Open Data Services Co-operative",
                        "uri": "https://opencorporates.com/companies/gb/09506232"
                    },
                    "roles": [
                        "buyer"
                    ],
                    "id": "GB-COH-09506232"
                }
            ],
            "buyer": {
                "id": "GB-COH-09506232",
                "name": "Open Data Services"
            },
            "tender": {
                "id": "ocds-213czf-000-00001-01-tender",
                "title": "Data merging tool",
                "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
                "status": "active",
                "value": {
                    "amount": 1000,
                    "currency": "USD"
                },
                "procurementMethod": "open",
                "awardCriteria": "bestProposal",
                "submissionMethod": [
                    "electronicSubmission"
                ],
                "tenderPeriod": {
                    "startDate": "2016-01-31T09:00:00Z",
                    "endDate": "2016-02-15T18:00:00Z"
                },
                "awardPeriod": {
                    "startDate": "2016-04-01T00:00:00Z",
                    "endDate": "2016-06-01T23:59:59Z"
                }
            }
        }
    ]
}
{
    "uri": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json",
    "publishedDate": "2016-02-05T10:30:00Z",
    "publisher": {
        "scheme": "GB-COH",
        "uid": "09506232",
        "name": "Open Data Services Co-operative Limited",
        "uri": "http://standard.open-contracting.org/examples/"
    },
    "license": "http://opendatacommons.org/licenses/pddl/1.0/",
    "publicationPolicy": "https://github.com/open-contracting/sample-data/",
    "version": "1.1",
    "extensions": [],
    "releases": [
        {
            "ocid": "ocds-213czf-000-00002",
            "id": "ocds-213czf-000-00002-01-tender-amendment",
            "date": "2016-02-05T10:30:00Z",
            "language": "en",
            "tag": [
                "tenderAmendment"
            ],
            "initiationType": "tender",
            "parties": [
                {
                    "name": "Open Data Services",
                    "identifier": {
                        "scheme": "GB-COH",
                        "id": "09506232",
                        "legalName": "Open Data Services Co-operative",
                        "uri": "https://opencorporates.com/companies/gb/09506232"
                    },
                    "roles": [
                        "buyer"
                    ],
                    "id": "GB-COH-09506232"
                }
            ],
            "buyer": {
                "id": "GB-COH-09506232",
                "name": "Open Data Services"
            },
            "tender": {
                "id": "ocds-213czf-000-00001-01-tender",
                "title": "Data merging tool",
                "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
                "status": "active",
                "value": {
                    "amount": 2000,
                    "currency": "USD"
                },
                "procurementMethod": "open",
                "awardCriteria": "bestProposal",
                "submissionMethod": [
                    "electronicSubmission"
                ],
                "tenderPeriod": {
                    "startDate": "2016-01-31T09:00:00Z",
                    "endDate": "2016-02-20T18:00:00Z"
                },
                "awardPeriod": {
                    "startDate": "2016-04-01T00:00:00Z",
                    "endDate": "2016-06-01T23:59:59Z"
                },
                "amendments": [
                    {
                        "id": "amendment-1",
                        "date": "2016-02-04T09:30:00Z",
                        "rationale": "Based on feedback from potential bidders, the total budget was increased by \u00a3500, and the deadline extended",
                        "amendsReleaseID": "ocds-213czf-000-00002-01-tender",
                        "releaseID": "ocds-213czf-000-00002-01-tender-amendment"
                    }
                ]
            }
        },
        {
            "ocid": "ocds-213czf-000-00002",
            "id": "ocds-213czf-000-00002-01-tender",
            "date": "2016-01-01T09:30:00Z",
            "language": "en",
            "tag": [
                "tender"
            ],
            "tender": {
                "id": "ocds-213czf-000-00001-01-tender",
                "value": {
                    "amount": 1000,
                    "currency": "USD"
                },
                "tenderPeriod": {
                    "startDate": "2016-01-31T09:00:00Z",
                    "endDate": "2016-02-15T18:00:00Z"
                }
            }
        }
    ]
}
{
    "packages": [
        "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-award1",
        "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-award2",
        "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender",
        "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender-update",
        "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender-amendment",
        "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender"
    ],
    "publishedDate": "2016-03-05T13:02:00Z",
    "publisher": {
        "name": "Open Data Services Co-operative Limited",
        "scheme": "GB-COH",
        "uid": "09506232",
        "uri": "http://standard.open-contracting.org/examples/"
    },
    "records": [
        {
            "compiledRelease": {
                "award": [
                    {
                        "date": "2016-03-01T09:30:00Z",
                        "description": "Supplier 1 has been commissioned to create the merge tool. A separate contract will be awarded to write the documentation",
                        "id": "ocds-213czf-000-00002-award-supplier-one",
                        "status": "active",
                        "title": "Award of contract to create the data merging tool.",
                        "value": {
                            "amount": 750,
                            "currency": "USD"
                        }
                    },
                    {
                        "date": "2016-03-03T09:30:00Z",
                        "description": "Supplier 2 has been commissioned to create the documentation. A separate contract will be awarded to create the tool",
                        "id": "ocds-213czf-000-00002-award-supplier-two",
                        "status": "active",
                        "title": "Award of contract to create the data merging tool.",
                        "value": {
                            "amount": 750,
                            "currency": "USD"
                        }
                    }
                ],
                "buyer": {
                    "id": "GB-COH-09506232",
                    "name": "Open Data Services"
                },
                "date": "2016-03-03T09:30:00Z",
                "id": "ocds-213czf-000-00002-01-award2",
                "initiationType": "tender",
                "language": "en",
                "ocid": "ocds-213czf-000-00002",
                "parties": [
                    {
                        "id": "GB-COH-09506232",
                        "identifier": {
                            "id": "09506232",
                            "legalName": "Open Data Services Co-operative",
                            "scheme": "GB-COH",
                            "uri": "https://opencorporates.com/companies/gb/09506232"
                        },
                        "name": "Open Data Services",
                        "roles": [
                            "buyer"
                        ]
                    }
                ],
                "tag": [
                    "compiled"
                ],
                "tender": {
                    "amendments": [
                        {
                            "amendsReleaseID": "ocds-213czf-000-00002-01-tender",
                            "date": "2016-02-04T09:30:00Z",
                            "id": "amendment-1",
                            "rationale": "Based on feedback from potential bidders, the total budget was increased by \u00a3500, and the deadline extended",
                            "releaseID": "ocds-213czf-000-00002-01-tender-amendment"
                        }
                    ],
                    "awardCriteria": "bestProposal",
                    "awardPeriod": {
                        "endDate": "2016-06-01T23:59:59Z",
                        "startDate": "2016-04-01T00:00:00Z"
                    },
                    "description": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail.",
                    "id": "ocds-213czf-000-00001-01-tender",
                    "procurementMethod": "open",
                    "status": "active",
                    "submissionMethod": [
                        "electronicSubmission"
                    ],
                    "tenderPeriod": {
                        "endDate": "2016-02-20T18:00:00Z",
                        "startDate": "2016-01-31T09:00:00Z"
                    },
                    "title": "Data merging tool",
                    "value": {
                        "amount": 2000,
                        "currency": "USD"
                    }
                }
            },
            "ocid": "ocds-213czf-000-00002",
            "releases": [
                {
                    "date": "2016-03-01T09:30:00Z",
                    "tag": [
                        "award"
                    ],
                    "url": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-award1"
                },
                {
                    "date": "2016-03-03T09:30:00Z",
                    "tag": [
                        "award"
                    ],
                    "url": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-award2"
                },
                {
                    "date": "2016-01-01T09:30:00Z",
                    "tag": [
                        "tender"
                    ],
                    "url": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender"
                },
                {
                    "date": "2016-01-31T09:30:00Z",
                    "tag": [
                        "tenderUpdate"
                    ],
                    "url": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender-update"
                },
                {
                    "date": "2016-02-05T10:30:00Z",
                    "tag": [
                        "tenderAmendment"
                    ],
                    "url": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender-amendment"
                },
                {
                    "date": "2016-01-01T09:30:00Z",
                    "tag": [
                        "tender"
                    ],
                    "url": "http://standard.open-contracting.org/examples/releases/ocds-213czf-000-00001-02-tender.json#ocds-213czf-000-00002-01-tender"
                }
            ],
            "versionedRelease": {
                "tender": {
                    "value": {
                        "amount": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": 1000
                            },
                            {
                                "releaseDate": "2016-02-05T10:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                "releaseTag": [
                                    "tenderAmendment"
                                ],
                                "value": 2000
                            }
                        ],
                        "currency": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "USD"
                            }
                        ]
                    },
                    "amendments": [
                        {
                            "amendsReleaseID": [
                                {
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "ocds-213czf-000-00002-01-tender"
                                }
                            ],
                            "date": [
                                {
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "2016-02-04T09:30:00Z"
                                }
                            ],
                            "id": "amendment-1",
                            "rationale": [
                                {
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "Based on feedback from potential bidders, the total budget was increased by \u00a3500, and the deadline extended"
                                }
                            ],
                            "releaseID": [
                                {
                                    "releaseDate": "2016-02-05T10:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                    "releaseTag": [
                                        "tenderAmendment"
                                    ],
                                    "value": "ocds-213czf-000-00002-01-tender-amendment"
                                }
                            ]
                        }
                    ],
                    "awardCriteria": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "bestProposal"
                        }
                    ],
                    "awardPeriod": {
                        "endDate": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-06-01T23:59:59Z"
                            }
                        ],
                        "startDate": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-04-01T00:00:00Z"
                            }
                        ]
                    },
                    "description": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "Data merge tool."
                        },
                        {
                            "releaseDate": "2016-01-31T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender-update",
                            "releaseTag": [
                                "tenderUpdate"
                            ],
                            "value": "Creation of a data merging tool. The tool should by written in Python. Proposals should be submitted by e-mail."
                        }
                    ],
                    "id": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "ocds-213czf-000-00001-01-tender"
                        }
                    ],
                    "procurementMethod": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "open"
                        }
                    ],
                    "status": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "active"
                        }
                    ],
                    "submissionMethod": [
                        [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "electronicSubmission"
                            }
                        ]
                    ],
                    "tenderPeriod": {
                        "endDate": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-02-15T18:00:00Z"
                            },
                            {
                                "releaseDate": "2016-02-05T10:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender-amendment",
                                "releaseTag": [
                                    "tenderAmendment"
                                ],
                                "value": "2016-02-20T18:00:00Z"
                            }
                        ],
                        "startDate": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "2016-01-31T09:00:00Z"
                            }
                        ]
                    },
                    "title": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "Data merging tool"
                        }
                    ]
                },
                "award": [
                    {
                        "date": [
                            {
                                "releaseDate": "2016-03-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award1",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "2016-03-01T09:30:00Z"
                            }
                        ],
                        "description": [
                            {
                                "releaseDate": "2016-03-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award1",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "Supplier 1 has been commissioned to create the merge tool. A separate contract will be awarded to write the documentation"
                            }
                        ],
                        "id": "ocds-213czf-000-00002-award-supplier-one",
                        "status": [
                            {
                                "releaseDate": "2016-03-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award1",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "active"
                            }
                        ],
                        "title": [
                            {
                                "releaseDate": "2016-03-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award1",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "Award of contract to create the data merging tool."
                            }
                        ],
                        "value": {
                            "amount": [
                                {
                                    "releaseDate": "2016-03-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-award1",
                                    "releaseTag": [
                                        "award"
                                    ],
                                    "value": 750
                                }
                            ],
                            "currency": [
                                {
                                    "releaseDate": "2016-03-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-award1",
                                    "releaseTag": [
                                        "award"
                                    ],
                                    "value": "USD"
                                }
                            ]
                        }
                    },
                    {
                        "date": [
                            {
                                "releaseDate": "2016-03-03T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award2",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "2016-03-03T09:30:00Z"
                            }
                        ],
                        "description": [
                            {
                                "releaseDate": "2016-03-03T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award2",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "Supplier 2 has been commissioned to create the documentation. A separate contract will be awarded to create the tool"
                            }
                        ],
                        "id": "ocds-213czf-000-00002-award-supplier-two",
                        "status": [
                            {
                                "releaseDate": "2016-03-03T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award2",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "active"
                            }
                        ],
                        "title": [
                            {
                                "releaseDate": "2016-03-03T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-award2",
                                "releaseTag": [
                                    "award"
                                ],
                                "value": "Award of contract to create the data merging tool."
                            }
                        ],
                        "value": {
                            "amount": [
                                {
                                    "releaseDate": "2016-03-03T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-award2",
                                    "releaseTag": [
                                        "award"
                                    ],
                                    "value": 750
                                }
                            ],
                            "currency": [
                                {
                                    "releaseDate": "2016-03-03T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-award2",
                                    "releaseTag": [
                                        "award"
                                    ],
                                    "value": "USD"
                                }
                            ]
                        }
                    }
                ],
                "buyer": {
                    "id": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "GB-COH-09506232"
                        }
                    ],
                    "name": [
                        {
                            "releaseDate": "2016-01-01T09:30:00Z",
                            "releaseID": "ocds-213czf-000-00002-01-tender",
                            "releaseTag": [
                                "tender"
                            ],
                            "value": "Open Data Services"
                        }
                    ]
                },
                "initiationType": [
                    {
                        "releaseDate": "2016-01-01T09:30:00Z",
                        "releaseID": "ocds-213czf-000-00002-01-tender",
                        "releaseTag": [
                            "tender"
                        ],
                        "value": "tender"
                    }
                ],
                "language": [
                    {
                        "releaseDate": "2016-01-01T09:30:00Z",
                        "releaseID": "ocds-213czf-000-00002-01-tender",
                        "releaseTag": [
                            "tender"
                        ],
                        "value": "en"
                    }
                ],
                "ocid": "ocds-213czf-000-00002",
                "parties": [
                    {
                        "id": "GB-COH-09506232",
                        "identifier": {
                            "id": [
                                {
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "09506232"
                                }
                            ],
                            "legalName": [
                                {
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "Open Data Services Co-operative"
                                }
                            ],
                            "scheme": [
                                {
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "GB-COH"
                                }
                            ],
                            "uri": [
                                {
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "https://opencorporates.com/companies/gb/09506232"
                                }
                            ]
                        },
                        "name": [
                            {
                                "releaseDate": "2016-01-01T09:30:00Z",
                                "releaseID": "ocds-213czf-000-00002-01-tender",
                                "releaseTag": [
                                    "tender"
                                ],
                                "value": "Open Data Services"
                            }
                        ],
                        "roles": [
                            [
                                {
                                    "releaseDate": "2016-01-01T09:30:00Z",
                                    "releaseID": "ocds-213czf-000-00002-01-tender",
                                    "releaseTag": [
                                        "tender"
                                    ],
                                    "value": "buyer"
                                }
                            ]
                        ]
                    }
                ]
            }
        }
    ],
    "uri": "http://standard.open-contracting.org/examples/records/ocds-213czf-000-00002-merge.json"
}

Note in this example that:

  • The publisher chooses in the tenderAmendment release to repeat a fragment of the original ‘tender’ release, so that the before and after values of the tender can be accessed in the single file. This is not required when a full archive of releases is made accessible, but can be a convenient way of publishers making structured information on the before and after values of a field more accessible to users.
  • In the merged record, the information in the amendments array can be used to lookup information in the versionedRelease section, to see where changes are explained by an amendment rationale.