get groups

Gets all family library groups for a family

• If there are no groups it will return an empty array ([])

• Groups within the array response follow the same rules as "get a group" (GET /card/family/library/groups/{id})

Responses

200

200 OK application/json

Schema

[items]object

cardsarray

[items]

createdAtstring

familyIdstring

idstring

imageIdstring

imageUrlstring

itemsarray

[items]object

addedAtstring

contentIdstring

lastModifiedAtstring

namestring

JSON

[
  {
    "cards": [],
    "createdAt": "2024-09-27T15:30:05.433Z",
    "familyId": "65b120377258d846de4595d8",
    "id": "xHE4ZtAHbQ2f0EXlmCUxi",
    "imageId": "fp-cards",
    "imageUrl": "https://cdn.yoto.io/library/groups/fp-cards.png",
    "items": [
      {
        "addedAt": "2024-09-27T15:30:05.447Z",
        "contentId": "37KwQ"
      },
      {
        "addedAt": "2024-09-27T15:30:05.447Z",
        "contentId": "feNkK"
      }
    ],
    "lastModifiedAt": "2024-09-27T15:30:05.433Z",
    "name": "My Favourites"
  }
]

GET

/card/family/library/groups

Server URL: https://api.yotoplay.com

Authorization (bearerAuth)

Token

Try it out

cURL

curl "https://api.yotoplay.com/card/family/library/groups"
--header "Authorization: Bearer [YOUR_TOKEN]"

JavaScript

const options = {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer [YOUR_TOKEN]'
  }
};

fetch('https://api.yotoplay.com/card/family/library/groups', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

PHP

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yotoplay.com/card/family/library/groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer [YOUR_TOKEN]"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

Python

import requests

url = "https://api.yotoplay.com/card/family/library/groups"

headers = {
    "Authorization": "Bearer [YOUR_TOKEN]"
}

response = requests.request("GET", url, headers=headers)

print(response.text)