---
updatedAt: 2025-07-26T16:54:38.000Z
agentTools:
  projectIndex: https://docs.metakeep.xyz/llms.txt
---

# Get User From Business Wallet

> 📘 Restricted API
>
> This is a restricted API only available to selected partners. Please contact us if you are interested in using this API.

This API allows you to reverse-lookup a user for a given `BUSINESS_WALLET` address. If the user does not exist, it will return a **404 error**.

For user privacy and security, and to prevent abuse, the API will only return a response if you have made at least one [Lambda Business Wallet](https://docs.metakeep.xyz/reference/v2applambdagetbusinesswallet) API call for the given user previously. Else, it will return a **404 error**.

> 🚧 API Error Status
>
> You can find error status returned by the api [here](https://docs.metakeep.xyz/reference/api-error-status#v2applambdabusinesswalletgetuser).

© Copyright 2024, Passbird Research Inc.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "production",
    "version": "3.4"
  },
  "servers": [
    {
      "url": "https://api.metakeep.xyz/"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "x-api-key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v2/app/lambda/businessWallet/getUser": {
      "post": {
        "summary": "Get User From Business Wallet",
        "description": "",
        "operationId": "v2applambdabusinesswalletgetuser",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "wallet"
                ],
                "properties": {
                  "wallet": {
                    "type": "object",
                    "description": "The wallet to lookup. Currently, the API only supports reverse lookups for `EVM` addresses.",
                    "required": [
                      "address"
                    ],
                    "properties": {
                      "address": {
                        "type": "string",
                        "description": "EVM or Solana compatible crypto wallet address of the user (could be an external wallet address like Metamask, Coinbase, Phantom)."
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"SUCCESS\",\n  \"user\": {\n    \"email\": \"dave@example.com\"\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "SUCCESS"
                    },
                    "user": {
                      "type": "object",
                      "properties": {
                        "email": {
                          "type": "string",
                          "example": "dave@example.com"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "403",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"FORBIDDEN\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "FORBIDDEN"
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"status\": \"USER_NOT_FOUND\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "USER_NOT_FOUND"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```