Endpoint URL

https://public-api.cloudidr.com/external/api/v1/policies/cyber/{cid_ext}/customer

HTTP Method

GET

Path Parameters

cid_ext (string, required): External customer ID. This value uniquely identifies the customer whose cyber policies are being queried.

Request Headers

1. Content-Type: application/json

2. Authorization: Bearer <your_access_token>

Request Parameters

1. page (integer, optional, default: 1): The page number for paginated results. Defaults to 1 if not provided.

2. pageSize (integer, optional, default: 10): The number of records per page. Defaults to 10 if not provided.

3. sort (string, optional, default: desc): Sorts the policies by their creation date in descending order by default

4. policyStatus (string, optional): The status code for filtering policies. Allowed values: READY_FOR_PURCHASE, ACTIVE, CANCELED, COMPLETED

5. policyName (string, optional): Filter results by the policy name.

Request Example

https://public-api.cloudidr.com/external/api/v1/policies/cyber/Zbm5qM7waoZa/customer?page=1&pageSize=20&policyStatus=CANCELED&sort=asc

Success Response (200 OK)

Success Response (200 OK)

Success Response (200 OK): No Results Found

{     
  "page": 0,     
  "pageSize": 20,   
  "totalPageNumbers": 0,     
  "totalElements": 0,    
  "values"

Error ResponsesUnauthorized (401 Unauthorized)

{    
  "error": {         
              "code": "401",       
              "message": "Unauthorized",      
              "details": {           
                            "timestamp": "2025-03-04T17:01:01",      
                            "description": "Unable to process access token"

Internal Server Error (500 Internal Server Error)

{     "error": {         
                  "code": "500",         
                  "message": "Internal Server Error",         
                  "details": {          
                                "timestamp": "2025-03-04T17:17:08",         
                                "description": "Unexpected error. Our team is working on it"