Skip to main content
GET
/
api
/
partner
/
v2
/
user
/
{userId}
/
wallets
cURL
curl --request GET \
  --url https://staging-api.capa.fi/api/partner/v2/user/{userId}/wallets \
  --header 'partner-api-key: <partner-api-key>'
{
  "success": true,
  "data": {
    "count": 2,
    "total": 2,
    "data": [
      {
        "id": "8374f327-38bd-4b0b-b8a7-2524599eb903",
        "userId": "8374f327-38bd-4b0b-b8a7-2524599eb903",
        "walletAddress": "0x4d2f3d8f83b6f2f8e0f3f4f3f3f3f3f3f3f3f3f3",
        "alias": "My Polygon Wallet",
        "vmType": "EVM",
        "enabled": true,
        "createdAt": "2025-05-08T18:00:00Z",
        "updatedAt": "2025-05-08T18:00:00Z"
      }
    ]
  }
}
Retrieves all enabled wallets for a user. Supports pagination and filtering by virtual machine type (EVM, SVM, STK) or wallet ID.

​
Error Codes

​
Common Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”API Key is missing”
401UNAUTHORIZED”Invalid API Key format”
401UNAUTHORIZED”Invalid API Key”
403INVALID_PARTNER_FLOW”The partner has an invalid flow.”

​
User Ownership Errors

HTTP StatusCodeMessage
401UNAUTHORIZED”Partner information is required for this operation”
401UNAUTHORIZED”User is not associated with the partner”

​
Endpoint-Specific Errors

HTTP StatusCodeMessage
400INVALID_USER_INPUT_ERROR”Invalid User Input” (invalid UUID)

Headers

​
partner-api-key
string
required

Api key for the affiliated partner that is performing the request

Path Parameters

​
userId
string
required

The userId of the user

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

Query Parameters

​
vmType
enum<string>

Filter by virtual machine type

Available options:
EVM,
SVM,
STK
Example:

"EVM"

​
id
string

Filter by wallet ID

Example:

"8374f327-38bd-4b0b-b8a7-2524599eb903"

​
skip
number

The number of elements to exclude from the results.

Example:

5

​
limit
number

The maximum amount of results to return.

Example:

5

​
sortBy
string

Supported values:

  • createdAt
Example:

"createdAt"

Response

200 - application/json

Retrieves all enabled wallets for a user with optional filters

​
success
boolean
Example:

true

​
data
object