Skip to content
On this page

API Basics

This section describes how to use the W2 RESTful API

Location

Live: https://api.w2globaldata.com

UAT: https://api-uat.w2globaldata.com

Authentication

The W2 REST API uses basic authentication. You will need to add a basic authorization header with your api key base 64 encoded to all requests.

Header KeyHeader Pattern
AuthorizationBasic Base64EncodedW2ApiKey

API Versioning

To call a specific version of the API append the API version query option to the end of the URL like this: https://api.w2globaldata.com/kyc-check?api-version=1.1

We strongly recommend that you provide a version number with all of your requests. A request without a version number will default to the latest version of the API so you might experience changes you are not prepared for.

Version history

VersionNotes
2.0Large changes to our OpenAPI spec (particularly around Case Management) has caused us to increase the major version of our API. There are no breaking changes to the actual API itself.
2.1Introduced the business search endpoint, and the ability to create a business case with the information retrieved from the search results.

OpenAPI

OpenAPI is a popular standard for describing RESTful APIs. It defines all of an API's endpoints, requests and responses in a single JSON file. The file can be imported into tools like Postman or used to generate integration code in Visual Studio. It makes integrating with APIs easy.

We have Swagger running on our API and our OpenAPI spec can be found at the following urls:

VersionOpenAPI URL
2.0https://api.w2globaldata.com/swagger/2/swagger.json
2.1https://api.w2globaldata.com/swagger/2.1/swagger.json
2.2https://api.w2globaldata.com/swagger/2.2/swagger.json

HTTP Status Codes

The W2 RESTful API closely adheres to the standard use of HTTP status codes. You can expect to find one of the following status codes in your response data.

Http ResponseHttp StatuscodeDescription
Retrieved (OK)200A 200 response indicates that the request has succeeded and the resource has been retrieved.
Created201An 201 response indicates that the request has succeeded and a resource was created.
OK No Content204A 204 response indicates that the request has succeeded and there was nothing to return.
Bad Request400A Bad request response indicates that due to invalid properties provided, the server was unable to process the request.
Unauthorised401An unauthorised response suggests that missing valid authentication and therefore the request could not be processed.
Forbidden403A forbidden error suggests that the server understands the request however authorization is denied. Please contact our support team in order to gain access.
Not Found404A not found error suggests the resource does not exist.
Internal Server Error500An Internal server error suggests that there is a problem with the server. Please contact our support team.