Skip to content

Response

The response format from the web services is standard. It does vary slightly depending on whether the web service call comes back as a paged query or as a non-paged query. Regardless of the query type and if there is data returned or not, the result property will always be an array. However, if no data is found, it will be an empty array. If you're querying a single result, it'll be an array with a single element. And in list queries, it'll be an array of objects.

Paged Query

The response format from the web services is standard. It does vary slightly depending on whether the web service call comes back as a paged query or as a non-paged query. Regardless of the query type and if there is data returned or not, the result property will always be an array. However, if no data is found, it will be an empty array. If you're querying a single result, it'll be an array with a single element. And in list queries, it'll be an array of objects.

Paged Query Sample Response

{
    "success": true,
    "requestId": "S59214236",
    "totalCount": 4,
    "isPaged": true,
    "totalPages": 1,
    "page": 1,
    "pageSize": 100,
    "result": [
        {...},
        {...}
    ]
}

Non-Paged Query

For a non-paged query, which are typically small list queries, the results will not contain the properties for total pages, page, or page size. However, the result property will still be an array containing zero or more objects.

Non-Paged Query Sample Repsonse

{
    "success": true,
    "requestId": "J59602219",
    "totalCount": 21,
    "isPaged": false,
    "result": [
        {...},
        {...}
    ]
}

Response Properties

Property Description
success Indicates whether the web service call was successful.
requestId Unique identifier for the request. Used for server-side debugging.
totalCount Total number of records in the query result.
isPaged Indicates whether the query is a paged query or not.
totalPages Total number of pages available on the server.
page Current page number in the paged query result.
pageSize Number of records per page in the paged query result.
result Array containing the query result objects.