Jump to

• Request
• Response

Get All Valid User Group

get

/api/1.0/usergroup

This endpoint is used to Get all valid User Group maintenance records.

Request

Supported Media Types

• application/json
• application/xml

Query Parameters

• authStatus(optional): string
  Authorization Status
• defaultAssigneeFlg(optional): string
  Default Assignee Flag
• fetchExpiredGroupsFlg(optional): string
  Fetch Expired Groups Flags
• includecloseandunauth(optional): boolean
  Include close and unauthorized need to be set to fetch summary record, default value is false.
• limit(optional): integer
  Limit is maximum number of records to be fetched.
• offset(optional): integer
  Offset is starting number of records to be fetched.
• recordStatus(optional): string
  Record Status
• supervisoryGroupCd(optional): string
  Supervisory Group Code
• userGroupCd(optional): string
  User Group Code
• userGroupDescr(optional): string
  User Group Description

Header Parameters

• appId: string
  The application ID of host service.
• branchCode: string
  The branch code of requesting branch.
• contentType(optional): string
  The content type of request or response body.
• userId: string
  The user ID of requesting user.

Back to Top

Response

Supported Media Types

• application/json
• application/xml

201 Response

Valid User groups retrieved successfully.

Headers

• Location: string
  URL details.

Body ()

Root Schema : DmTmUserGroupCollection

Type: object

Collection of User Groups.

Show Source

• data(optional): array data
  Data
• paging(optional): object PagingDto

{
    "description":"Collection of User Groups.",
    "type":"object",
    "properties":{
        "data":{
            "type":"array",
            "description":"Data",
            "items":{
                "$ref":"#/definitions/DmTmUserGroupDTO"
            }
        },
        "paging":{
            "$ref":"#/definitions/PagingDto"
        }
    }
}

Nested Schema : data

Type: array

Data

Show Source

• Array of: object DmTmUserGroupDTO

{
    "type":"array",
    "description":"Data",
    "items":{
        "$ref":"#/definitions/DmTmUserGroupDTO"
    }
}

Nested Schema : PagingDto

Type: object

Show Source

• totalResults(optional): integer
  Total number of results available.

{
    "type":"object",
    "properties":{
        "totalResults":{
            "type":"integer",
            "description":"Total number of results available."
        }
    }
}

Nested Schema : DmTmUserGroupDTO

Type: object

Match All

Show Source

• allOf GenericDto
• object DmTmUserGroupDTO-allOf[1]

{
    "type":"object",
    "allOf":[
        {
            "$ref":"#/definitions/GenericDto"
        },
        {
            "type":"object",
            "properties":{
                "userGroupCd":{
                    "description":"User Group code",
                    "type":"string"
                },
                "userGroupDescr":{
                    "description":"User Group description",
                    "type":"string"
                },
                "hirachyOrder":{
                    "description":"Hierarchy order",
                    "type":"integer"
                },
                "supervisoryGroupCd":{
                    "description":"Supervisory Group code",
                    "type":"string"
                },
                "defaultAssigneeFlg":{
                    "description":"Default Assignee Flag",
                    "type":"boolean"
                },
                "DmTmUserGroupMembersDTO":{
                    "type":"array",
                    "items":{
                        "$ref":"#/definitions/DmTmUserGroupMembersDTO"
                    }
                }
            }
        }
    ]
}

Nested Schema : GenericDto

Match All

Show Source

• object GenericDto-allOf[0]
  Discriminator: resource_type

{
    "allOf":[
        {
            "type":"object",
            "discriminator":"resource_type"
        }
    ]
}

Nested Schema : GenericDto-allOf[0]

Type: object

Discriminator: resource_type

Nested Schema : DmTmUserGroupDTO-allOf[1]

Type: object

Show Source

• defaultAssigneeFlg(optional): boolean
  Default Assignee Flag
• DmTmUserGroupMembersDTO(optional): array DmTmUserGroupMembersDTO
• hirachyOrder(optional): integer
  Hierarchy order
• supervisoryGroupCd(optional): string
  Supervisory Group code
• userGroupCd(optional): string
  User Group code
• userGroupDescr(optional): string
  User Group description

{
    "type":"object",
    "properties":{
        "userGroupCd":{
            "description":"User Group code",
            "type":"string"
        },
        "userGroupDescr":{
            "description":"User Group description",
            "type":"string"
        },
        "hirachyOrder":{
            "description":"Hierarchy order",
            "type":"integer"
        },
        "supervisoryGroupCd":{
            "description":"Supervisory Group code",
            "type":"string"
        },
        "defaultAssigneeFlg":{
            "description":"Default Assignee Flag",
            "type":"boolean"
        },
        "DmTmUserGroupMembersDTO":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/DmTmUserGroupMembersDTO"
            }
        }
    }
}

Nested Schema : DmTmUserGroupMembersDTO

Type: array

Show Source

• Array of: object DmTmUserGroupMembersDTO
  User group Members Details.

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/DmTmUserGroupMembersDTO"
    }
}

Nested Schema : DmTmUserGroupMembersDTO

Type: object

User group Members Details.

Show Source

• activeFlg(optional): boolean
  Active Flag
• id(optional): string
  ID
• userGroupMasterId(optional): string
  User group Master ID
• userId(optional): string
  User ID
• userName(optional): string
  User Name

{
    "description":"User group Members Details.",
    "type":"object",
    "properties":{
        "userId":{
            "description":"User ID",
            "type":"string"
        },
        "userName":{
            "description":"User Name",
            "type":"string"
        },
        "activeFlg":{
            "description":"Active Flag",
            "type":"boolean"
        },
        "id":{
            "type":"string",
            "description":"ID"
        },
        "userGroupMasterId":{
            "type":"string",
            "description":"User group Master ID"
        }
    }
}

400 Response

Malformed syntax.

401 Response

Request does not have sufficient credentials.

403 Response

Request is not authorized.

405 Response

Invalid input

500 Response

Internal error

Back to Top