Skip to content

Get profile addresses for multiple userkeys

POST
/profiles/addresses
curl --request POST \
--url https://api.ethos.network/api/v2/profiles/addresses \
--header 'Content-Type: application/json' \
--data '{ "userkeys": [ "example" ] }'

Returns one entry per requested userkey, in request order. addresses lists the addresses registered to the profile, in registration order, each typed as ETHOS_WALLET (the Ethos Everywhere wallet) or EXTERNAL_EVM_WALLET (a wallet the user brought). Privy smart wallets are not listed. profileId is null when an address or service account is not attached to a profile; a profileId: userkey always returns that id, with an empty list when the profile has no addresses.

Media typeapplication/json
object
userkeys
required
Array<string>
>= 1 items <= 500 items

Example generated

{
"userkeys": [
"example"
]
}

Successful response

Media typeapplication/json
Array<object>
object
addresses
required
Array<object>
object
address
required

Ethereum address (0x-prefixed, 20 bytes)

string
type
required
string
Allowed values: ETHOS_WALLET EXTERNAL_EVM_WALLET
profileId
required
Any of:
integer
> 0 <= 2147483647
userkey
required
string

Example

[
{
"addresses": [
{
"type": "ETHOS_WALLET"
}
]
}
]

Invalid input data

Media typeapplication/json
Invalid input data error (400)

The error information

object
message
required

The error message

string
code
required

The error code

string
issues

An array of issues that were responsible for the error

Array<object>
object
message
required
string

Example

{
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}

Internal server error

Media typeapplication/json
Internal server error error (500)

The error information

object
message
required

The error message

string
code
required

The error code

string
issues

An array of issues that were responsible for the error

Array<object>
object
message
required
string

Example

{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}