# Kernel in the Cloud

# KiC List

## Retrieve List  v1 - Latest

Used to request a single page of a report of Stores/Devices.

### Request

##### path Parameters
|     |     |
| --- | --- |
| reportGuid<br>required | string <= 36 characters  >= 36 ^[a-zA-Z0-9-]*$<br>Example: 485e0de2-fd7c-8e52-b932-1dc3cb896101 |
| reportId<br>required | integer |

### Responses

#### 200
Retrieve Device/Store Data

##### Response Schema: application/json

|     |     |
| --- | --- |
| \_links | object |
| |     |     |
| --- | --- |
| next | object<br>Link to get data for next page, Not present if this is result is the last page of results |
| |     |     |
| --- | --- |
| href | string <uri> <br>Example: "https://sandbox.api.visa.com/vacservices/v1/list/retrieve/3424bd66-1ed2-9h21-4fg6-130a14bsrb01/30001" | |
| self | object<br>Link to get data for current page |
| |     |     |
| --- | --- |
| href | string <uri> <br>Example: "https://sandbox.api.visa.com/vacservices/v1/list/retrieve/3424bd66-1ed2-9h21-4fg6-130a14bsrb01/101" | | |
| content | object<br>One of Devices/Stores Object |
| |     |     |
| --- | --- |
| devices | Array of objects |
| Array
|     |     |
| --- | --- |
| kernelProfileId | string<br>Kernel profile Id associated to VAC Device. |
| merchantProfile | string<br>Merchant profile Id to which the VAC Device belongs to. |
| status | string<br>Status of Device/Store in VAC. |
| statusChangeDateTime | string<br>Date on which the Status of Device/Store in VAC changed. |
| storeProfileId | string<br>Store profile Id associated to VAC Device/Merchant. |
| vacDeviceId | string<br>VAC Device Id | |
| stores | Array of objects |
| Array
|     |     |
| --- | --- |
| status | string<br>Status of Device/Store in VAC. |
| statusChangeDateTime | string<br>Date on which the Status of Device/Store in VAC changed. |
| storeProfileId | string<br>Store profile Id associated to VAC Device/Merchant. | | |

#### 404
When any field validation fails or when any required field is missing or when request is inconsistent with the Request definitions.

##### Response Schema: application/json

|     |     |
| --- | --- |
| errorResponse | object |
| |     |     |
| --- | --- |
| status<br>required | integer 3 characters <br>3 digit http status code<br>Example: 400 |
| details | Array of objects |
| Array
|     |     |
| --- | --- |
| location | string<br>The place in the incoming message that the particular error occurred. |
| message | string<br>The long description of the specific error that occurred. | |
| message | string<br>The long description of the error<br>Example: "No data yet, Please try again." |
| reason | string<br>The short description of the error.<br>Example: "DATA_NOT_FOUND_ERROR" | |

get/vacservices/v1/list/retrieve/{reportGuid}/{reportId}

Sandbox server

https://sandbox.api.visa.com/vacservices/v1/list/retrieve/{reportGuid}/{reportId}

### Copy

#### Response samples

- 200
- 404

application/json

### Copy

Expand allCollapse all

```
{"_links": {"next": {"href": "https://sandbox.api.visa.com/vacservices/v1/list/retrieve/3424bd66-1ed2-9h21-4fg6-130a14bsrb01/30001"},"self": {"href": "https://sandbox.api.visa.com/vacservices/v1/list/retrieve/3424bd66-1ed2-9h21-4fg6-130a14bsrb01/101"}},"content": {"stores": [{"status": "string","storeProfileId": "string","statusChangeDateTime": "string"}],"devices": [{"status": "string","vacDeviceId": "string","storeProfileId": "string","kernelProfileId": "string","merchantProfile": "string","statusChangeDateTime": "string"}]}}`