Table of contents

Customs Declaration Service end-to-end service guide

This guide explains how you can integrate your software with our APIs to complete a customs declaration.

It shows how the APIs fit into various end-to-end user journeys. It is also intended to help software developers, designers, product owners or business analysts understand how your software needs to interact with HMRC systems.


The Customs Declaration Service (CDS) is replacing the Customs Handling of Import and Export Freight (CHIEF) with a modern and flexible system that can handle anticipated future import and export growth.

More information about the Customs Declaration Service.

For imports or exports outside outside of the European Union, there will be differences in the information they need to put in their declarations. This is due to changes to the UK Trade Tariff required by the Union Customs Code.

End-to-end user journeys

These journeys show examples of use.

Note that links in this guide to other CDS APIs (except for Customs Inventory Linking Exports API) will only work when logged in and subscribed.