UK-EN
Home|API|Vehicle Check App|Bulk Vehicle Reports|Consultancy|Pricing|Knowledge Base|Swagger|Blog|Contact Us

Goneaway Check

Powered by Sagacity

This service identifies home movers using the Goneaway Suppression (GAS) file; the most accurate, up-to-date and widely used solution across the UK - using consented datasets from government (e.g. from local authorities), and blue-chip organisations that have a transactional relationship with their customers. 

 

Pay-on-results* pricing allows you to check prior to each contact with the customer, minimising cost whilst achieving the highest levels of accuracy and compliance. 

 

Key features:

 

  • Check based on last known address

  • Returns the new address where available

  • Pay-on-results pricing*

  • From 40p per result

*Pay-on-results mean you only pay for checks where a goneaway record is found.

Pricing

PAYG
90p
Per Use
Business
65p
Per Use
Enterprise
40p
Per Use

Pricing

PlanGBPEURUSD
PAYG (Per Use)90p€1.08$1.26
Business (Per Use)65p78c91c
Enterprise (Per Use)40p48c56c

Documentation

Introduction

This endpoint identify validated movers and goneaways in the UK.

Header

When making calls to our API, include the following header:

x-api-key:your-api-key-here

Example Request

https://api.oneautoapi.com/sagacity/goneaway?full_name=Jane Smith&address_1=1C The High Street&address_2=Example Address Line 2&address_3=Example Address Line 3&address_4=Example Address Line 4&address_5=Example Address Line 5&address_6=Example Address Line 6&address_7=Example Address Line 7&unique_reference=Your reference&date_of_birth=1942-07-07

Example Sandbox Request

https://sandbox.oneautoapi.com/sagacity/goneaway?full_name=Jane Smith&address_1=1C The High Street&address_2=Example Address Line 2&address_3=Example Address Line 3&address_4=Example Address Line 4&address_5=Example Address Line 5&address_6=Example Address Line 6&address_7=Example Address Line 7&unique_reference=Your reference&date_of_birth=1942-07-07

Request Parameters

full_name
mandatory, string, e.g. Jane Smith
The customer's full name
address_1
mandatory, string, e.g. 1C The High Street
The first line of the customer's address
address_2
mandatory, string, e.g. Example Address Line 2
The second line of the person's address
address_3
optional, string, e.g. Example Address Line 3
The third line of the person's address
address_4
optional, string, e.g. Example Address Line 4
The fourth line of the person's address
address_5
optional, string, e.g. Example Address Line 5
The fifth line of the person's address
address_6
optional, string, e.g. Example Address Line 6
The sixth line of the person's address
address_7
optional, string, e.g. Example Address Line 7
The seventh line of the person's address
unique_reference
optional, string, e.g. Your reference
The unique reference number associated to the supplied name and address
date_of_birth
optional, string, e.g. 1942-07-07
The person's date of birth

Sample Response

{
  "success": true,
  "result": {
    "is_goneaway": true,
    "unique_reference": "Your reference",
    "is_forwarding_address_included": true,
    "new_address": {
      "address_1": "1C The High Street",
      "address_2": "Example Village",
      "address_3": " ",
      "address_4": " ",
      "address_5": " ",
      "address_6": "ABERDEEN",
      "address_7": "AB12 3BC"
    },
    "source": "Example Source",
    "move_date": "2020-01-01"
  },
  "error": "If there is an error the message would go here"
}

Response Parameters

success
e.g. true
Whether the api call was successful
is_goneaway
e.g. true
Has the person moved away from this address
unique_reference
e.g. Your reference
The unique reference number associated to the supplied name and address
is_forwarding_address_included
e.g. true
Is there a forwarding address
address_1
e.g. 1C The High Street
The first line of the customer's address
address_2
e.g. Example Village
The second line of the address
address_3
e.g.
The third line of the address
address_4
e.g.
The fourth line of the address
address_5
e.g.
The fifth line of the address
address_6
e.g. ABERDEEN
The sixth line of the address
address_7
e.g. AB12 3BC
The seventh line of the address
source
e.g. Example Source
The source of the data
move_date
e.g. 2020-01-01
The move date
error
e.g. If there is an error the message would go here
Details of what went wrong with the api call

Status Codes

200
success, chargeable
Request has been successfully received and a response has been sent.
202
accepted, non-chargeable
Request has been received and accepted for processing, but the action has not yet been completed.
204
no content, non-chargeable
Request has been successfully received but there is no content to return e.g. if an invalid VRM has been sent.
206
partial content, non-chargeable
Request has been successfully received but limited content is returned e.g. if an invalid VRM has been sent.
400
bad request, non-chargeable
Request was not received e.g. if any required parameters are missing.
403
forbidden, non-chargeable
Request was rejected e.g. if the API key is invalid or the service is not enabled.
429
too many requests, non-chargeable
API key rate limit/quota has been exceeded.
500
internal server error, non-chargeable
We are unable to process the request e.g. if the API is under extremely heavy load.
503
service unavailable, non-chargeable
Service is temporarily unavailable. Contact help@oneautoapi.com

Also Available From Sagacity

Deceased Check

Protect your brand by identifying contacts who have passed away, and ensure your marketing communications are targeted towards active consumers.

Goneaway Check

Goneaway Checks help you identify validated movers and gone aways in the UK - keeping your data clean and accurate.