Browse SDKs · iOS
Platform
SDKsiOS

Retrieve sent group applications

Retrieve group applications sent by the current iOS user with pagination.

Copy

Invoke getGroupApplicationListAsApplicantWithRep:onSuccess:onFailure: to query group join applications submitted by the current user with pagination:

Parameters

ParameterTypeRequiredDescription
reqGetGroupApplicationListAsApplicantReq *YesRequest object containing target group IDs, status filters, and pagination parameters.

GetGroupApplicationListAsApplicantReq properties

ParameterTypeRequiredDescription
groupIDsNSArray<NSString *> *YesList of target group IDs.
handleResultsNSArray<NSNumber *> *NoStatus filter array wrapping OIMApplicationStatus values.
offsetNSIntegerYesPagination offset index (starts from 0).
countNSIntegerYesMaximum number of items per page.

Application status enumeration

Enumeration valueNumeric valueDescription
OIMApplicationStatusNormal0Pending review (unhandled).
OIMApplicationStatusAgree1Accepted.
OIMApplicationStatusReject-1Rejected.

Code example

GetGroupApplicationListAsApplicantReq *req =
    [[GetGroupApplicationListAsApplicantReq alloc] initWithGroupIDs:@[@"group_1001"]
                                                      handleResults:@[@(OIMApplicationStatusNormal)]
                                                             offset:0
                                                              count:20];

[[OIMManager manager] getGroupApplicationListAsApplicantWithRep:req
                                                      onSuccess:^(NSArray<OIMGroupApplicationInfo *> *items) {
                                                          [self replaceSentApplications:items];
                                                      }
                                                      onFailure:^(NSInteger code, NSString *message) {
                                                          NSLog(@"getGroupApplicationListAsApplicant failed: %ld %@", (long)code, message);
                                                      }];

Return value

The onSuccess callback delivers an array of application records (NSArray<OIMGroupApplicationInfo *> *) created by the current user.

State changes after the call

  1. Snapshot query: This method queries a paginated slice of outgoing requests without triggering delegate events.
  2. Local state merge: Merge items locally using groupID:userID as the unique composite key.
  3. Event notification: When submitted applications are accepted, rejected, or deleted, updates broadcast via listener callbacks. For listener setup, refer to Group applications overview.