Retrieve Client Photo Details
Retrieve the details of a specific photo associated with a client.
This endpoint retrieves the details of a specific photo associated with a client, including its name, size, created date, created user, and a downloadable URL for the actual image file.
Example Request:
curl "https://<your-agency>.smartmatchapp.com/api3/clients/<client_id>/photos/<photo_id>/" \
-u <token>: \
-X GET
Example Success Response:
{
"id": 1,
"name": "image_1.jpg",
"size": "0.02Mb",
"created_date": "2025-06-10T14:24:30.502Z",
"created_user_name": "User 1",
"created_user_id": 1,
"download_url": "https://<your-agency>.smartmatchapp.com/download/<key>/<agency>/"
}
Base Request:
Method: GET
Authentication: Basic Authentication. Requires a valid <token> passed.
Rate Limits:
30 requests within 10 seconds
Error Responses:
| 401 | Unauthorized |
This error occurs when the <token> is missing, invalid, or the API access is disabled. Possible errors: "not authenticated" or "token is disabled" or "Agency API is disabled" |
| 404 | Not Found |
This error occurs if the client or the photo with the specified ID does not exist. |
| 405 | Method Not Allowed |
This error occurs if an HTTP method other than GET is used (e.g., POST or PUT). |
| 429 | Too Many Requests |
This error occurs when the client has sent too many requests in a given amount of time, leading to rate limiting by the server. Possible errors: "too many requests" |
| 500 | Server Error |
Possible errors: "Internal server error" |