This method returns a list of completed inspections for the given equipment id.
Parameters
Your request data may contain the following parameters. GET or POST the object (as JSON) tohttps://api.kpaehs.com/v1/inspections.list
.
Parameter | TypeScript | Example | Required | Description |
---|---|---|---|---|
token |
string |
"YOUR_TOKEN" |
Required | Your API Token |
pretty |
boolean |
true |
Optional | true means the response json will include white space for readability. Default is false . |
equipment_id |
string |
"5804f0f30ef50473af5870c6" |
Required | The id of the equipment. |
Example Request
Example Response
{ "inspections": [ { "equipment_id": "5804f0f80ef50473af587891", "created": 1440799232046, "equipmentType_id": "5804f0f80ef50473af587886", "schedule_id": "5804f0f80ef50473af587888", "inspector_id": "5804f0f40ef50473af5870e9", "date": 1456898400000, "notes": "This is a test.", "id": "5804f0f80ef50473af5878eb" }, { "equipment_id": "5804f0f80ef50473af587891", "created": 1464393732104, "equipmentType_id": "5804f0f80ef50473af587886", "schedule_id": "5804f0f80ef50473af587887", "inspector_id": "5804f0f40ef50473af587101", "date": 1475470800000, "notes": "This is a test.", "id": "5804f0f80ef50473af5878ec" } ], "ok": true }
Errors
If an error occurs, the response JSON will have ok
set to false
:
{ "ok": false, "error": "token_invalid", "description": "The token `YOUR_TOKEN` was not found." }
The error
field will contain one of the following error identifiers and there
may also be a description field with a more detailed explanation:
Identifier | Description |
---|---|
api_method_not_found |
The requested url did not match any KPA Flex API method. |
request_method_invalid |
The requested method was not GET or POST. |
request_data_invalid |
The request did not include a valid JSON request object. |
rate_limit_exceeded |
This token is exceeding its request limit. |
token_missing |
The request did not include a token. |
token_invalid |
The request token was invalid. |
token_inactive |
The request token was has been deactivated. |
token_permission |
The request token does not have write permission. |
account_inactive |
The request token was for an account that is not active. |
parameter_unexpected |
The request data included a parameter that is not supported. |
parameter_missing |
The request data failed to include a parameter which was required. |
parameter_invalid |
The request data included a parameter which had a value that is not allowed. |
server_error |
The server encountered an internal error. |
content_not_found |
The requested content was not found. |