Skip to content

GET/albums/{id}

Get album by ID

Retrieve a single album. Supports ETag conditional requests via `If-None-Match`.

Parameters 4

NameTypeDescription
_fieldsquery · stringSparse fieldset — comma-separated fields to return. Leave blank for the full object.
_expandquery · stringExpand parent relations inline. Applies only when the resource has a matching parent (e.g. `user` on posts).
_embedquery · stringEmbed child collections. Applies only when the resource has a matching child (e.g. `comments` on posts).

ReturnsAlbum

Bearer token required

Response examples

200The album

application/json example derived from schema

{
  "id": 1,
  "userId": 1,
  "title": "Abstract",
  "description": "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
  "coverImage": "https://picsum.photos/seed/album1/600/400",
  "photoCount": 39,
  "isPublic": true,
  "createdAt": "2024-07-02T09:01:49.954Z"
}
404404 — resource not found

application/json

{
  "error": {
    "status": 404,
    "message": "users #999 not found"
  }
}

Released under the MIT License.