10.4 Resources: groups

GET /groups/{group_id}

Type: Collection of Groups

Retrieves a list of group.

$ curl 'http://api.soundcloud.com/groups'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<groups type="array">
  <group>
    <id type="integer">1</id>
    <name>The Name of the Group</name>
    ...
  </group>
  <group>
    <id type="integer">2</id>
    <name>The Name of the Other Group</name>
    ...
  </group>
</groups>

GET /groups/{group_id}

Type: Group

Retrieves the given group.

$ curl 'http://api.soundcloud.com/groups/1'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<group>
  <id type="integer">1</id>
  <name>The Name of the Group</name>
  ...
</group>

GET /groups/{group_id}/users

Type: User

Retrieves the combined collection of moderators of, members of and contributors to the given group.

$ curl 'http://api.soundcloud.com/groups/1/users'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id type="integer">1</id>
    ...
  </user>
  <user>
    <id type="integer">2</id>
    ...
  </user>
  <user>
    <id type="integer">3</id>
    ...
  </user>
  ...
</users>

GET /groups/{group_id}/moderators

Type: User

Retrieves the collection of moderators of the given group.

$ curl 'http://api.soundcloud.com/groups/1/moderators'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id type="integer">1</id>
    ...
  </user>
  ...
</users>

GET /groups/{group_id}/members

Type: User

Retrieves the collection of members of the given group.

$ curl 'http://api.soundcloud.com/groups/1/members'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id type="integer">2</id>
    ...
  </user>
  ...
</users>

GET /groups/{group_id}/contributors

Type: User

Retrieves the collection of contributors to the given group.

$ curl 'http://api.soundcloud.com/groups/1/contributors'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<users>
  <user>
    <id type="integer">3</id>
    ...
  </user>
  ...
</users>

GET /groups/{group_id}/tracks

Type: Collection of Tracks

Retrieves the collection of Tracks contributed to the given group.

$ curl 'http://api.soundcloud.com/groups/1/tracks'

< HTTP/1.1 200 OK

<?xml version="1.0" encoding="UTF-8"?>
<tracks>
  <track>
    <id type="integer">123</id>
    <title>I Scream</title>
    ...
  </track>
  <track>
    <id type="integer">124</id>
    <title>You Scream</title>
    ...
  </track>
  <track>
    <id type="integer">125</id>
    <title>We All Scream</title>
    ...
  </track>
  <track>
    <id type="integer">126</id>
    <title>For Ice Cream</title>
    ...
  </track>
  ...
</tracks>