How to Verify FORMLESS Account IDs

This guide provides step by step instructions on how to determine whether a given user in your system has an account with FORMLESS.

In order to conditionally render certain UI flows, such as the ability to input a smart contract ID to receive payments, you may need to determine whether one of your customers has an account with FORMLESS. You can do this using the identity_get_by_email_address RPC endpoint.

cURL

curl -v -X POST https://share-ddn.formless.xyz/v1 \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
--data-raw '{
    "jsonrpc": "2.0",
    "id": "0",
    "method": "identity_get_by_email_address",
    "params": {
        "email_address": "<EMAIL_ADDRESS>"
    }
}'

{
  "jsonrpc": "2.0",
  "id": "0",
  "result": {
    "user_unique_id": "[redacted]",
    "success": true,
    "email_address": "[redacted]",
    "financial_accounts": [
      {
        "evm_blockchain_network_id": 137,
        "evm_blockchain_address": "0x99BC0Db717adBcfe35020B8Ae6A0f736389052C2",
        "is_managed": true
      }
    ],
    "display_name": "TEST_NAME",
    "verified_identity": true,
    "verifications": {
      "sms": true
    }
  }
}

This endpoint will only return values for email addresses corresponding to customers that have signed up through your portal link.