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

# Get Enrichment Result

> Use this endpoint to retrieve the result from an enrich.
You don’t need to use this endpoint if you are using a webhook. Using a webhook is the method we recommend to get the result as soon as the enrichment is done.



## OpenAPI

````yaml api/v2/reference/openapi.yml get /contact/enrich/bulk/{enrichment_id}
openapi: 3.1.0
info:
  title: FullEnrich API Documentation
  version: 2.0.0
  description: >
    FullEnrich API enables you to enrich B2B contacts with emails and phone
    numbers using data from 20+ providers.


    We are GDPR and CCPA compliant.
servers:
  - url: https://app.fullenrich.com/api/v2
security: []
paths:
  /contact/enrich/bulk/{enrichment_id}:
    get:
      summary: Get Bulk Enrich Results
      description: Use this endpoint to retrieve the result from an enrich.
      operationId: GetContactBulkEnrichByID
      parameters:
        - name: enrichment_id
          in: path
          required: true
          description: The unique identifier returned when the enrichment was started
          schema:
            type: string
          example: 2db5ea61-1752-42cf-8ea1-ab1da060cd0a
        - name: forceResults
          in: query
          schema:
            type: boolean
          description: >-
            Default = False. This parameter forces the API to return what has
            been found so far, even if the enrichment is not finished. This may
            result in missing information and is not recommended for regular
            use.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseGetContactBulkEnrich'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                InProgress:
                  value:
                    code: error.enrichment.in_progress
                    message: Enrichment not ready, try again in 30 seconds
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                AuthorizationHeaderNotSet:
                  value:
                    code: error.authorization.not_set
                    message: Authorization headers not set
                AuthorizationHeaderNotAnBearer:
                  value:
                    code: error.authorization.not_bearer
                    message: Authorization headers do not have prefix 'bearer'
                UnknownApiKey:
                  value:
                    code: error.api.key
                    message: Unknown api key
        '402':
          description: Payment Required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseGetContactBulkEnrich'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                EnrichmentNotFound:
                  value:
                    code: error.enrichment.not_found
                    message: Enrichment ID not found
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                RateLimitExceeded:
                  value:
                    code: error.rate.limit
                    message: Too many requests. Try again in 1m
      security:
        - BearerAuth: []
