Reviewing Registration Requests

This section describes how to review and manually approve or decline registration requests. This process applies to registration requests that meet the criteria for manual approval specified by a standard rule for the group or by a pre-auth rule.

Viewing Requests Pending Manual Approval

To view all registration requests, use the GET method of the mgm/{holdingidentityshorthash}/approval/registrations endpoint.

curl --insecure -u <username>:<password> <REST-API-URL>/mgm/<MGM-HOLDING-ID>/approval/registrations

This method returns the rules in the following format:

  {
    "memberInfoSubmitted": {
      "data": 
    },
    "reason": "string",
    "registrationId": "string",
    "registrationSent": "2022-06-24T10:15:30Z",
    "registrationStatus": "SENT_TO_MGM",
    "registrationUpdated": "2022-06-24T10:15:30Z"
  }

Requests that are pending manual approval have the status PENDING_MANUAL_APPROVAL.

To view requests from a specific member (for example, C=GB, L=London, O=Alice) and include historic requests:

curl --insecure -u <username>:<password> <REST-API-URL>/mgm/<MGM-HOLDING-ID>/approval/registrations?requestsubjectx500name=C%3DGB%2C%20L%3DLondon%2C%20O%3DAlice&viewhistoric=true'

Approving a Request

To approve a rquest, pass the ID of the request to the POST method of the mgm/{holdingidentityshorthash}/approve/{requestid} endpoint. You can retrieve the ID of a request from the response of the GET endpoint described in Viewing Requests Pending Manual Approval.

curl --insecure -u <username>:<password> -X POST <REST-API-URL>/mgm/<MGM-HOLDING-ID>/approve/<REQUEST-ID>

Declining a Request

To decline a request, pass the ID of the request and a reason to the POST method of the mgm/{holdingidentityshorthash}/decline/{requestid} endpoint. You can retrieve the ID of a request from the response of the GET endpoint described in Viewing Requests Pending Manual Approval.

curl --insecure -u <username>:<password> -d <REASON> <API-URL>/mgm/<MGM-HOLDING-ID>/decline/<REQUEST-ID>