POST /token

  • Live
  • Sandbox
  • Versionless
Api Details

Usage

POST /token

Description

To gain an access token to call our other APIs, you must first call the POST /token endpoint.

This API requires that you pass your Client ID, received during app onboarding, in the request. This can be done by either passing it in the Authorization or the Client ID parameter. If you pass your Client ID in the call, this must contain a value and not be left blank.

Please be aware that the Client Credentials Access Token we return can be up to 4,000 characters in length, therefore we recommend you do no limit this in your application.

API Reference

/token
post /token

Resource URL

https://api-internal.obtpp.nationwideinterfaces.io/open-banking/oauth /token

Header Parameters

Content-Type
(required)

Indicate the media type of the resource

Authorization

Base64 encoded client id and client secret

Body Parameters

client_id

The client identifier generated by the ASPSP

grant_type
(required)

OAuth grant type in exchange for access token

scope
(required)

Limit the amount of access that is granted to an access token

code

Access code generated in response of authorize flow. Used with grant type 'authorization_code'

redirect_uri

Redirect URI, should be present in SSA. Used with grant type 'authorization_code'

refresh_token

Refresh Token, used in AIS apis to get access token in exchange of refresh token. Used with grant type 'refresh_token'

Request Body

HTTP Basic

OAuth 2.0

API Key

Reset

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Resource Summary

Security

Content Type

application/x-www-form-urlencoded

Category

OAuth

Response Error Details
  • 400 Bad request
  • 401 Unauthorized
  • 403 Forbidden
  • 404 Not found
  • 405 Method Not Allowed
  • 406 Not Acceptable
  • 429 Too Many Requests
  • 500 Internal Server Error

Working...

API Personas

Sam Jones
  • Retail
  • Lives alone
  • Is overdrawn
View Persona
Patrick Nadwarna
  • Retail
  • No regular payments
  • Large balance
View Persona
Cathy Powell
  • Retail
  • Fraud victim
  • Restricted account
View Persona
Josh Chambers
  • Retail
  • Economics student
  • Uses different payment channels
View Persona
Maz Patel
  • Retail
  • Full-time mum
  • Frequent spender
View Persona
Darren Nowak
  • Retail
  • Rarely at home
  • Financially savvy
View Persona
Janet Simpson
  • Retail
  • Closing current account
  • Insufficient funds
View Persona
Melanie Rossi
  • Retail
  • Travels a lot
  • Locked current account
View Persona
Hattie Walker
  • Retail
  • Credit card account
  • Frequent credit card use
View Persona
Victor Braganza
  • Retail
  • Credit card account
  • Inactive account
View Persona
Alex Baker
  • Retail
  • Credit card account
  • Restricted account
View Persona
Martin Hanger
  • Retail
  • Buying new house
  • Evaluating affordability
View Persona
Keesha Mclintock
  • Retail
  • Credit card account
  • Applying for a mortgage
View Persona
Jason Costello
  • Business
  • J C Plumbing
  • New business
View Persona
Jozef Ivan
  • Business
  • The Cake Cave
  • New business
View Persona
Brian McKay
  • Business
  • Johnson's Fish & Chip
  • Money Laundering- Fraud
View Persona
Lee Waterman
  • Business
  • L W Car Parts
  • Lots of payments
View Persona
Muhammed Patel
  • Business
  • Snips
  • Shrinking business
View Persona
Sharon Snow
  • Business
  • Endeavour Web Designs
  • Established, highly successful
View Persona
Lucy Baines
  • Business
  • The Royal Oak
  • Moving business account
View Persona
Roland Hanbury
  • Business
  • Grey Fox Marketing
  • Working abroad
View Persona