Skip to content

List Portals

GET/web/v1/workspaces/{workspaceId}/institutions/{institutionBizId}/portals WEB

Returns all portal entries for a given institution.

Required Headers

HeaderExample ValueDescription
Content-Typeapplication/jsonRequest content type
Acceptapplication/jsonExpected response type
X-Client-HashClient device fingerprint
Accept-Languageen, zh, zh-Hant, ja, viResponse language (default: en)
AuthorizationBearerJWT access token

Request Parameters

Path Parameters

NameTypeRequiredInDescription
workspaceIdstringRequiredpathWorkspace business ID
institutionBizIdstringRequiredpathInstitution business ID

Success Response

Success 200
{
  "code": "2000",
  "message": "SUCCESS",
  "data": [
    {
      "id": 1,
      "institutionBizId": "inst_abc123",
      "portalType": 10010102,
      "domain": "https://tenant.example.com",
      "portalStatus": 10080101,
      "remark": null,
      "createdAt": "2026-03-21T00:00:00Z",
      "updatedAt": "2026-03-21T00:00:00Z"
    }
  ]
}

Error Responses

CodeDescription
4010Unauthorized (invalid or missing JWT token)
4040Institution not found

Notes

  • Returns an array of all portals associated with the institution.

SlaunchX Internal Documentation