Applies to integrated customers using the RecoveryConnect APIAdd Case Photos
Description: This endpoint uploads and associates photos with a specific order (case). Photos may include images of the vehicle, damage, or other relevant case evidence.
URL: /api/v130/orders/{order_id}/photos
Method: POST
Request Body Parameters:
| PARAMETER | DESCRIPTION | MANDATORY | EXAMPLE |
| file_name | Original name of the uploaded file | Yes | Test |
| image_name | Display name or caption for the image | Yes | image name |
| picture_time | Date and time when the photo was taken (YYYY-MM-DD HH:mm:ss) | Yes | 2019-10-17 23:23:00 |
| data | Base64-encoded string of the image file | Yes | iVBORw0KGgoAAAANSUhEUg… |
| type | Numeric code representing photo type | Yes | 2 |
Success Code: 200 OK – Request Successful
Example:
URL: https://stg-api.mbsisystems.com/api/v130/orders/56934626/photos |
Request Body:
{ "file_name": "test", "image_name": "image name", "picture_time": "2019-10-17 23:23:00", "data": "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNk+A8AAQUBAScY42YAAAAASUVORK5CYII=", "type": 2 } |
Response:
{ "data": { "order_id": 2571069, "type": 0, "case_attachment_type_id": 1, "recovery_has_damage_type_location_id": null, "attachment_id": 6928498, "recovery_id": null } } |
View Case Photos
Description: This endpoint retrieves all photos associated with a specific order (case).
URL: /api/v130/orders/{order_id}/photos
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://stg-api.mbsisystems.com/api/v130/orders/56934626/photos |
Request Body: NA
Response:
{ "data": [ { "id": 6927964, "type": { "id": 1, "name": "Default", "always_show": 0, "is_required": 0, "type": null, "created_at": "2014-10-29 19:01:18", "updated_at": "2014-10-29 19:01:18", "deleted_at": "2014-10-29 19:01:18" }, "order_attachment_type_id": 11, "recovery_has_damage_type_location_id": null, "order_id": 2571069, "name": "Untitled", "photo_url": "https://dev-myrecovery.s3.us-east-2.amazonaws.com/orders/original/10001/86015/2020/07/07/3vVn1ShzhOWQ/raul-varzar-llRPgs-bF88-unsplash.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIARNJXFDAYINFZWO2G%2F20200717%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20200717T092756Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=a11d7c7b03a6e79c4833cacc7877bfb7263228803e93c340f2b4d52c019c3a6f", "filename": "raul-varzar-llRPgs-bF88-unsplash.jpg", "created_at": "2020-07-07", "meta": { "lat": "10.00000000", "long": "-10.00000000", "generated_at": "2019-10-17 23:23:00", "created_at": "2020-07-22T06:28:49.000000Z" }, "uploaded_by": { "id": 2423767, "firstname": "Neelima", "lastname": "Maheshwari" } } ] } |
View a Particular Case Photo
Description: This endpoint retrieves the details of a specific case photo by its photo_id.
URL: /api/v130/orders/{order_id}/photos/{photo_id}
Method: GET
Request Body Parameters: NA
Success Code: 200 OK – Request Successful
Example:
URL: https://stg-api.mbsisystems.com/api/v130/orders/56935508/photos/180423631 |
Request Body: NA
Response:
{ "data": { "id": 180423631, "type": { "id": 2, "name": "AR General Photo", "always_show": 1, "is_required": 0, "type": "photos", "created_at": "2020-01-20 15:12:10", "updated_at": "2020-06-27 06:26:39", "deleted_at": null }, "order_attachment_type_id": 2, "recovery_has_damage_type_location_id": null, "order_id": 56935508, "name": "image name", "photo_url": "https://stg-myrecovery-prod.s3.us-east-2.amazonaws.com/orders/original/10001/420712/2025/09/26/c1kp8uDZVkV7/420712_test.jpg?X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEAIaCXVzLWVhc3QtMiJIMEYCIQDPKXt%2FQNGiEyCX6HPxGoI8m6W1UkUAmhPzRdyu9Om5lwIhAMaK8yzotE6bM6%2FtHyilSk0hfCfo%2BCdJZq7Lbuwpr%2B%2FbKsIFCIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQAxoMOTU2MTMyMDIxMTg3IgyZyaGVwHkAO3sU0jsqlgVrC7s1pZqU6kbZS1RSaI4PGK0cGDoFVUXZAOPqonZNVVo%2BAl0cultXpN2YedbNwziOJifBy4IJ7OKWEwmxxqIZJEFVQG86IjE9Ki9%2F1olvKhjPPJhL%2B4e2cQxHH4Xfb6jIjYzWHn2xtI%2BGSMbrN%2B9q1OYLe1sNFURJs%2FOfhW1LhvF7PAtSyux7mJAVaSDXxXa%2FZ7ZCbrO6SEe2Wa01V9wnsP8n6SG9vk%2F8QEdNJLH1vLgCd8nyakUbn%2BINTUXS2Z%2BUCIelxMqO1y3xQVBxGC5J%2B02pMDkZx80kqzDpZxAYeYEQv%2Bb6767i%2BtB3DfZjJhBfzByvOwVKweON2q2cc6SyCBKan2pA1LDCETV%2FxWFfoUlHdSulb9lfH%2FzfnNr5vO6YeN1JH9tTQF1lcLMm1Jb1zUrhRF90Ml31ROUmsKJHmEJm%2BNJSqOuXj6h%2FcY8eyoytTUzt9o6u4wPnocw7xVUBhRauJcgv7FhrL7i894U2LgInrFMr%2BLuZZ9F6WovWPohQMCUf2J89l4Zt387zNHQVfaaA1rGb42arLbtB7eP6h20ERpa3ckJInvPBYf8GEa5vlAd5DbRJdCG6VRta41ddQBr%2F0YIRxMnu9vcIMuzr6KXi3Rs5ONy0aVz%2BuouMiNMwPAP0gD82cUUCWNi5C4omAOhcdIdimXytOLtjSs3wWq7QsFN1%2BBKhaHVs%2BQ8cee67sSOFtlHlOQnmw4Yzt16eY7er%2BKtozIklhr19KvGptUA7EFQpmwznSbphTkpsoAuzWQjDopUgWCsJSo08gMmgPtK2cYB3rvUE4tuaQwydzEX1GuwYFJKtlkiDX3bfN1cN4EZjVt1XF2qLGeIv%2BchJreg85HRl5QmHAae58k6AuoAZ7XwmRzDtv9nGBjqwAdfDCwO5rfdylYQ25nasXOsuSep4xmUUvizsnT%2Fr0LCjWslJzeoZA2Pr7utbrTI0dmbAykW%2Fyl5bkoAXR5MlzQc%2Fy%2FkhJyB5eQ3wXupV0p8NwORZBaJ5Lob9RnzAoTmsOHnnPq1AagtP9iWFTZxI4ysxlRq8acaZHYPGjQMcbxtzEZQtXK83HvItFeLhWtc8IbPauSdfv88ZLbQIBhr5otGYHfRfG7uDsNe6NPA5VVsu&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIA55HPI2PBTGR2M2ZV%2F20250926%2Fus-east-2%2Fs3%2Faws4_request&X-Amz-Date=20250926T103912Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1800&X-Amz-Signature=4ea52f4e53feda476a0f49dd88860454c90df96b67a0a30e1794ea749a683ca9", "filename": "420712_test.jpg", "uploaded_by": { "id": 136213399, "firstname": "Krishna", "lastname": "Agent" }, "created_at": "2025-09-26", "meta": { "lat": "12.00000000", "long": "-12.00000000", "generated_at": "2025-09-17 23:23:00", "created_at": "2025-09-26T10:38:33.000000Z" } } } |