Welcome to the new Help Centre! ✨

You may have spotted our new and shiny company website - and that’s not all that’s changed! We now have dedicated Help Centres for each of our products to make it easier for you to find the right support. For a quick guide to what’s new and where to go, click here.

Software update: Thursday 11th September 2025

On Thursday, we're updating Enrol, to introduce some improvements to existing features.
This update will not require any downtime.
Release notes can be found here.

Submit a ticket Log in
  1. Home
  2. Guides and Support
  3. Integrations
  4. OneFile API

Authenticate via the API

Adam Fogo
Modified on: Wed, 11 Nov, 2020 at 9:37 AM

  Base URLs

Beta Server: https://wsapibeta.onefile.co.uk/api/v2.1

Practice Server: https://wsapi2.onefile.co.uk/api/v2.1

Live Server: https://wsapi.onefile.co.uk/api/v2.1

Firstly, submit a ticket to request an API Token. Once you've got a token:

  1. Call the POST /api/v2.1/Authentication endpoint
    1. Pass the X-CustomerToken in the header
    2. The Session will be returned in the body of the response
  2.  Pass the Session as the X-TokenID in the header, to authenticate all other calls

X-TokenID Expiry

The X-TokenID will expire 24 hours after being generated.

You'll need to Call the POST /api/v2.1/Authentication endpoint to get a new X-TokenID.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.

Other Guides