POST v1/Groups/SearchBatch

The same as Search but you can enter multiple requests as a single batch to post to the server.

Request Information

Parameters

Name Type Description Additional information
batchRequest GroupSearchBatchRequest Container for the Group Search Batch Request input parameters. See parameter details below.

Define this parameter in the request body.

Request body formats

application/json, text/json

Sample:
{
  "requests": [
    {
      "query": "sample string 1",
      "maxResults": 2,
      "sdkVersion": "sample string 3"
    },
    {
      "query": "sample string 1",
      "maxResults": 2,
      "sdkVersion": "sample string 3"
    },
    {
      "query": "sample string 1",
      "maxResults": 2,
      "sdkVersion": "sample string 3"
    }
  ],
  "sdkVersion": "sample string 1"
}

application/xml, text/xml

Sample:
<GroupSearchBatchRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <SdkVersion>sample string 1</SdkVersion>
  <Requests>
    <GroupSearchRequest>
      <SdkVersion>sample string 3</SdkVersion>
      <MaxResults>2</MaxResults>
      <Query>sample string 1</Query>
    </GroupSearchRequest>
    <GroupSearchRequest>
      <SdkVersion>sample string 3</SdkVersion>
      <MaxResults>2</MaxResults>
      <Query>sample string 1</Query>
    </GroupSearchRequest>
    <GroupSearchRequest>
      <SdkVersion>sample string 3</SdkVersion>
      <MaxResults>2</MaxResults>
      <Query>sample string 1</Query>
    </GroupSearchRequest>
  </Requests>
</GroupSearchBatchRequest>

Parameter Information

Parameter Name: batchRequest

Property Type Description
Requests IList`1 A list of GroupSearchRequest objects. A max of 1000 requests will be processed.
SdkVersion String If the client is using the SDK, the version number will be passed along with the request. This field is optional.

Response Information

Response body formats

application/json, text/json

Sample:
{
  "errorOccurred": false,
  "errorMessages": [
    "sample string 1",
    "sample string 2",
    "sample string 3"
  ],
  "responses": [
    {
      "groups": [
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        },
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        },
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        }
      ],
      "errorOccurred": false,
      "errorMessages": [
        "sample string 1",
        "sample string 2",
        "sample string 3"
      ],
      "request": {
        "query": "sample string 1",
        "maxResults": 2,
        "sdkVersion": "sample string 3"
      }
    },
    {
      "groups": [
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        },
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        },
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        }
      ],
      "errorOccurred": false,
      "errorMessages": [
        "sample string 1",
        "sample string 2",
        "sample string 3"
      ],
      "request": {
        "query": "sample string 1",
        "maxResults": 2,
        "sdkVersion": "sample string 3"
      }
    },
    {
      "groups": [
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        },
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        },
        {
          "id": "sample string 1",
          "name": "sample string 2",
          "organizationCount": 3
        }
      ],
      "errorOccurred": false,
      "errorMessages": [
        "sample string 1",
        "sample string 2",
        "sample string 3"
      ],
      "request": {
        "query": "sample string 1",
        "maxResults": 2,
        "sdkVersion": "sample string 3"
      }
    }
  ]
}

application/xml, text/xml

Sample:
<GroupSearchBatchResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <ErrorMessages xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
    <d2p1:string>sample string 1</d2p1:string>
    <d2p1:string>sample string 2</d2p1:string>
    <d2p1:string>sample string 3</d2p1:string>
  </ErrorMessages>
  <ErrorOccurred>false</ErrorOccurred>
  <Responses>
    <GroupSearchResponse>
      <ErrorMessages xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>sample string 1</d4p1:string>
        <d4p1:string>sample string 2</d4p1:string>
        <d4p1:string>sample string 3</d4p1:string>
      </ErrorMessages>
      <ErrorOccurred>false</ErrorOccurred>
      <Request>
        <SdkVersion>sample string 3</SdkVersion>
        <MaxResults>2</MaxResults>
        <Query>sample string 1</Query>
      </Request>
      <Groups>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
      </Groups>
    </GroupSearchResponse>
    <GroupSearchResponse>
      <ErrorMessages xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>sample string 1</d4p1:string>
        <d4p1:string>sample string 2</d4p1:string>
        <d4p1:string>sample string 3</d4p1:string>
      </ErrorMessages>
      <ErrorOccurred>false</ErrorOccurred>
      <Request>
        <SdkVersion>sample string 3</SdkVersion>
        <MaxResults>2</MaxResults>
        <Query>sample string 1</Query>
      </Request>
      <Groups>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
      </Groups>
    </GroupSearchResponse>
    <GroupSearchResponse>
      <ErrorMessages xmlns:d4p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
        <d4p1:string>sample string 1</d4p1:string>
        <d4p1:string>sample string 2</d4p1:string>
        <d4p1:string>sample string 3</d4p1:string>
      </ErrorMessages>
      <ErrorOccurred>false</ErrorOccurred>
      <Request>
        <SdkVersion>sample string 3</SdkVersion>
        <MaxResults>2</MaxResults>
        <Query>sample string 1</Query>
      </Request>
      <Groups>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
        <Group>
          <Id>sample string 1</Id>
          <Name>sample string 2</Name>
          <OrganizationCount>3</OrganizationCount>
        </Group>
      </Groups>
    </GroupSearchResponse>
  </Responses>
</GroupSearchBatchResponse>