Verify zkKYC Status

Before initiating the request to obtain the status from Get KYC statistics status # and Get Users List, please follow Authentication at zkMe API to get your API access parameters.

Get KYC statistics status #

URL

https://openapi.zk.me/kyc/v1/status
    ?mch_no=YourMerchantNumber
    &api_key=YourApiKey

Request

Parameters #

Name	Type	Description
mch_no	string	Same as AppID in the Dashboard.
api_key	string	Your API key

Response

Sample Response

{
  "code": 200,
  "message": "success",
  "data": {
    "kyc_participants": 22,
    "kyc_verified": 0,
    "kyc_participants_daily": [
      {
        "date": "2023-07-27",
        "participants": 2
      },
      {
        "date": "2023-07-28",
        "participants": 1
      },
      {
        "date": "2023-08-09",
        "participants": 1
      },
      {
        "date": "2023-08-13",
        "participants": 2
      },
      {
        "date": "2023-09-14",
        "participants": 1
      },
      {
        "date": "2023-09-25",
        "participants": 1
      },
      {
        "date": "2023-10-27",
        "participants": 2
      },
      {
        "date": "2023-12-01",
        "participants": 1
      },
      {
        "date": "2024-01-05",
        "participants": 1
      },
      {
        "date": "2024-01-06",
        "participants": 1
      },
      {
        "date": "2024-01-10",
        "participants": 2
      },
      {
        "date": "2024-01-15",
        "participants": 1
      },
      {
        "date": "2024-01-16",
        "participants": 1
      },
      {
        "date": "2024-01-17",
        "participants": 3
      },
      {
        "date": "2024-01-19",
        "participants": 1
      },
      {
        "date": "2024-01-24",
        "participants": 1
      }
    ],
    "kyc_verified_daily": null,
    "meid_count": 4
  }
}

Get Users List

Returns a list of users who have authorized a Soulbound Token under this project account.

URL

https://openapi.zk.me/kyc/v1/users
   ?mch_no=YourMerchantNumber
   &api_key=YourApiKey
   &page=1
   &num=10

Request

Parameters#

Name	Type	Description
mch_no	string	Same as AppID in the Dashboard.
api_key	string	Your API key
page	int	Page number, example value: 1
num	int	Number of data entries per page.

Response

Sample response

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "zkme_id": "...",
        "verify_time": "",
        "account": "...",
        "blockchain_id": ...,
        "blockchain_logo_url": "...",
        "program_type": "...",
        "network": "",
        "token_id": "...",
        "user_wallet_address": "...",
        "authorization_info": null,
        "user_id": "",
        "ssi_wallet_address": ""
      }
    ],
    "page": {
      "page": 1,
      "num": 10,
      "total": 1
    }
  }
}

Get Users KYC Result Overview

Returns the balance and statistics for a given address.

Endpoint

POST https://agw.zk.me/zkseradmin/openapi/queryKycInfoByAddress

Request

Request Body

{
  "mchNo": "YourMerchantNumber",
  "apiKey": "YourApiKey",
  "programNo": "YourProgramID",
  "account": "walletAddress", // or email, or other unique identifiers
  "chainId": "YourChainID"
}

Fields Explanation

Name	Type	Description
mchNo	string	Same as AppID in the Dashboard.
apiKey	string	Your API Key.
programNo	string	Same as the programNo you pass for the SDK integration.
account	string	User's wallet address (recommended), email address, or other unique identifier
chainId	string	Same as the param chainId you pass for the SDK integration.

Supported Chain List

Chain Type	Chain Name	Chain ID
Mainnet	Aptos	aptos-1
	Arbitrum	42161
	Base	8453
	BNB Smart Chain	56
	BounceBit	6001
	Ethereum	1
	Manta	169
	Neutron	neutron-1
	Polygon	137
	Ronin	2020
	X Layer	196
Testnet	Aptos Testnet	aptos-2
	Lumoz Testnet	12008
	Manta Testnet	3441005
	Mantle Testnet	5001
	Neutron Testnet	pion-1
	Plume Testnet	98864
	Scroll Sepolia Testnet	534351
	Sei Testnet	atlantic-2
	ZetaChain Athens3 Testnet	7001

Response

Sample Response

{
  "zkme_id":"...",
  "kycStatus":"...",
  "kycCompleteTimeUnix":"...", 
  "ssiAddress":"...",
  "verifierValues":{
    "sanction":...,
    "age":...,
    "citizenship":...,
    "location":...,
  },
}

Fields Explanation

Name	Type	Description
zkme_id	String	Return the zkMe id corresponding to the zkMe account linked to the provided address.
kycStatus	string	Return users' KYC status, including 7-8 stages: Verification Started OCR Passed Liveness Checked ZKP Generated SBT Minted OnChain Minted Note: Only applicable to On-chain Mint and On-chain Transactional KYC Passed Verification Failed
kycCompleteTimeUnix	string	Unix timestamp of the mint time of SBT minting in SSI wallet.
ssiAddress	String	User's SSI wallet address
sanction	bool	Return the user's AML Screening verification result with the following output: If the user passes, return true. If the user fails, return false. If the AML Screening verification is not configured for the program, return null.
age	bool	Return the user's age verification result with the following output: If the user passes, return true. If the user fails, return false. If the Proof of Citizenship is not configured for this program, return null.
citizenship	bool	Return the user's citizenship verification result with the following output: If the user passes, return true. If the user fails, return false. If the Proof of Citizenship is not configured for the program, return null.
location	bool	Return the user's location verification result with the following output: If the user passes, return true. If the user fails, return false. If the Proof of Location is not configured for the program, return null.