# Retrieve all albums the caller has access to **GET /album/getAlbums** ## Servers - Production server: https://public-api.joinswsh.com (Production server) ## Authentication methods - Api key auth ## Parameters ### Query parameters - **limit** (integer) The maximum number of albums to retrieve - **cursor** (string) A cursor received from a previous request to retrieve the next page of results - **search** (string) A search query to filter albums by name (case-insensitive, substring match) - **relationship** (string) Filter albums by relationship to the caller (e.g., "Admin", "Participant") ## Responses ### 200 Albums retrieved successfully #### Body: application/json (object) - **data** (array[object]) - **cursor** (string) A cursor to be used in subsequent requests to retrieve the next page of results. If this is `{}`, there are no more results to retrieve. - **warnings** (array[string]) ### 400 Invalid request. The request was malformed or missing required parameters. #### Body: application/json (object) - **message** (string) [Powered by Bump.sh](https://bump.sh)