Table of contents

Register for GVMS

To move goods over routes that use Goods Vehicle Movement Service (GVMS), the person or business responsible for moving the goods must have a registered account with HMRC.

Before you start

As a software provider, you should share the following guidance with people who use your software, for example hauliers.
This will let them register for a Government Gateway user ID that will allow them to access the Goods Vehicle Movement System using your software.

Prerequisites to registering for the service

Your business needs a Government Gateway user ID and password to register for the Goods Vehicle Movement Service. If your business does not have a user ID that it can use for customs services, you can create one.

Your business will also need a valid GB EORI number.
This needs to be linked to your Government Gateway user ID in one of the following ways:

  • If your business does not already have a GB EORI you will be taken through the steps to get one when registering for GVMS. Your new GB EORI will then be linked to the Government Gateway user ID you used during registration.

  • If your business has a Government Gateway user ID that you use for other customs services such as the Customs Declaration Service (CDS), you must use the same one with GVMS as it will already be linked to your EORI.

  • If your business has a GB EORI but does not use any recent online customs services such as CDS, then you will be asked to enter your EORI and it will be linked to your Government Gateway user ID.

Registering your account to use Goods Vehicle Movement Service

Your business must register online for the Get a Goods Movement Reference service before it can use the GVMS API.

The registration must use the Government Gateway user ID used in the prerequisites listed.

When you register, the service will check if your Government Gateway user ID has a linked GB EORI.

Authority for your software to act on behalf of your users

All endpoints in the Goods Vehicle Movements API are user-restricted. Your users must grant authority for your software to access it by signing in using the Government Gateway user ID that has been registered for the service. The API only supports organisation users.

See the Developer Hub Authorisation documentation for how users grant authority to your software.

Software that acts as an agent for haulage or a Community Systems Provider

Your software may not be able to take each end-user through the Government Gateway authentication flow if it is acting as an agent or CSP for haulage. In this scenario, the software should execute the authentication flow using a Government Gateway account that must be registered to GVMS with the haulage agent or CSP’s own EORI.

This grant is currently configured to last 18 months.

In this configuration the haulier for each GMR created will be considered by HMRC to be the haulage agent or CSP registered with the software.