Retrieve photos for a specific album

GET /album/getPhotos

Retrieves the photos in an album. A photo can be an image, live photo, or video.

Query parameters

  • albumId string Required

    ID of the album to retrieve preview photos for

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • data array[object] Required
      Hide data attributes Show data attributes object
      • photoId string Required
      • width integer
      • height integer
      • originalUrl string Required

        A signed URL to access the uploaded image. For videos, this is a thumbnail image.

      • stableUrl string Required

        A signed URL to access the stable version of the image (JPEG or WebP, <15 MB) or a thumbnail of the video (JPEG or WebP, <15 MB)

    • warnings array[string]
  • 404

    Album not found

GET /album/getPhotos
curl \
 --request GET 'https://public-api.joinswsh.com/album/getPhotos?albumId=22222222-2222-2222-2222-222222222222' \
 --header "x-api-key: $API_KEY"
Response examples (200)
{
  "data": [
    {
      "photoId": "string",
      "width": 42,
      "height": 42,
      "originalUrl": "string",
      "stableUrl": "string"
    }
  ],
  "warnings": [
    "Example warning"
  ]
}