Returning.AI
  1. User Fields
Returning.AI
  • Returning.AI
    • Auth
      • register
      • verify email
      • login
      • secure auth
    • Server
      • create new server
      • get my servers
      • update server
      • role list of server
      • channel list of server
    • Role
      • create new role
      • update role
      • delete role
      • add role to a user on a server
      • remove role from a user on a server
      • get role list of user on a server
    • Channel
      • get channels list
      • create new channel
      • update channel
      • delete channel
    • Badge
      • get badges list
      • create new badge
      • update badge
      • delete badge
      • award badge to user
      • remove badge from user
    • Integration
      • users
        • create new user
        • manage user
        • user data
        • gamification stats
        • user bulk update
        • user bulk import
      • Messages
        • Send Message
        • Reply Message
        • React Message
      • Channels
        • Get Channels List
      • User Field Histories
        • Create user field history
        • Get user field histories
      • User Fields
        • Create user field
          POST
        • Get all user fields for a community
          GET
        • Delete user field
          DELETE
        • Update user field
          PUT
        • Get specific user field
          GET
      • Users
        • Get user
    • Application
      • Users
        • Get user
      • Community Users
        • Get community users
        • Get community user
      • User Fields
        • Get all user fields for a community
        • Get specific user field
        • Create user field
        • Update user field
        • Delete user field
      • User Field Histories
        • Get all user field histories in a community
        • Get user field histories for a specific field
        • Get user field histories for a specific user
        • Get user field histories of specific user field and user
        • Create user field history for specific user
  1. User Fields

Get all user fields for a community

GET
/apis/v1/communities/{communityId}/user-fields
User Fields
Retrieves all user fields associated with a specific community

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
communityId
string 
required
The unique identifier of the community
Example:
6167dba9c548eb5c7ec28057
Query Params
isCustom
enum<string> 
optional
Filter to show only custom fields when set to true
Allowed values:
truefalse
Default:
false
Example:
true

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://integration.returning.ai/apis/v1/communities//user-fields'

Responses

🟢200OK
application/json
User fields retrieved successfully
Body
meta
object 
optional
status
string 
optional
statusCode
number 
optional
totalItemsCount
number 
optional
Total number of items processed
message
string 
optional
Success message for the operation
data
array [object {8}] 
optional
Array of user fields for the community
_id
string 
optional
Unique identifier of the user field
field
string 
optional
Field identifier or key name
name
string 
optional
Display name of the user field
type
enum<string> 
optional
Data type of the user field
Allowed values:
datesingle-line-textnumericalmulti-line-textnumbertextstring
creator
object  | null 
optional
isCustom
boolean 
optional
Indicates whether this is a custom user field or a system field
createdAt
string <date-time>
optional
Timestamp when the user field was created
updatedAt
string <date-time>
optional
Timestamp when the user field was last updated
Example
{
    "meta": {
        "status": "success",
        "statusCode": 200,
        "totalItemsCount": 1
    },
    "message": "Get user fields success.",
    "data": [
        {
            "_id": "6857de260f3c24d98fd7ca85",
            "field": "total",
            "name": "Total",
            "type": "numerical",
            "creator": {
                "_id": "61100af5c548eb5c7ebc7819",
                "id": 1,
                "avatar": "https://returning-ai.com/avatar.png",
                "displayName": "Admin",
                "username": "admin"
            },
            "isCustom": true,
            "createdAt": "2025-06-22T11:28:50.301Z",
            "updatedAt": "2025-06-22T11:28:50.301Z"
        }
    ]
}
🟠400Bad Request
🟠404Record Not Found
🔴500Server Error
Modified at 2025-06-23 14:46:45
Previous
Create user field
Next
Delete user field