Record Reference

Whereas there can be multiple releases concerning a given contracting process, there should be a single contracting record for each OCID, providing a summary of all the available data about this particular contracting process.

A record must contain:

  • An OCID
  • An array of releases related to this contracting process - either by providing a URL for where these releases can be found, or embedding a full copy of the release

This allows the record to function as an index of all the releases related to a given contracting process.

Records should contain:

  • compiledRelease - the latest version of all open contracting process fields, represented using the release schema.

Records may optionally contain:

  • versionedRelease - containing the history of the data in the compiledRecord, with all known past values of any field and the release that information came from.

The versioned release format is designed to support analysis of how data has changed between releases, and will often be generated by data users, rather than by publishers.

Package meta-data

Records should be embedded within a record package.

Title Description Type Format Required
uri string uri Required
Package identifier The URI of this package that identifies it uniquely in the world.
version string   Required
OCDS schema version The version of the OCDS schema used in this package, expressed as major.minor For example: 1.0 or 1.1
extensions array[string]    
OCDS extensions An array of OCDS extensions used in this package. Each entry should be a url to the extension.json file for that extension.
publisher object   Required
None Information to uniquely identify the publisher of this package.
publisher/name string   Required
Name The name of the organisation or department responsible for publishing this data.
publisher/scheme [string, null]    
Scheme The scheme that holds the unique identifiers used to identify the item being identified.
publisher/uid [string, null]    
uid The unique ID for this entity under the given ID scheme. Note the use of ‘uid’ rather than ‘id’. See issue #245.
publisher/uri [string, null] uri  
URI A URI to identify the publisher.
license [string, null] uri  
License A link to the license that applies to the data in this datapackage. Open Definition Conformant licenses are strongly recommended. The canonical URI of the license should be used. Documents linked from this file may be under other license conditions.
publicationPolicy [string, null] uri  
Publication policy A link to a document describing the publishers publication policy.
publishedDate string date-time Required
Published date The date that this package was published. If this package is generated ‘on demand’, this date should reflect the date of the last change to the underlying contents of the package.
packages array[string]    
Packages A list of URIs of all the release packages that were used to create this record package.
records array[Record]    
Records

The records for this data package.

See record

See the guidance on package meta-data. In addition, a record package includes:

  • packages - which should provide links to all the release packages used to compile this record.
  • records - one or more contracting process records, containing, at the very least, identifiers for the all the releases that relate to each contracting process.

You can see this in the full example of a record below.

{
    "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"
}

Record structure

Each record package contains an array of one or more records, consisting of the following sections:

  • Releases (required)
  • Compiled Release (optional)
  • Versioning Release (optional)

Release list

The releases that make up a contracting process can be provided in two ways:

  • URLs and meta-data for each release; or
  • Embedded copies of the release;

If providing an array of URLs, it should be possible for a consuming application to look up each URL, retrieve a release package, and locate the release inside it. In order to locate the specific release inside a release package the releaseID of the release should be appended to the package URL using a fragment identifier.

An example releases section is given below.

{
    "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"
                        }
                    ]
                ]
            }
        ]
    }
}

Compiled Release

The compiled release is the latest version of all the data about this contracting process, and has the same schema as a release.

The process for creating a compiled release is described in the guidance on merging.

A compiled release provides a snapshot of the current state of a contracting process, and the contents should follow the release schema.

Versioned Release

A versioned release contains the history of all the data in the compiled release, including which fields have changed, when they were changed, and the release which updated them.

This versioned information is valuable for many use cases relating to contract monitoring. However, it can add substantially to file sizes, and so where publishers do generate this at source, they should consider publishing versioned and non-versioned copies of the records.

Third parties should also be able to use the information in the releases list to fetch source data, compile and verify their own version history for a contract.

An example extract of the versioned information for a tender value is shown below. This makes visible the change in contract value from the planning to the tender stage, whilst currency, which was first encountered in the planning stage stayed unchanged.

{
    "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"
        }
    ]
}