Skip to main content

Validate Username

GET /api/3pl/{company}/username

Confirm that a DYLI username exists and has an active wallet. Use this before sending sealed inventory to a user's DYLI vault.

curl --get "https://www.dyli.io/api/3pl/$DYLI_3PL_COMPANY/username" \
  -H "x-api-key: $DYLI_3PL_API_KEY" \
  --data-urlencode "username=alex"

@alex and alex are treated the same.

Valid Username​

{
  "valid": true,
  "username": "alex",
  "profileUrl": "https://www.dyli.io/profile/alex",
  "wallet": "0x1234...ABCD"
}

Invalid Username​

Unknown usernames return 200 with valid: false. This lets you show that the username is invalid without treating the request as an API failure.

{
  "valid": false,
  "username": "missing-user",
  "reason": "DYLI username @missing-user was not found"
}

The same endpoint accepts POST with a JSON body:

curl "https://www.dyli.io/api/3pl/$DYLI_3PL_COMPANY/username" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "x-api-key: $DYLI_3PL_API_KEY" \
  -d '{"username":"alex"}'

Accepted aliases are dyliUsername and dyli_username.