> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.crowdchange.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Find Team

> Search CrowdChange fundraising teams server-side with rich filters and retrieve a paginated list with captain, goal, and raised totals for each.

## Body

<ParamField body="text" type="string">
  Search term.
</ParamField>

<ParamField body="page" type="integer">
  Page number. Default: `1`
</ParamField>

<ParamField body="limit" type="integer">
  Number of results to return. Default: `100`
</ParamField>

<ParamField body="sort" type="string">
  Key to sort by. Allowed values: `id`, `name`, `amount_raised`, `amount_goal`
</ParamField>

<ParamField body="direction" type="string">
  Direction of sorting. Allowed values: `asc`, `desc`
</ParamField>

<ParamField body="email" type="string">
  Email filter.
</ParamField>

<ParamField body="created_at" type="object">
  Team's creation date filter.

  <Expandable title="properties">
    <ParamField body="<" type="string" />

    <ParamField body="<=" type="string" />

    <ParamField body="=" type="string" />

    <ParamField body=">=" type="string" />

    <ParamField body=">" type="string" />
  </Expandable>
</ParamField>

<ParamField body="amount_goal" type="object">
  Team's amount goal filter.

  <Expandable title="properties">
    <ParamField body="<" type="number" />

    <ParamField body="<=" type="number" />

    <ParamField body="=" type="number" />

    <ParamField body=">=" type="number" />

    <ParamField body=">" type="number" />
  </Expandable>
</ParamField>

<ParamField body="amount_raised" type="object">
  Team's amount raised filter.

  <Expandable title="properties">
    <ParamField body="<" type="number" />

    <ParamField body="<=" type="number" />

    <ParamField body="=" type="number" />

    <ParamField body=">=" type="number" />

    <ParamField body=">" type="number" />
  </Expandable>
</ParamField>

<ParamField body="fundraiser_id" type="integer">
  Campaign ID filter.
</ParamField>

<ParamField body="after_id" type="integer">
  Return teams after Team ID.
</ParamField>

<ParamField body="lang" type="string">
  API's locale. Allowed values: `en`, `fr`
</ParamField>

<ParamField body="filter_by_lang" type="integer">
  Filter teams only available in locale
</ParamField>

<ParamField body="tags" type="string[]">
  List of fundraiser tags.
</ParamField>

## Response

Returns an array of objects with the following fields.

<ResponseField name="id" type="integer">
  Team ID.
</ResponseField>

<ResponseField name="transaction_id" type="integer">
  Transaction ID (if was created through transaction).
</ResponseField>

<ResponseField name="name" type="string">
  Team name.
</ResponseField>

<ResponseField name="amount_goal" type="number">
  Goal amount.
</ResponseField>

<ResponseField name="amount_raised" type="number">
  Amount raised by the team.
</ResponseField>

<ResponseField name="created_at" type="string">
  Creation date
</ResponseField>

<ResponseField name="language" type="string">
  Team language. Allowed values: `en`, `fr`
</ResponseField>

