---
title: "Cancel batch of person enrichments"
method: PATCH
path: "/people/enrichment-requests/{id}"
tags: ["Person Enrichment"]
---

# Cancel batch of person enrichments

`PATCH /people/enrichment-requests/{id}`

Cancel batch of person enrichments

## Request body

- object
  - `status` 'canceled', required

## Response `200`

Successful

- ResponsePersonEnrichmentObject
  - `id` integer, required
  - `object` 'person_enrichment', required
  - `status` 'queued' | 'processing' | 'completed' | 'canceled' | 'error', required
  - `results` ResponsePersonEnrichmentResultObject[], required
    - `id` integer
    - `status` 'enriched' | 'not_found' | 'gdpr_removed', nullable
    - `result` ResponsePersonObject
      - `id` string, uuid, required
      - `object` 'person', required
      - `linkedin_url` string, required
      - `name` string, nullable
      - `email` string, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `title` string, nullable
      - `headline` string, nullable
      - `about` string, nullable
      - `current_position_start_date` string, date, nullable
      - `current_position_description` string, nullable
      - `location` string, nullable
      - `image_url` string, uri
      - `gender` 'male' | 'female' | 'likely_male' | 'likely_female' | 'unknown'
      - `location_details` ResponseLocationDetailsObject
        - `country` string, nullable
        - `state` string, nullable
        - `city` string, nullable
        - `postal_code` string, nullable
        - `lat` number, nullable
        - `long` number, nullable
      - `experiences` ResponseExperienceObject[], nullable
        - `object` 'experience', required
        - `title` string, required
        - `company_name` string, required
        - `company_linkedin_url` string, uri, nullable, required
        - `description` string, nullable, required
        - `start_date` string, date, nullable, required
        - `end_date` string, date, nullable, required
      - `educations` ResponseEducationObject[], nullable
        - `object` 'education', required
        - `degree` string, nullable, required
        - `field_of_study` string, nullable, required
        - `school_name` string, required
        - `school_linkedin_url` string, uri, nullable, required
        - `start_date` string, date, nullable, required
        - `end_date` string, date, nullable, required
      - `languages` ResponseLanguageObject[], nullable
        - `object` 'language', required
        - `language` string, required
        - `iso_code` string, required
        - `proficiency` string, nullable, required
      - `phone_numbers` ResponsePhoneNumberObject[], nullable
        - `object` 'phone_number', required
        - `id` string, uuid, required
        - `number` string, required
        - `type` 'mobile' | 'office' | 'phone' | 'landline' | 'voip' | 'direct', required
        - `source` 'amplemarket' | 'crm' | 'user_uploaded'
        - `is_wrong_number` boolean, required
        - `is_dnc_listed` boolean — Present only when the account has phone number DNC list enabled
      - `company` ResponseCompanyObject
        - `id` string, uuid, required
        - `object` 'company', required
        - `linkedin_url` string, required
        - `name` string, nullable
        - `overview` string, nullable
        - `website` string, nullable
        - `keywords` string[], nullable
        - `followers` integer, nullable
        - `linkedin_presence` 'massive' | 'large' | 'moderate' | 'limited' | 'none', nullable — `massive` — Massive following (100,000+ followers), `large` — Large following (10,000 - 99,999 followers), `moderate` — Moderate following (1,000 - 9,999 followers), `limited` — Limited following (1 - 999 followers), `none` — No following (0 followers). All ranges are inclusive.
        - `estimated_number_of_employees` integer, nullable
        - `size` '10001+ employees' | '201-500 employees' | '51-200 employees' | '11-50 employees' | '1-10 employees', nullable
        - `location` string, nullable
        - `location_details` ResponseLocationDetailsObject
          - `country` string, nullable
          - `state` string, nullable
          - `city` string, nullable
          - `postal_code` string, nullable
          - `lat` number, nullable
          - `long` number, nullable
        - `locations` ResponseLocationObject[], nullable
          - `address` string — Full address as a single string
          - `is_primary` boolean — Indicates if this is the primary location
          - `country` string, nullable — Country name (e.g., United States)
          - `state` string, nullable — State or subdivision name (e.g., California, New York)
          - `city` string, nullable — City name
          - `postal_code` string, nullable — Postal code
        - `logo_url` string, uri
        - `founded_year` integer, nullable
        - `traffic_rank` integer, nullable
        - `sic_codes` integer[], nullable
        - `naics_codes` integer[], nullable
        - `type` 'Public Company' | 'Educational' | 'Self Employed' | 'Government Agency' | 'Non Profit' | 'Self Owned' | 'Privately Held' | 'Partnership', nullable
        - `total_funding` integer, nullable
        - `latest_funding_stage` 'seed' | 'angel' | 'venture_round_unknown_series' | 'series_a' | 'series_b' | 'series_c' | 'series_d' | 'series_e' | 'series_f' | 'series_g' | 'series_h' | 'series_i' | 'series_j' | 'debt' | 'equity_crowdfunding' | 'convertible_note' | 'ico' | 'private_equity' | 'other', nullable
        - `latest_funding_date` string, date, nullable
        - `is_b2b` boolean, nullable
        - `is_b2c` boolean, nullable
        - `technologies` string[], nullable
        - `department_headcount` ResponseDepartmentHeadcountObject
        - `job_function_headcount` ResponseJobFunctionHeadcountObject
        - `estimated_revenue` '$0-$1M' | '$1M-$10M' | '$10M-$100M' | '$100M-$1B' | '$1B+', nullable
        - `revenue` integer, nullable
      - `linkedin_presence` 'influencer' | 'micro_influencer' | 'large' | 'moderate' | 'limited' | 'none', nullable — `influencer` — Influencer (10,000+ followers), `micro_influencer` — Micro Influencer (5,000 - 9,999 followers), `large` — Large following (500 - 4,999 followers), `moderate` — Moderate following (100 - 499 followers), `limited` — Limited following (1 - 99 followers), `none` — No following (0 followers). All ranges are inclusive.
    - `email` string, nullable
    - `linkedin_url` string, nullable
    - `company_domain` string, nullable
    - `company_name` string, nullable
    - `name` string, nullable
    - `title` string, nullable
  - `_errors` ResponseErrorObject[]
    - `code` string, required
    - `title` string, required
    - `detail` string, required
    - `source` object
      - `pointer` string
  - `_links` ResponseLinksObject, required
    - `self` ResponseLinkObject, required
      - `href` string, required
    - `prev` ResponseLinkObject
      - `href` string, required
    - `next` ResponseLinkObject
      - `href` string, required

## Other responses

- `400` — Bad request
- `404` — Not found

---

[API](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs.md) · [All operations](https://skmtc.dev/amplemarket/apis/amplemarket-api-v1-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/amplemarket/amplemarket-api-v1-docs/revisions/57f46eaa2dc9/schema)