GETapi.synup.com/api/v4/locations/photos/requests/{requestId}
Check Bulk Photo Upload Status
This API monitors the progress of uploading multiple photos to a location, which is particularly useful when the upload involves more than 30 photos.
Retrieve the current status of a bulk image upload request for a location. Use the requestId returned in the Upload Photos API to fetch the status.
For more details, refer to Manage photos for your location.
Requires an API key. Send it as
Authorization: API <your-key> — see Getting started.Parameters
Path
| Name | Type | Required | Description |
|---|---|---|---|
requestId | string | required | Request ID returned from bulk upload photos API |
Request
Request
curl -X GET 'https://api.synup.com/api/v4/locations/photos/requests/:requestId' \
-H 'Authorization: API YOUR_API_KEY' \
-H 'Content-Type: application/json'const res = await fetch('https://api.synup.com/api/v4/locations/photos/requests/:requestId', {
method: 'GET',
headers: {
Authorization: 'API YOUR_API_KEY',
'Content-Type': 'application/json',
},
});
const data = await res.json();import requests
res = requests.get(
"https://api.synup.com/api/v4/locations/photos/requests/:requestId",
headers={
"Authorization": "API YOUR_API_KEY",
"Content-Type": "application/json",
},
)
data = res.json()req, _ := http.NewRequest("GET", "https://api.synup.com/api/v4/locations/photos/requests/:requestId", nil)
req.Header.Set("Authorization", "API YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)Responses
| Status | Description |
|---|---|
200 | Successfully retrieved upload status |
Example response
{
"data": {
"getLocationPhotosUploadStatus": {
"requestId": "e6c2d9d9-9a18-4015-88cf-9a4e19a6f49a",
"status": "SUCCESS"
}
}
}Response body
| Name | Type | Required | Description |
|---|---|---|---|
data | object | optional | |
data.getLocationPhotosUploadStatus | object | optional | |
data.getLocationPhotosUploadStatus.status | string | optional | Current status of the upload process:
PROCESSINGSUCCESSERROR |
data.getLocationPhotosUploadStatus.requestId | string | optional | The ID of the bulk upload request |