List Institutions

POST/web/v1/workspaces/{workspaceId}/institutions/queryWEB

Returns a paginated list of institutions with optional filtering.

Authentication

Requires a valid JWT token. Gateway validation: enableJwtToken=true, enableTurnstile=false.

Request Parameters

Path Parameters

Name	Type	Required	In	Description
workspaceId	string	Yes	path	Workspace business ID

Request Body

InstitutionQueryRequest:

Name	Type	Required	In	Description
institutionBizId	string	No	body	Filter by institution business ID
institutionType	string	No	body	Filter by institution type: SYSTEM, TENANT, PARTNER, CONSUMER
institutionStatus	string	No	body	Filter by status: PENDING, REVIEWING, ACTIVE, REJECTED, SUSPENDED, CLOSED
institutionName	string	No	body	Filter by institution name (partial match)
page	integer	No	body	Page number (0-based, default: 0)
size	integer	No	body	Page size (1-100, default: 20)

Success Response

Success200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": {
    "institutions": [
      {
        "bizId": "inst_abc123",
        "institutionName": "Acme Corp",
        "institutionDescription": "Main institution",
        "institutionRemark": null,
        "institutionType": "TENANT",
        "institutionStatus": "ACTIVE",
        "extraConfig": null,
        "createdAt": "2026-03-21T00:00:00Z",
        "updatedAt": "2026-03-21T00:00:00Z"
      }
    ],
    "totalElements": 1,
    "totalPages": 1,
    "currentPage": 0,
    "pageSize": 20
  }
}

Error Responses

Code	Description
4000	Validation error (invalid page/size values)
4010	Unauthorized (invalid or missing JWT token)

Notes

• All filter fields are optional; omit them to retrieve all institutions.
• Tenant portal users may see a filtered view based on their permissions.