Join groups

POST

/groups/subscribe

Request membership to one or more groups.

NOTE: Any group with a has_questions field set to true will also require answers to the groups' new member questionnaire to be submitted. Groups waiting for answers will have their membership field set to 'pending-questions'. And the questionnaire that needs to be answered can be found in the membership.questionnaire field of the group after a subscribe request is made to that group.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://trashnothing.com/api/v1.2/groups/subscribe' \
--form 'group_ids=""'

Response Example

200 - Example 1

{
    "groups": [
        {
            "country": {
                "abbreviation": "CA",
                "name": "Canada"
            },
            "group_id": 46,
            "has_questions": true,
            "homepage": "https://trashnothing.com/OttawaReuse",
            "identifier": "OttawaReuse",
            "latitude": 45.423494,
            "longitude": -75.697933,
            "member_count": 4838,
            "membership": {
                "date": "2015-01-22T17:05:50",
                "questionnaire": {
                    "message": "This group is only for people who live in Ottawa.",
                    "questions": [
                        "Where do you live?"
                    ]
                },
                "status": "pending-questions"
            },
            "name": "Ottawa Reuse",
            "open_archives": false,
            "open_membership": false,
            "region": {
                "abbreviation": "ON",
                "name": "Ontario"
            },
            "timezone": "America/Toronto",
            "utc_offset": -5
        }
    ],
    "over_group_limit": true
}

Request

Body Params multipart/form-data

Responses

🟢200The groups with updated membership data.

application/json

Body

🟠400Missing or invalid parameters.

🟠404Group not found.

Modified at 2022-09-11 18:59:47

Retrieve multiple groups

Retrieve a group