POST Query Org

Return a list of organisations, filtered on specified criteria. The results are ordered alphabetically by name.

Request

HTTP request

POST https://<JM_SERVER>/workspaces/secure/api/v1/org/query

Request body

The POST request must contain a JSON structure describing the org query. To support multiple parameters, this API uses HTTP Content Type: application/json.

The available query attributes are listed below. All attributes are optional except where otherwise indicated.

Attribute	Description
fetchLimit	Integer (Default: 10000) Required. Specify the query fetch limit; that is, the maximum number of results returned. Values: In the range 1 - 10,000. Values greater than 10,000 are reduced to 10,000. Note: This attribute is used in conjunction with fetchOffset to determine which results are returned.
fetchOffset	Integer (Default: 0) Specify the query fetch offset. Note: This attribute is used in conjunction with fetchLimit to determine which results are returned.

caution

If you specify an invalid query attribute, a 400 Bad Request HTTP status code is returned.

Response

If successful, this operation returns a response with a HTTP 200 OK status code.

Error messages

Error key	Error	HTTP status code
illegalArgument	Please see Error Log ID {number}	400 Bad Request
internalError	Please see Error Log ID {number}	500 Internal Server Error
unableToResolvePortal	Unable to resolve portal from request	400 Bad Request

Error Responses

HTTP status code	Description
400 Bad Request	Bad request or request parameter. Check error message for details.
404 Not Found	Ensure the URL endpoint is entered correctly.
500 Internal Server Error	Exception occurred in org query. Contact administrator.

Example

Ensure you specify Content-Type: application/json.

Example request

POST <b>/workspaces/secure/api/v1/org/query</b> HTTP/1.1
Host: https://transact.workspaces.com
Content-Type: application/json

{
    "fetchLimit": 2,
    "fetchOffset": 0
}

Example successful response

{
    "fetchLimit": 2,
    "fetchOffset": 0,
    "durationMs": 26,
    "result": [
        {
            "orgName": "Bank",
            "clientCode": "Bank",
            "categoryNames": [],
            "spaceNames": [
                "Maguire",
                "Web Plug-in",
                "Work Spaces"
            ]
        },
        {
            "orgName": "Workspaces",
            "clientCode": "workspace",
            "categoryNames": [
                "Deposit Account Opening",
                "Loan applications"
            ],
            "spaceNames": [
                "Maguire",
                "Salesforce",
                "Web Plug-in",
                "Work Space",
                "Work Spaces"
            ]
        }
    ]
}