<ResponseField name="fundraiser" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      Fundraiser ID
    </ResponseField>

    <ResponseField name="partner_id" type="integer">
      Site ID.
    </ResponseField>

    <ResponseField name="fundraiser_template_id" type="integer">
      Template ID.
    </ResponseField>

    <ResponseField name="name" type="string">
      Fundraiser name
    </ResponseField>

    <ResponseField name="url" type="string">
      Fundraiser URL
    </ResponseField>

    <ResponseField name="amount_goal" type="number">
      Fundraiser goal amount.
    </ResponseField>

    <ResponseField name="user" type="object">
      <Expandable title="properties">
        <ResponseField name="id" type="integer">
          Fundraiser owner's ID
        </ResponseField>

        <ResponseField name="email" type="string">
          Fundraiser owner's email
        </ResponseField>

        <ResponseField name="first_name" type="string">
          Fundraiser owner's first name
        </ResponseField>

        <ResponseField name="last_name" type="string">
          Fundraiser owner's last name
        </ResponseField>

        <ResponseField name="title" type="string">
          Fundraiser owner's title
        </ResponseField>

        <ResponseField name="name" type="string">
          Fundraiser owner's name
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="fundraiser_template" type="object">
      <Expandable title="properties">
        <ResponseField name="id" type="integer">
          Template ID.
        </ResponseField>

        <ResponseField name="name" type="string">
          Template Name.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="dt_start" type="string">
      Date and time when campaign starts.
    </ResponseField>

    <ResponseField name="dt_end" type="string">
      Date and time when campaign ends.
    </ResponseField>

    <ResponseField name="location" type="string">
      Campaign location.
    </ResponseField>

    <ResponseField name="organization_name" type="string">
      Organization associated with campaign.
    </ResponseField>

    <ResponseField name="tags_list" type="any[]">
      Campaign tags.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="user" type="object">
  <Expandable title="properties">
    <ResponseField name="id" type="integer">
      Team captain's ID
    </ResponseField>

    <ResponseField name="email" type="string">
      Team captain's email
    </ResponseField>

    <ResponseField name="first_name" type="string">
      Team captain's first name
    </ResponseField>

    <ResponseField name="last_name" type="string">
      Team captain's last name
    </ResponseField>

    <ResponseField name="title" type="string">
      Team captain's title
    </ResponseField>

    <ResponseField name="name" type="string">
      Team captain's name
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="custom_data" type="object[]">
  List of custom questions and responses.

  <Expandable title="properties">
    <ResponseField name="field_id" type="integer">
      Custom field id.
    </ResponseField>

    <ResponseField name="source_id" type="integer">
      If field was copied from Blueprint, this will reference the source field id from blueprint (similar to group id).
    </ResponseField>

    <ResponseField name="name" type="string">
      Custom field label.
    </ResponseField>

    <ResponseField name="content" type="string">
      User's answer to custom field.
    </ResponseField>

    <ResponseField name="field_custom_id" type="string">
      Custom ID.
    </ResponseField>

    <ResponseField name="response_custom_id" type="string">
      Custom ID for the response (multiple choice questions).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="team_captain_mailing_address" type="object">
  Team captain's mailing information. This can be registrant's address, or mailing address, or billing address.

  <Expandable title="properties">
    <ResponseField name="address" type="string">
      Street Address.
    </ResponseField>

    <ResponseField name="city" type="string">
      City.
    </ResponseField>

    <ResponseField name="state" type="string">
      State or province.
    </ResponseField>

    <ResponseField name="zip" type="string">
      Zip or Postal code.
    </ResponseField>

    <ResponseField name="country" type="string">
      ISO 3166-1 alpha-2 country code.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="url" type="string">
  Full URL to team's page.
</ResponseField>

**Other responses**

| Status | Description |
| ------ | ----------- |
| `400`  | Bad Request |
| `403`  | Forbidden   |

<ResponseExample>
  ```json theme={null}
  [
    {
      "id": 1,
      "transaction_id": 12345678,
      "name": "Team A",
      "amount_goal": 1000,
      "amount_raised": 550,
      "created_at": "2022-03-01 00:00:00",
      "language": "en",
      "fundraiser": {
        "id": 101,
        "partner_id": 10,
        "fundraiser_template_id": 1,
        "name": "Gala Night",
        "url": "https://demo.crowdchange.co/101",
        "amount_goal": 1000,
        "user": {
          "id": 1,
          "email": "john@example.com",
          "first_name": "John",
          "last_name": "Snow",
          "title": "Mr.",
          "name": "John Snow"
        },
        "fundraiser_template": {
          "id": 1,
          "name": "Template"
        },
        "dt_start": "2021-01-01 08:00:00",
        "dt_end": "2021-01-01 16:00:00",
        "location": "100 Main Street, Toronto, ON",
        "organization_name": "Company Inc.",
        "tags_list": [
          "tag1",
          "tag2"
        ]
      },
      "user": {
        "id": 1,
        "email": "john@example.com",
        "first_name": "John",
        "last_name": "Snow",
        "title": "Mr.",
        "name": "John Snow"
      },
      "custom_data": [
        {
          "field_id": 1001,
          "source_id": 11,
          "name": "Phone Number",
          "content": "555-123-4567",
          "field_custom_id": "ABC-123",
          "response_custom_id": "ABC-123"
        }
      ],
      "team_captain_mailing_address": {
        "address": "100 Main Street",
        "city": "Toronto",
        "state": "ON",
        "zip": "XXX XXX",
        "country": "CA"
      },
      "url": "https://demo.crowdchange.co/1/team/2"
    }
  ]
  ```
</ResponseExample>
