---
title: "Search for Tasks"
method: POST
path: "/tasks/search"
tags: ["Tasks"]
---

# Search for Tasks

`POST /tasks/search`

This endpoint doesn't consume Apollo credits. Learn more about [API pricing and credits](https://docs.apollo.io/docs/api-pricing).

<a href="https://knowledge.apollo.io/hc/en-us/articles/28705458602125-Tasks-Overview" target="_blank">Tasks</a> let you track, prioritize, and help you complete actions required for your outbound sales motion.<br><br>Use the Search for Tasks endpoint to find tasks that your team has created in Apollo.<br><br>To protect Apollo's performance for all users, this endpoint has a display limit of 50,000 records (100 records per page, up to 500 pages). Add more filters to narrow your search results as much as possible.<br><br>This endpoint requires a master API key. If you call the endpoint without a master key, you receive a `403` response. Check out <a href="https://docs.apollo.io/docs/create-api-key">Create an API Key</a> to learn how to create a master key.

## Query parameters

- `sort_by_field` string
- `open_factor_names[]` string[]
- `page` integer
- `per_page` integer

## Response `200`

200

- object
  - `tasks` object[]
    - `emailer_campaign_id` unknown
    - `id` string
    - `user_id` string
    - `created_at` string
    - `completed_at` unknown
    - `note` unknown
    - `skipped_at` unknown
    - `due_at` string
    - `type` string
    - `priority` string
    - `status` string
    - `answered` unknown
    - `contact_id` unknown
    - `person_id` unknown
    - `account_id` unknown
    - `organization_id` unknown
    - `persona_ids` unknown[]
      - unknown
    - `subject` unknown
    - `created_from` unknown
    - `salesforce_type` unknown
    - `playbook_step_ids` unknown[]
      - unknown
    - `playbook_id` unknown
    - `needs_playbook_autoprospecting` unknown
    - `starred_by_user_ids` unknown[]
      - unknown
    - `salesforce_id` unknown
    - `hubspot_id` unknown
    - `opportunity_id` string
    - `title` string
    - `rule_config_id` unknown
    - `creator_id` string
    - `opportunity` object
      - `id` string
      - `team_id` string
      - `owner_id` string
      - `salesforce_owner_id` unknown
      - `amount` integer
      - `closed_date` string
      - `account_id` string
      - `description` unknown
      - `is_closed` boolean
      - `is_won` unknown
      - `name` string
      - `stage_name` unknown
      - `opportunity_stage_id` string
      - `source` string
      - `salesforce_id` unknown
      - `created_at` string
      - `actual_close_date` unknown
      - `next_step` string
      - `next_step_date` unknown
      - `closed_lost_reason` unknown
      - `closed_won_reason` unknown
      - `forecast_category` string
      - `deal_probability` integer
      - `created_by_id` string
      - `current_solutions` unknown
      - `deal_source` unknown
      - `manually_updated_probability` unknown
      - `manually_updated_forecast` unknown
      - `crm_id` unknown
      - `crm_record_url` unknown
      - `crm_owner_id` unknown
      - `probability` unknown
      - `opportunity_pipeline_id` string
      - `stage_updated_at` string
      - `next_step_last_updated_at` string
      - `exchange_rate_code` string
      - `exchange_rate_value` integer
      - `amount_in_team_currency` integer
      - `forecasted_revenue` integer
      - `last_activity_date` string
      - `existence_level` string
      - `typed_custom_fields` object
        - `6095a711bd01d100a506d4da` string[]
        - `6095a711bd01d100a506d4dc` string[]
        - `66e4ba346fe95a073461e00e` string[]
      - `opportunity_rule_config_statuses` unknown[]
        - unknown
      - `opportunity_contact_roles` object[]
        - `id` string
        - `contact_id` string
        - `is_primary` boolean
        - `created_at` string
        - `updated_at` string
        - `role` object[]
          - `opportunity_contact_role_type_id` string
          - `crm_role_id` unknown
          - `is_primary` boolean
          - `crm_id` unknown
      - `currency` object
        - `name` string
        - `iso_code` string
        - `symbol` string
      - `account` object
        - `id` string
        - `domain` string
        - `name` string
        - `team_id` string
        - `organization_id` string
        - `account_stage_id` string
        - `source` string
        - `original_source` string
        - `creator_id` unknown
        - `owner_id` unknown
        - `created_at` string
        - `phone` unknown
        - `phone_status` string
        - `hubspot_id` unknown
        - `salesforce_id` unknown
        - `crm_owner_id` unknown
        - `parent_account_id` unknown
        - `linkedin_url` unknown
        - `account_playbook_statuses` unknown[]
          - unknown
        - `account_rule_config_statuses` object[]
          - `_id` string
          - `created_at` unknown
          - `rule_action_config_id` string
          - `rule_config_id` string
          - `status_cd` string
          - `updated_at` unknown
          - `id` string
          - `key` string
        - `existence_level` string
        - `label_ids` string[]
        - `typed_custom_fields` object
        - `custom_field_errors` unknown
        - `modality` string
        - `source_display_name` string
        - `crm_record_url` unknown
        - `contact_emailer_campaign_ids` unknown[]
          - unknown
        - `contact_campaign_status_tally` object
        - `num_contacts` integer
        - `last_activity_date` unknown
  - `breadcrumbs` unknown[]
    - unknown
  - `pagination` object
    - `page` integer
    - `per_page` integer
    - `total_entries` integer
    - `total_pages` integer
  - `faceting` object
    - `playbook_step_facets` unknown[]
      - unknown
    - `person_function_facets` unknown[]
      - unknown
    - `person_seniority_facets` unknown[]
      - unknown
    - `normalized_person_title_facets` unknown[]
      - unknown
    - `organization_ids_facets` unknown[]
      - unknown
    - `organization_ids_in_query_facets` unknown[]
      - unknown
    - `person_persona_facets` unknown[]
      - unknown
    - `organization_keywords_facets` unknown[]
      - unknown
    - `linkedin_industry_facets` unknown[]
      - unknown
    - `num_employees_facets` unknown[]
      - unknown
    - `revenues_facets` unknown[]
      - unknown
    - `currently_using_any_of_technology_uids_facets` unknown[]
      - unknown
    - `currently_using_all_of_technology_uids_facets` unknown[]
      - unknown
    - `currently_not_using_any_of_technology_uids_facets` unknown[]
      - unknown
    - `added_technology_uids_facets` unknown[]
      - unknown
    - `dropped_technology_uids_facets` unknown[]
      - unknown
    - `latest_funding_stage_facets` unknown[]
      - unknown
    - `organization_trading_status_facets` unknown[]
      - unknown
    - `person_city_facets` unknown[]
      - unknown
    - `person_state_facets` unknown[]
      - unknown
    - `person_country_facets` unknown[]
      - unknown
    - `organization_hq_city_facets` unknown[]
      - unknown
    - `organization_hq_state_facets` unknown[]
      - unknown
    - `organization_hq_country_facets` unknown[]
      - unknown
    - `organization_intent_scoring_facets` unknown[]
      - unknown
    - `forecast_category_facets` unknown[]
      - unknown
    - `intent_topic_count_facets` unknown[]
      - unknown
    - `task_types` object[]
      - `value` string
      - `display_name` string
      - `count` integer
    - `total_facets` object[]
      - `value` string
      - `display_name` string
      - `count` integer
    - `linkedin_task` unknown[]
      - unknown
    - `contact_stage_facets` unknown[]
      - unknown
  - `pipeline_total` integer
  - `num_fetch_result` unknown

## Other responses

- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.net/apollo/apis/apollo-rest-api.md) · [All operations](https://skmtc.net/apollo/apis/apollo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/apollo/apollo-rest-api/versions/c715a05fa6e2/schema)