components:
  schemas:
    ResponseGetContactBulkEnrich:
      type: object
      properties:
        id:
          type: string
          format: uuid
          examples:
            - 2db5ea61-1752-42cf-8ea1-ab1da060cd0a
        name:
          type: string
          examples:
            - Sales Operations in London
        status:
          type: string
          examples:
            - FINISHED
          enum:
            - CREATED
            - IN_PROGRESS
            - CANCELED
            - CREDITS_INSUFFICIENT
            - FINISHED
            - RATE_LIMIT
            - UNKNOWN
        data:
          type: array
          items:
            $ref: '#/components/schemas/RecordEnrichment'
        cost:
          $ref: '#/components/schemas/Cost'
    Error:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
    RecordEnrichment:
      type: object
      description: A single enriched contact record
      properties:
        input:
          $ref: '#/components/schemas/ContactEnrichmentInput'
          description: The original input data provided for this contact
        custom:
          type: object
          description: Custom fields passed during enrichment request, returned unchanged
          examples:
            - user_id: '12584'
        contact_info:
          $ref: '#/components/schemas/ContactEnrichedInformation'
          description: >-
            Contact information found during enrichment (emails and phone
            numbers)
        profile:
          $ref: '#/components/schemas/Person'
          description: >-
            Full professional profile of the person (returned when linkedin_url
            was provided)
    Cost:
      type: object
      properties:
        credits:
          type: integer
          format: int64
          description: Number of credits consumed for this enrichment
          examples:
            - 1
            - 0
    ContactEnrichmentInput:
      type: object
      description: The input data originally provided for this contact enrichment
      properties:
        first_name:
          type: string
          description: First name of the contact
          examples:
            - John
        last_name:
          type: string
          description: Last name of the contact
          examples:
            - Snow
        full_name:
          type: string
          description: Full name of the contact
          examples:
            - John Snow
        company_domain:
          type: string
          description: Domain of the contact's company
          examples:
            - example.com
        company_name:
          type: string
          description: Name of the contact's company
          examples:
            - Example Inc
        linkedin_url:
          type: string
          description: LinkedIn profile URL of the contact
          examples:
            - https://www.linkedin.com/in/demoge
    ContactEnrichedInformation:
      type: object
      description: Contact information found during enrichment
      properties:
        most_probable_work_email:
          $ref: '#/components/schemas/Email'
          description: The most reliable work email found
        most_probable_personal_email:
          $ref: '#/components/schemas/Email'
          description: The most reliable personal email found
        most_probable_phone:
          $ref: '#/components/schemas/Phone'
          description: The most reliable mobile phone number found
        work_emails:
          type: array
          description: All work emails found
          items:
            $ref: '#/components/schemas/Email'
        personal_emails:
          type: array
          description: All personal emails found
          items:
            $ref: '#/components/schemas/Email'
        phones:
          type: array
          description: All mobile phone numbers found
          items:
            $ref: '#/components/schemas/Phone'
    Person:
      type: object
      properties:
        id:
          type: string
          description: Unique person identifier
          example: 746e4816-19c8-54d8-b558-65a5a52cc85c
        full_name:
          type: string
          description: Person's full name
          example: Enzo Romera
        first_name:
          type: string
          description: Person's first name
          example: Enzo
        last_name:
          type: string
          description: Person's last name
          example: Romera
        location:
          type: object
          description: Person's location information
          properties:
            country:
              type: string
              description: Country name
              example: France
            country_code:
              type: string
              description: ISO country code
              example: FR
            city:
              type: string
              description: City name
              example: Paris
            region:
              type: string
              description: Region or state
              example: IDF
        social_profiles:
          type: object
          description: Person's social media profiles
          allOf:
            - $ref: '#/components/schemas/PersonSocialProfile'
        educations:
          type: array
          description: Person's education history
          items:
            $ref: '#/components/schemas/PersonEducation'
        languages:
          type: array
          description: Languages spoken by the person
          items:
            $ref: '#/components/schemas/PersonLanguage'
        skills:
          type: array
          description: Person's professional skills
          items:
            type: string
          example:
            - JavaScript
            - Project Management
            - Python
        employment:
          type: object
          description: Person's employment history
          properties:
            current:
              type: object
              description: >-
                Current employment information. If the person is in their
                current position, the end_at field will not be returned.
              allOf:
                - $ref: '#/components/schemas/Employment'
            all:
              type: array
              description: All employment history (current and past)
              items:
                $ref: '#/components/schemas/Employment'
    Email:
      type: object
      properties:
        email:
          type: string
          examples:
            - john.snow@example.com
        status:
          type: string
          examples:
            - DELIVERABLE
          enum:
            - DELIVERABLE
            - HIGH_PROBABILITY
            - CATCH_ALL
            - INVALID
            - INVALID_DOMAIN
    Phone:
      type: object
      properties:
        number:
          type: string
          description: Phone number in international format (E.164)
          examples:
            - +33 6 76 78 90 65
        region:
          type: string
          description: >-
            ISO 3166-1 alpha-2 country code where the phone number is registered
            (e.g., FR for France, US for United States)
          examples:
            - FR
    PersonSocialProfile:
      type: object
      properties:
        linkedin:
          type: object
          description: LinkedIn profile information
          properties:
            url:
              type: string
              description: Full LinkedIn profile URL
              example: https://www.linkedin.com/in/john-doe
            handle:
              type: string
              description: LinkedIn profile handle/username
              example: john-doe
            connection_count:
              type: integer
              description: Number of LinkedIn connections
              example: 500
    PersonEducation:
      type: object
      properties:
        school_name:
          type: string
          description: Name of the educational institution
          example: Stanford University
        degree:
          type: string
          description: Degree or qualification obtained
          example: Bachelor of Science in Computer Science
        start_at:
          type: string
          format: date-time
          description: >-
            Start date in ISO 8601 format with T separator
            (YYYY-MM-DDTHH:MM:SSZ)
          example: '2015-09-01T00:00:00Z'
        end_at:
          type: string
          format: date-time
          description: End date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ)
          example: '2019-06-01T00:00:00Z'
    PersonLanguage:
      type: object
      properties:
        language:
          type: string
          description: Language name
          example: French
        code:
          type: string
          description: ISO language code
          example: FR
        proficiency:
          type: string
          description: >-
            Proficiency level (e.g., 'Native or Bilingual', 'Professional
            Working', 'Limited Working', 'Elementary')
          example: Native or Bilingual
    Employment:
      type: object
      properties:
        title:
          type: string
          description: Job title or position
          example: Senior Software Engineer
        company:
          type: object
          description: Company information
          allOf:
            - $ref: '#/components/schemas/EmploymentCompany'
        is_current:
          type: boolean
          description: Whether this is the current employment
          example: true
        start_at:
          type: string
          format: date-time
          description: >-
            Employment start date in ISO 8601 format with T separator
            (YYYY-MM-DDTHH:MM:SSZ)
          example: '2022-03-15T00:00:00Z'
        end_at:
          type: string
          format: date-time
          description: >-
            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).
          example: '2024-06-30T00:00:00Z'
    EmploymentCompany:
      type: object
      properties:
        id:
          type: string
          description: Unique company identifier
          example: a1b2c3d4-e5f6-7890-abcd-ef1234567890
        name:
          type: string
          description: Company name
          example: Anthropic
        domain:
          type: string
          description: Company domain
          example: anthropic.com
        description:
          type: string
          description: Company description
          example: AI safety and research company
        year_founded:
          type: integer
          description: Year the company was founded
          example: 2021
        headcount:
          type: integer
          description: Number of employees
          example: 2610
        company_type:
          type: string
          description: >-
            Type of company (e.g., 'Public Company', 'Privately Held',
            'Non-profit', 'Self-employed')
          example: Privately Held
        locations:
          type: object
          description: Company location information
          properties:
            headquarters:
              type: object
              description: Main headquarters address
              allOf:
                - $ref: '#/components/schemas/CompanyAddress'
            offices:
              type: array
              description: Additional office locations
              items:
                $ref: '#/components/schemas/CompanyAddress'
        industry:
          type: object
          description: Company industry information
          properties:
            main_industry:
              type: string
              description: >-
                Primary industry category (e.g., 'Software Development',
                'Computer Hardware Manufacturing', 'Financial Services',
                'Healthcare')
              example: Software Development
        social_profiles:
          type: object
          description: Company's social media profiles
          allOf:
            - $ref: '#/components/schemas/CompanySocialProfile'
    CompanyAddress:
      type: object
      properties:
        line1:
          type: string
          description: Address line 1 (street address)
          example: 548 Market St
        line2:
          type: string
          description: Address line 2 (suite, building, etc.)
          example: PMB 42570
        city:
          type: string
          description: City name
          example: San Francisco
        region:
          type: string
          description: State or region
          example: California
        country:
          type: string
          description: Country name
          example: United States
        country_code:
          type: string
          description: ISO country code
          example: US
    CompanySocialProfile:
      type: object
      properties:
        linkedin:
          type: object
          description: LinkedIn profile information
          properties:
            url:
              type: string
              description: Full LinkedIn profile URL
              example: https://www.linkedin.com/company/anthropic
            handle:
              type: string
              description: LinkedIn profile handle/username
              example: anthropic
            follower_count:
              type: integer
              description: Number of LinkedIn followers
              example: 125000
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: string

````