Getting Started

OCDS is an open data standard for publication of structured information on all stages of a contracting process: from planning to implementation.

The publication of OCDS data can enable greater transparency in public contracting, and can support accessible and in-depth analysis of the efficiency, effectiveness, fairness, and integrity of public contracting systems.

OCDS was designed with a focus on public procurement of goods, works and services, but can be extended for use in other contexts. Extensions for Public Private Partnership (PPP) and Extractives concessions are under development.

To get started publishing OCDS data:

When you are done you could be producing data that looks something like the contract release below, which is compatible with a growing range of OCDS aware tools (you will encounter a range of different OCDS release types in the following pages).

[
    {
        "ocid": "ocds-213czf-000-00001",
        "id": "ocds-213czf-000-00001-05-contract",
        "date": "2010-06-10T10:30:00Z",
        "language": "en",
        "tag": [
            "contract"
        ],
        "initiationType": "tender",
        "parties": [
            {
                "identifier": {
                    "scheme": "GB-LAC",
                    "id": "E09000003",
                    "legalName": "London Borough of Barnet",
                    "uri": "http://www.barnet.gov.uk/"
                },
                "name": "London Borough of Barnet",
                "address": {
                    "streetAddress": "4, North London Business Park, Oakleigh Rd S",
                    "locality": "London",
                    "region": "London",
                    "postalCode": "N11 1NP",
                    "countryName": "United Kingdom"
                },
                "contactPoint": {
                    "name": "Procurement Team",
                    "email": "procurement-team@example.com",
                    "telephone": "01234 345 346",
                    "faxNumber": "01234 345 345",
                    "url": "http://example.com/contact/"
                },
                "roles": [
                    "buyer"
                ],
                "id": "GB-LAC-E09000003"
            },
            {
                "identifier": {
                    "scheme": "GB-COH",
                    "id": "00395826",
                    "legalName": "Balfour Beatty plc",
                    "uri": "https://opencorporates.com/companies/gb/01881683"
                },
                "additionalIdentifiers": [
                    {
                        "scheme": "GB-VAT",
                        "id": "217967235"
                    }
                ],
                "name": "Balfour Beatty",
                "address": {
                    "streetAddress": "5 Churchill Place",
                    "locality": "London",
                    "region": "London",
                    "postalCode": "E14 5HU",
                    "countryName": "United Kingdom"
                },
                "contactPoint": {
                    "name": "Contracts Team",
                    "email": "help@balfourbeatty.com",
                    "telephone": "44 (0)20 7216 6800",
                    "faxNumber": "44 (0)20 7216 6800"
                },
                "roles": [
                    "supplier"
                ],
                "id": "GB-COH-00395826"
            }
        ],
        "buyer": {
            "id": "GB-LAC-E09000003",
            "name": "London Borough of Barnet"
        },
        "awards": [
            {
                "id": "ocds-213czf-000-00001-award-01",
                "title": "Award of contract to build new cycle lanes in the centre of town.",
                "description": "Balfour Beatty Plc has been awarded the contract to build new cycle lanes in the centre of town.",
                "status": "active",
                "date": "2010-05-10T09:30:00Z",
                "value": {
                    "amount": 11000000,
                    "currency": "GBP"
                },
                "suppliers": [
                    {
                        "id": "GB-COH-00395826",
                        "name": "Balfour Beatty"
                    }
                ],
                "items": [
                    {
                        "id": "0001",
                        "description": "string",
                        "classification": {
                            "scheme": "CPV",
                            "id": "45233130",
                            "description": "Construction work for highways",
                            "uri": "http://cpv.data.ac.uk/code-45233130"
                        },
                        "additionalClassifications": [
                            {
                                "scheme": "CPV",
                                "id": "45233162-2",
                                "description": "Cycle path construction work",
                                "uri": "http://cpv.data.ac.uk/code-45233162.html"
                            }
                        ],
                        "quantity": 8,
                        "unit": {
                            "name": "Miles",
                            "value": {
                                "amount": 137000,
                                "currency": "GBP"
                            }
                        }
                    }
                ],
                "contractPeriod": {
                    "startDate": "2010-07-01T00:00:00Z",
                    "endDate": "2011-08-01T23:59:00Z"
                },
                "documents": [
                    {
                        "id": "0007",
                        "documentType": "awardNotice",
                        "title": "Award notice",
                        "description": "Award of contract to build new cycle lanes in the centre of town to Balfour Beatty Plc.",
                        "url": "http://example.com/tender-notices/ocds-213czf-000-00001-04.html",
                        "datePublished": "2010-05-10T10:30:00Z",
                        "format": "text/html",
                        "language": "en"
                    }
                ]
            }
        ],
        "contracts": [
            {
                "id": "ocds-213czf-000-00001-contract-01",
                "awardID": "ocds-213czf-000-00001-award-01",
                "title": "Contract to build new cycle lanes in the centre of town.",
                "description": "A contract has been signed between the Council and Balfour Beatty Plc for construction of new cycle lanes in the centre of town.",
                "status": "active",
                "period": {
                    "startDate": "2010-07-01T00:00:00Z",
                    "endDate": "2011-08-01T23:59:00Z"
                },
                "value": {
                    "amount": 11000000,
                    "currency": "GBP"
                },
                "items": [
                    {
                        "id": "0001",
                        "description": "string",
                        "classification": {
                            "scheme": "CPV",
                            "id": "45233130",
                            "description": "Construction work for highways",
                            "uri": "http://cpv.data.ac.uk/code-45233130"
                        },
                        "additionalClassifications": [
                            {
                                "scheme": "CPV",
                                "id": "45233162-2",
                                "description": "Cycle path construction work",
                                "uri": "http://cpv.data.ac.uk/code-45233162.html"
                            }
                        ],
                        "quantity": 8,
                        "unit": {
                            "name": "Miles",
                            "value": {
                                "amount": 137000,
                                "currency": "GBP"
                            }
                        }
                    }
                ],
                "dateSigned": "2015-06-10T14:23:12Z",
                "documents": [
                    {
                        "id": "0008",
                        "documentType": "contractSigned",
                        "title": "Signed Contract",
                        "description": "The Signed Contract for Cycle Path Construction",
                        "url": "http://example.com/contracts/ocds-213czf-000-00001",
                        "datePublished": "2015-06-10T16:43:12Z",
                        "format": "application/pdf",
                        "language": "en"
                    }
                ]
            }
        ]
    }
]