headerThis object is required in every call. The information it includes is used to verify the signature.true
messageThis tag specifies the JSON schema object to validate against. For this call, use entity_msg.false
addressThis object specifies the street address of the person being verified.false
identityThis is used to specify an ID and what kind of ID is being specified. (As of writing, Sila only accepts U.S. Social Security Numbers, but this will expand in the future.)optional
contactThis is where the verified person's phone number and email address are sent.true
crypto_entryUsed to specify the blockchain address and network code it runs on.true
entityIncludes names, birthdates, and user type.true

Used by Endpoints:

  • /register

Note - We recently renamed the field auth_handle to app_handle. For backward compatibility, auth_handle is still valid but has been removed from our documentation.

  "header": {
    "created": 1234567890, 
    "app_handle": "handle.silamoney.eth", 
    "version": "0.2", 
    "crypto": "ETH", 
    "reference": "<your unique id>"
  "message": "entity_msg",
  "address": {
    "address_alias": "Home Sweet Home",
    "street_address_1": "123 SW Main St. Apt 143",
    "city": "Portland",
    "state": "Oregon",
    "country": "US",
    "postal_code": "97000"
  "identity": {
    "identity_alias": "SSN",
    "identity_value": "123452222"
  "contact": {
    "contact_alias": "main",
    "phone": "5035035035",
    "email": "[email protected]"
  "crypto_entry": {
    "crypto_alias": "primary",
    "crypto_code": "ETH",
    "crypto_address": "0x65a796a4bD3AaF6370791BefFb1A86EAcfdBc3C1"
  "entity": {
    "first_name": "Holly",
    "last_name": "Golightly",
    "entity_name": "Holly Golightly",
    "birthdate": "1959-01-31",
    "relationship": "user"