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
        • Get all user fields for a community
        • Delete user field
        • Update user field
        • Get specific user field
      • 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
        • Get specific user field
          GET
        • Create user field
          POST
        • Update user field
          PUT
        • Delete user field
          DELETE
      • 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 specific user field

GET
/apis/v1/communities/{communityId}/user-fields/{fieldId}
User Fields
Retrieve detailed information about a specific user field within a community.
Security Requirements:
Bearer token authentication required
Only community members can access this endpoint
User must have COMMUNITY_MEMBER permission for the specified 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:
507f1f77bcf86cd799439011
Match pattern:
^[0-9a-fA-F]{24}$
fieldId
string 
required
The unique identifier of the user field
Example:
507f1f77bcf86cd799439012
Match pattern:
^[0-9a-fA-F]{24}$

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://application.returning.ai/apis/v1/communities/507f1f77bcf86cd799439011/user-fields/507f1f77bcf86cd799439012'

Responses

🟢200OK
application/json
Get specific user field successful
Body
meta
object 
optional
status
string 
optional
statusCode
number 
optional
message
string 
optional
Success message for the operation
data
object 
optional
_id
string 
optional
Field's unique identifier
field
string 
optional
Field identifier
name
string 
optional
Human-readable field name
type
string 
optional
Field data type
creator
object  | null 
optional
User who created this field
isCustom
boolean 
optional
Whether this is a custom field
createdAt
string <date-time>
optional
Field creation timestamp
updatedAt
string <date-time>
optional
Field last update timestamp
Example
{
    "meta": {
        "status": "success",
        "statusCode": 200
    },
    "message": "Get specific user field",
    "data": {
        "_id": "507f1f77bcf86cd799439011",
        "field": "custom_field_1",
        "name": "Custom Field 1",
        "type": "string",
        "creator": {
            "_id": "507f1f77bcf86cd799439011",
            "id": 123456789012345680,
            "avatar": "https://cdn.discordapp.com/avatars/123456789012345678/avatar.png",
            "displayName": "John Doe",
            "username": "johndoe"
        },
        "isCustom": true,
        "createdAt": "2023-01-01T12:00:00.000Z",
        "updatedAt": "2023-01-01T12:00:00.000Z"
    }
}
🟠400Bad Request
🟠404Record Not Found
🔴500Server Error
Modified at 2025-06-24 08:36:32
Previous
Get all user fields for a community
Next
Create user field