Get the list of phones for a specific client by client Id

get

/PASService/rest/services/v1/clients/{clientId}/phones

Gets a list of phones for a client based on the specified client Id.

Request

Path Parameters
Query Parameters
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "the name of the child resource". More than one child can be specified using comma as a separator. Example:?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers). More than one child can be specified using comma as a separator. For example: "?expand=Employees,Localizations". Nested children can also be provided following the format: "Child.NestedChild" For example:"?expand=Employees.Managers" If a nested child is provided (Example:Employees.Managers), the missing children will be processed implicitly i.e.,"?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers", which will expand both Employees and Managers.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY.

There's no request body for this operation.

Back to Top

Response

200 Response

This operation fetches the list of phones for a specific client by client Id successfully.
Back to Top

Examples

This example describes how to get a list of phones for a client based on the specified client Id.

Example cURL Command

Use the following cURL command to submit a request on the REST resource:

curl \
   -X GET \
   -H "Content-Type: application/json" \
   -u 'Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=' \
   -L "http://server:port/PASService/rest/services/v1/clients/E374F857-9A81-45F5-9A11-8186E04863BA/phones"

Example Response Body

The following shows an example of the response body in JSON format:

{
    "count": 1,
    "phones": [
        {
            "links": [
                {
                    "href": "http://server:port/PASService/rest/services/v1/clients/E374F857-9A81-45F5-9A11-8186E04863BA/phones/8BFA7382-DD6F-40F3-BC40-53239A5317ED",
                    "rel": "self",
                    "mediaType": "application/json",
                    "method": "GET"
                },
                {
                    "href": "http://server:port/PASService/rest/services/v1/codes?codeName=PhoneType&codeValue=02",
                    "rel": "codes/phoneType",
                    "mediaType": "application/json",
                    "method": "GET"
                },
                {
                    "href": "http://server:port/PASService/rest/services/v1/codes?codeName=PhoneStatus&codeValue=01",
                    "rel": "codes/status",
                    "mediaType": "application/json",
                    "method": "GET"
                }
            ],
            "countryCode": "US",
            "callingCode": "1",
            "phoneNumber": "5474456677",
            "preferred": "Y",
            "phoneType": "02",
            "phoneId": "8BFA7382-DD6F-40F3-BC40-53239A5317ED",
            "status": "01",
            "type": "01"
        }
    ]
}

Back to Top