---
title: "Get Bulk Enrich Results"
method: GET
path: "/contact/enrich/bulk/{enrichment_id}"
---

# Get Bulk Enrich Results

`GET /contact/enrich/bulk/{enrichment_id}`

## Request

- Base URL: `https://app.fullenrich.com/api/v2`
- URL: `https://app.fullenrich.com/api/v2/contact/enrich/bulk/{enrichment_id}`
- Auth: HTTP bearer

Use this endpoint to retrieve the result from an enrich.

## Path parameters

- `enrichment_id` string, required

## Query parameters

- `forceResults` boolean

## Response `200`

OK

- ResponseGetContactBulkEnrich
  - `id` string, uuid
  - `name` string
  - `status` 'CREATED' | 'IN_PROGRESS' | 'CANCELED' | 'CREDITS_INSUFFICIENT' | 'FINISHED' | 'RATE_LIMIT' | 'UNKNOWN'
  - `data` RecordEnrichment[]
    - `input` ContactEnrichmentInput: The input data originally provided for this contact enrichment
      - `first_name` string: First name of the contact
      - `last_name` string: Last name of the contact
      - `full_name` string: Full name of the contact
      - `company_domain` string: Domain of the contact's company
      - `company_name` string: Name of the contact's company
      - `professional_network_url` string: Professional network profile URL of the contact
    - `custom` object: Custom fields passed during enrichment request, returned unchanged
    - `contact_info` ContactEnrichedInformation: Contact information found during enrichment
      - `most_probable_work_email` Email
        - `email` string
        - `status` 'DELIVERABLE' | 'HIGH_PROBABILITY' | 'CATCH_ALL' | 'INVALID' | 'INVALID_DOMAIN'
      - `most_probable_personal_email` Email
        - `email` string
        - `status` 'DELIVERABLE' | 'HIGH_PROBABILITY' | 'CATCH_ALL' | 'INVALID' | 'INVALID_DOMAIN'
      - `most_probable_phone` Phone
        - `number` string: Phone number formatted for international display
        - `region` string: ISO 3166-1 alpha-2 country code where the phone number is registered (e.g., FR for France, US for United States)
        - `line_type` 'MOBILE' | 'LANDLINE' | 'VOIP' | 'UNKNOWN': Detected line type. Always present; UNKNOWN means no reliable type was available.
        - `line_status` 'ACTIVE' | 'INACTIVE' | 'UNKNOWN': Detected service status. Always present; UNKNOWN means no provider returned a reliable status.
        - `ownership_match` 'CONFIRMED' | 'MISMATCH': Ownership verdict for US and Canadian numbers. Omitted outside US/Canada or when no verdict is available.
        - `ownership_match_confidence` integer: Confidence for a confirmed US or Canadian mobile number. Omitted unless ownership_match is CONFIRMED and the line is not inactive.
        - `connect_rate` 'HIGHEST' | 'HIGH' | 'MEDIUM': Pickup-probability bucket for an active US or Canadian mobile number without an ownership mismatch. Omitted when unavailable or inapplicable.
      - `work_emails` Email[]: All work emails found
        - `email` string
        - `status` 'DELIVERABLE' | 'HIGH_PROBABILITY' | 'CATCH_ALL' | 'INVALID' | 'INVALID_DOMAIN'
      - `personal_emails` Email[]: All personal emails found
        - `email` string
        - `status` 'DELIVERABLE' | 'HIGH_PROBABILITY' | 'CATCH_ALL' | 'INVALID' | 'INVALID_DOMAIN'
      - `phones` Phone[]: All phone candidates found. May include landline, VoIP, inactive, and ownership-mismatch numbers that are not eligible for most_probable_phone.
        - `number` string: Phone number formatted for international display
        - `region` string: ISO 3166-1 alpha-2 country code where the phone number is registered (e.g., FR for France, US for United States)
        - `line_type` 'MOBILE' | 'LANDLINE' | 'VOIP' | 'UNKNOWN': Detected line type. Always present; UNKNOWN means no reliable type was available.
        - `line_status` 'ACTIVE' | 'INACTIVE' | 'UNKNOWN': Detected service status. Always present; UNKNOWN means no provider returned a reliable status.
        - `ownership_match` 'CONFIRMED' | 'MISMATCH': Ownership verdict for US and Canadian numbers. Omitted outside US/Canada or when no verdict is available.
        - `ownership_match_confidence` integer: Confidence for a confirmed US or Canadian mobile number. Omitted unless ownership_match is CONFIRMED and the line is not inactive.
        - `connect_rate` 'HIGHEST' | 'HIGH' | 'MEDIUM': Pickup-probability bucket for an active US or Canadian mobile number without an ownership mismatch. Omitted when unavailable or inapplicable.
    - `profile` Person
      - `id` string: Unique person identifier
      - `full_name` string: Person's full name
      - `first_name` string: Person's first name
      - `last_name` string: Person's last name
      - `headline` string: Short professional tagline written by the person on their professional network profile
      - `description` string: Free-text summary written by the person in the about section of their professional network profile. Omitted when not available.
      - `location` object: Person's location information
        - `country` string: Country name
        - `country_code` string: ISO country code
        - `city` string: City name
        - `region` string: Region or state
      - `social_profiles` PersonSocialProfile
        - `professional_network` object: Professional network profile information
          - `id` integer: Professional network profile ID
          - `url` string: Full professional network profile URL
          - `handle` string: Professional network profile handle/username
          - `connection_count` integer: Number of professional network connections
      - `educations` PersonEducation[]: Person's education history
        - `school_name` string: Name of the educational institution
        - `degree` string: Degree or qualification obtained
        - `start_at` string, date-time: Start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)
        - `end_at` string, date-time: End date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)
      - `languages` PersonLanguage[]: Languages spoken by the person
        - `language` string: Language name
        - `proficiency` string: Proficiency level in the language (e.g., 'NATIVE_OR_BILINGUAL', 'FULL_PROFESSIONAL', 'PROFESSIONAL_WORKING', 'LIMITED_WORKING', 'ELEMENTARY')
      - `skills` string[]: Person's professional skills
      - `employment` object: Person's employment history
        - `current` Employment
          - `title` string: Job title or position
          - `seniority` string: Seniority level of the person in the company
          - `job_functions` object[]: Job functions of the person in the company
            - `function` string: Job function
            - `sub_function` string: Sub function of the job function
          - `description` string: Description of the role and responsibilities. Not always present.
          - `company` EmploymentCompany
            - `id` string: Unique company identifier
            - `name` string: Company name
            - `domain` string: Company domain
            - `website` string: Company website URL as declared by the company. May differ from `domain` (can include a subdomain, a path or tracking parameters). Omitted when not available.
            - `description` string: Company description
            - `year_founded` integer: Year the company was founded. Returns 0 when unknown.
            - `headcount` integer: Exact number of employees. May return 0 even when headcount_range is available.
            - `headcount_range` string: Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+')
            - `company_type` string: Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency')
            - `specialties` string[]: Specialties associated with the company
            - `technologies` object[]: Technologies used by the company
              - …
            - `locations` object: Company location information
              - …
            - `industry` object: Company industry information
              - …
            - `social_profiles` CompanySocialProfile
              - …
            - `logo_url` string: URL of the company logo hosted by FullEnrich, built from the company's professional network handle. Empty when the handle is unknown.
          - `is_current` boolean: Whether this is the current employment
          - `start_at` string, date-time: Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)
          - `end_at` string, date-time: Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true).
        - `all` Employment[]: All employment history (current and past)
          - `title` string: Job title or position
          - `seniority` string: Seniority level of the person in the company
          - `job_functions` object[]: Job functions of the person in the company
            - `function` string: Job function
            - `sub_function` string: Sub function of the job function
          - `description` string: Description of the role and responsibilities. Not always present.
          - `company` EmploymentCompany
            - `id` string: Unique company identifier
            - `name` string: Company name
            - `domain` string: Company domain
            - `website` string: Company website URL as declared by the company. May differ from `domain` (can include a subdomain, a path or tracking parameters). Omitted when not available.
            - `description` string: Company description
            - `year_founded` integer: Year the company was founded. Returns 0 when unknown.
            - `headcount` integer: Exact number of employees. May return 0 even when headcount_range is available.
            - `headcount_range` string: Employee count range (e.g., '1-10', '11-50', '51-200', '201-500', '501-1000', '1001-5000', '5001-10000', '10001+')
            - `company_type` string: Type of company (e.g., 'Public Company', 'Privately Held', 'Nonprofit', 'Self-Employed', 'Partnership', 'Educational', 'Government Agency')
            - `specialties` string[]: Specialties associated with the company
            - `technologies` object[]: Technologies used by the company
              - …
            - `locations` object: Company location information
              - …
            - `industry` object: Company industry information
              - …
            - `social_profiles` CompanySocialProfile
              - …
            - `logo_url` string: URL of the company logo hosted by FullEnrich, built from the company's professional network handle. Empty when the handle is unknown.
          - `is_current` boolean: Whether this is the current employment
          - `start_at` string, date-time: Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)
          - `end_at` string, date-time: Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true).
  - `cost` Cost
    - `credits` integer: Number of credits consumed for this enrichment

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-11-03** `29391d7e33f8`: 4 breaking, 4 warning, 26 info
  - added `#/components/schemas/Phone, subschema #2` to the `data/items/contact_info/most_probable_phone` response property `oneOf` list for the response status `200`
  - added `#/components/schemas/Phone, subschema #2` to the `data/items/contact_info/most_probable_phone` response property `oneOf` list for the response status `402`
  - the `data/items/contact_info/most_probable_phone` response's property type changed from `object` to no type for status `200`
  - the `data/items/contact_info/most_probable_phone` response's property type changed from `object` to no type for status `402`
  - …30 more

[Operation history](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation/changes/contact/enrich/bulk/:enrichment_id/get.md)

---

[API](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation.md) - [All operations](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/fullenrich/apis/fullenrich-api-documentation/revisions/29391d7e33f8?raw)
