Oscar Research · Customer Data Access Guide

Choose the simplest way to access your licensed Oscar data

Your subscription includes several ways to consume the latest data from Oscar's live database.

The right method depends on whether you need an on-demand download, a bespoke selection, a changes file, or a live endpoint that can be connected to your own systems.

How should I choose?

Use the Selection Tool when you want a targeted live selection. Use Full Download when you want the latest complete copy. Use Changes Since when you maintain your own copy and only need records that changed. Use the API when you want Oscar data delivered programmatically into another system.

Your access options

Four ways to consume your subscription

01 · SELECTION TOOL

Build and download a live selection

Use the online Oscar selection tool to build specific selections across your subscription by organisation type, job function and region, then download the live results.

Open Selection Tool
02 · FULL DOWNLOAD

Download the latest complete copy

Use Full Download when you want the current complete version of the data in your subscription.

Go to Customer Area
03 · CHANGES SINCE

Download only records that changed

The changes file categorises records as New, Changed or Deleted since your last full download.

Go to Customer Area
04 · API DELIVERY

Access the latest data through your unique endpoint

Each contact database subscription can provide a unique URL containing a token that authorises access to the licensed data and returns the latest records in CSV format.

Read API Guidance
Oscar Customer Area showing the Selection Tool, Full Download, Changes Since and API access options
The Customer Area brings the main subscription access routes together in one place. API tokens are obscured in this guide.
API delivery

Use your subscription URL for live or scheduled access

The API route can be used simply as an easier download link, or called by your own systems to keep a parallel copy of Oscar data up to date.

FULL CURRENT SET

Call the endpoint without a date

Loading the subscription URL returns the latest full version of the licensed data. If you maintain a parallel copy in your own system, records no longer present in the current feed should be treated carefully as potential deletions.

CHANGES FROM A DATE

Request only records that changed

After taking an initial full copy, add a ?since=YYYYMMDD parameter to request records that are new, changed or deleted since a chosen date.

https://www.oscar-research.co.uk/api/youruniquetoken?since=20220101
Additional change fields: ChangeDate, DeleteDate, CreateDate, OrgDelete, SiteDelete and Change are available in change/API outputs where applicable.
Keep your own systems current

A simple maintenance pattern

1

Take an initial full copy

Start with the current complete version of your subscribed data.

2

Call the API again from a chosen date

Use the ?since=YYYYMMDD parameter to request only records that changed.

3

Apply new, changed and deleted records

Use the returned change fields to update your own copy according to your internal rules.

4

Repeat on the schedule that suits you

The original guide recommends regular updates, typically daily or weekly, where a technical team is maintaining a copy in another system.

Related Oscar guides & services

Go further when standard access is not enough

Need help choosing the right access method?

Tell us how you use the data today and where you want it to live. We can help map the simplest route.