2312: Get preference group opt-in status

Owned by Nick Jensen
Last updated: Jul 10, 2018Version comment
1 min read

Fetch entity preference subscription details for all preferences in a group

Endpoint ID:2312
Method:

GET

URL:

/preferences/entity/id/{entityID}/group/{groupID}

/preferences/entity/ext-key/{ext-key}/{ext-type}/group/{groupID}


entityIDRubiq master ID that uniquely identifies the entity

ext-keyExternal key that uniquely identifies the entity

ext-typeType of external key

groupIDA GUID string identifier for the group
Request body:None

Response body:

JSON data containing an array of all preferences in the group, with the preferenceID and a boolean optedIn property indicating the entity's preference subscription status

The entity has opted in to a single preference in this group
{
    "entityPreferences": [
        {
            "preferenceID": "7a6776a3-9411-4d34-9866-99aa9ac7cc27",
            "optedIn": false
        },
        {
            "preferenceID": "dd9eaf78-18ff-44ea-9717-25b103060643",
            "optedIn": true
        }
    ]
}
Status codes:200OK

404

The entity was not found

The following sub codes may be returned:

404.1 Entity not found

404.2 External entity reference not found

404.5 Group not found