Getting Started

Overview

The Add On API allows you to submit customer data and monitor its progress. The ARGOS API employs RESTful Endpoints and utilizes standard HTTP methods.

• The response data includes the request status and any potential error codes.

• All response data is provided in JSON format.

• Token authentication is required.

• All requests must be performed over HTTPS; HTTP requests will fail.

Getting Started

To use the API, a valid, dedicated API key is required. You can find your API key within the Add On project in the KYC dashboard. If you are not using the Live form and are submitting via the API, please make sure to use POST.

Authentication

The API uses token-based authentication. To utilize the API, it is essential to use the dedicated API key provided by ARGOS.

Authenticate via HTTP Header

You must send the API key along with the query in the HTTP header. The API key should be included in the method request header as 'x-api-key: {yourAPIKey}'.

curl -H "x-api-key: {yourAPIKey}" "https://rest-api.argoskyc.com/..."

API Gateway Error

The API responds with standard HTTP response codes. Successful operations will return a 2XX code. A 4XX code is returned when there is an error in the information sent from the client, and a 5XX code is returned when there is an error on the ARGOS server.

HTTP Code	Message	Description
400	Invalid Query String parameters	Client Error. e.g.) Invalid request syntax, incorrect request message framing.
403	User is not authorized to access this resource with an explicit deny	If the IP is not accessible within the project, the request will be blocked.
403	Forbidden	The API key is either not provided or there is an issue with the API key.
413	Request Entity Too Large	The request exceeds what the server intends or is capable of handling.
500	Internal Server Error	There may be an error on the ARGOS server. Please contact the ARGOS team.
502	Bad Gateway	The server received an invalid response from an upstream server.