Location

Live: https://api.w2globaldata.com

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

Authentication

The nCino Identity Solutions 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 Key: Authorization
Header Pattern: Basic Base64EncodedW2ApiKey

📘
You'll need both an API Key and a Bundle before you can start sending API calls. If you haven't got either of these, please get into touch

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

Version	Notes
2.0	Large 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.1	Introduced 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:

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

HTTP Status Codes

The nCino Identity Solutions (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 Response	HTTP Status Code	Description
Retrieved (OK)	200	A 200 response indicates that the request has succeeded and the resource has been retrieved.
Created	201	An 201 response indicates that the request has succeeded and a resource was created.
OK No Content	204	A 204 response indicates that the request has succeeded and there was nothing to return.
Bad Request	400	A Bad request response indicates that due to invalid properties provided, the server was unable to process the request.
Unauthorised	401	An unauthorised response suggests that missing valid authentication and therefore the request could not be processed.
Forbidden	403	A forbidden error suggests that the server understands the request however authorization is denied. Please contact our support team to gain access.
Not Found	404	A not found error suggests the resource does not exist.
Internal Server Error	500	An internal server error suggests that there is a problem with the server. Please contact our support team