Authentication

Retrieve access token to authenticate API requests.

Endpoint


POST https://api.smart-kyc.com/token/external/jwt

Request Headers


accept: application/json
Content-Type: application/json

Request Body


{
  "apiKey": "string",
  "apiSecret": "string"
}

Parameters:

apiKey: API key, you can find it in your dashboard
apiSecret: API secret, you can find it in your dashboard

Example Request


curl -X 'POST' \
  'https://api.smart-kyc.com/token/external/jwt' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "apiKey": "string",
  "apiSecret": "string"
}'

Response

200 OK


{
  "accessToken": "string"
}

Save the accessToken to use in subsequent API requests as a Bearer token in the Authorization header.

404 Not Found


{
  "type": "about:blank",
  "title": "KnownRuntimeError",
  "status": 404,
  "detail": "Account not found",
  "instance": "/token/external/jwt",
  "timestamp": 1768492024086,
  "full-path": "https://api.smart-kyc.com/token/external/jwt"
}

Actions: Check your credentials, otherwise contact support.

500 Internal Server Error


{
  "type": "about:blank",
  "title": "KnownRuntimeError",
  "status": 500,
  "detail": "Your account is not active",
  "instance": "/token/external/jwt",
  "timestamp": 1768492507061,
  "full-path": "https://api.smart-kyc.com/token/external/jwt"
}

Actions: Contact support.

Usage

After receiving the access token, include it in all subsequent API requests:


Authorization: Bearer YOUR_ACCESS_TOKEN