Viewing Groups

Query Parameters

limit=LIMIT

Limit the number of results to LIMIT.

offset=OFFSET

Skip OFFSET entries from the start. Only valid when limit is specified.

name=SUBSTR

description=SUBSTR

Search for groups by field name. If you specify more than one, they are concatenated with AND.

order=field name

Sort groups by field name. Not available for FFx30 models.

HTTP Request Line

GET /ffws/v1/contact_groups/USERNAME HTTP/1.1

GET /ffws/v1/contact_groups/global_contact_list HTTP/1.1

HTTP Response Status Codes

200 OK

Shows group information.

403 Forbidden

Authenticated user does not have permission to view this data.

404 Not Found

Groups not found for that user.

Example

GET /ffws/v1/contact_groups/admin HTTP/1.1
content-type: application/xml
authorization: Basic YWRtaW46YWRtaW4=
-----------------------------------
HTTP/1.1 200 OK
content-type: application/xml
<?xml version=”1.0” encoding=”UTF-8”?>
<response>
	<message>Success</message>
	<contact_group>
		<contact_group_url>https://172.16.128.5/ffws/v1/contact_groups/admin/4</contact_group_url>
		<name>g one</name>
		<description>g one</description>
		<contact>https://172.16.128.5/ffws/v1/contacts/admin/1</contact>
		<contact>https://172.16.128.5/ffws/v1/contacts/admin/2</contact>
		<contact>https://172.16.128.5/ffws/v1/contacts/global_contact_list/3</contact>
	</contact_group>
	<contact_group>
		<contact_group_url>https://172.16.128.5/ffws/v1/contact_groups/admin/6</contact_group_url>
		<name>g two</name>
		<description>g two org</description>
		<contact>https://172.16.128.5/ffws/v1/contacts/admin/2</contact>
		<contact>https://172.16.128.5/ffws/v1/contacts/global_contact_list/4</contact>
	</contact_group>
</response>