🤖Public APIs

This section focuses on a API implementation. We would like to allow for all developers to be able to integrate, even beyond the scope of web3.

Links

• sandbox: https://sandboxapi.0xkyc.id/docs

You can use already configured test account.

apiKey: "test1"

apiSecret: "123456789123456789"

• prod: https://api.0xkyc.id/docs

You need to get issued an apiKey from us.

Please send an email to us [e-mail] using the apiKey request form below after changing #{something} to the proper one.

apiKey request form

Email Title

[ApiKey Request] from #{yourName or organizationName}

Email Content

Dear 0xkyc Support Team,
I am writing to request an API key for accessing the services offered by 0xkyc.

Details:
Name/Organization: #{yourName or organizationName}
Purpose of Integration: #{Briefly describe why you want to integrate with 0xkyc, such as "We are developing a financial app that requires KYC checks for our users."}

Contact Information:
Email: #{yourEmail}
(optional)Website: #{yourWebsiteLink}

APIs

Get JWT format accessToken.

API endpoint to get JWT format accessToken. See below for example requests and responses.

POST/auth

Body

application/json

apikey*string

apiSecret*string

Response

200400

Successfully returns JWT format accessToken

Body

application/json

accessToken*string

Request

JavaScriptCurlPython

const response = await fetch('/auth', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "apikey": "test1",
      "apiSecret": "123456789123456789"
    }),
});
const data = await response.json();

Response

200400

{
  "accessToken": "text"
}

Check whether a specified wallet address holds any SBT tokens on a given blockchain chain.

API endpoint to check whether a specified wallet address holds any SBT tokens on a given blockchain chain. The wallet address should be provided in hex code format starts with 0x. The user can specify the chain they're checking against. Returns a boolean indicating presence or absence of SBT tokens, or an error message in case of invalid parameters or unauthorized issue. See below for example requests and responses.

GET/api/v1/hasSoul

Authorization

accessToken

Query parameters

Response

200400401

Successfully returns true or false as a result

Body

application/json

result*boolean

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/hasSoul?walletAddress=text&chainName=ethereum-goerli', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

200400401

{
  "result": false
}

Get UUID on a given wallet address and blockchain chain.

API endpoint to get UUID on a given wallet address and blockchain chain. The wallet address should be provided in hex code format starts with 0x. The user can specify the chain they're checking against. Returns a string format uuid or empty string, or an error message in case of invalid parameters or unauthorized issue. See below for example requests and responses.

GET/api/v1/uuid

Authorization

accessToken

Query parameters

Response

200400401

Successfully returns uuid or empty string

Body

application/json

result*string

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/uuid?walletAddress=text&chainName=ethereum-goerli', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

200400401

{
  "result": "text"
}

Get address, chainId, chainName pairs which has the same UUID.

API endpoint to get address, chainId, chainName pairs which has the same UUID. The uuid should be provided in uuid format. Returns an array of {address, chainId, chainName}, or an error message in case of invalid parameters or unauthorized issue. See below for example requests and responses.

GET/api/v1/pairs

Authorization

accessToken

Query parameters

Response

200400401

Successfully returns an array of {address, chainId, chainName} or an empty array

Body

application/json

address*string

chainId*number

chainName*string

Request

JavaScriptCurlPython

const response = await fetch('/api/v1/pairs', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

200400401

[
  {
    "address": "text",
    "chainId": 0,
    "chainName": "text"
  }
]