Get User Metadata

Retrieve metadata for a specific user

Endpoint

GET /recipe/user/metadata

This is an app-specific API that retrieves metadata associated with a user.

Query Parameters

userId · string · required

The ID of the user whose metadata you want to retrieve.

Request Example

curl -X GET "https://your-api-domain.com/recipe/user/metadata?userId=user123" \
  -H "Content-Type: application/json"

Response

status · string

Always returns "OK"

metadata · object

A JSON object containing the user’s metadata. Returns an empty object {} if no metadata exists for the user.

Response Example

{
  "status": "OK",
  "metadata": {
    "preferences": {
      "theme": "dark",
      "language": "en"
    },
    "lastLoginLocation": "New York",
    "accountType": "premium"
  }
}

Empty Metadata Response

{
  "status": "OK",
  "metadata": {}
}

Implementation Details

Source: View source

• This API requires public tenant access
• Returns an empty object if the user has no metadata
• Metadata is stored as a JSON object and can contain any valid JSON structure
• User ID mapping is automatically handled for app-specific queries

Use Cases

• Retrieve user preferences and settings
• Get custom user profile information
• Fetch application-specific user data
• Access metadata for user personalization

Related Endpoints

Update User Metadata

Update or create user metadata