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

# Person Enrichment API

> Names and companies provide starting points that sales teams need expanded into complete professional profiles. The [Person Enrichment](https://cufinder.io/enrichment-engine/contact-enrichment) API transforms full names and company names into detailed contact records—including job title, email, phone, LinkedIn, and location—with 97% confidence scores. Built for developers creating lead completion and identity verification tools, this RESTful endpoint delivers comprehensive person data that power CRM enrichment, contact validation, and personalized outreach workflows across your sales stack.

export const ReadMore = ({link, children, className = ""}) => {
  return <div className={`${className}`}>
      <h3>Read More</h3>
      <Button href={link} target="_blank" variant="outline" size="md" color="primary" className="mt-2">
        <Icon icon="code" size={24} className="!mint-bg-emerald-600 mr-2" />
        {children}
      </Button>
    </div>;
};

export const Button = ({variant = "fill", size = "md", color = "primary", href, target, children, className = "", style = {}}) => {
  const isLink = !!href;
  const variantClassname = {
    fill: "border-none mint-bg-[var(--color)] !mint-text-white hover:mint-bg-[var(--color-dark)]",
    outline: "border !mint-border-b border-solid mint-border-[var(--color)] !mint-text-[var(--color)] mint-bg-[var(--color-lightest)] hover:mint-bg-[var(--color-lighter)]",
    text: "border-none bg-transparent !mint-text-[var(--color)] hover:mint-bg-[var(--color-lighter)]"
  };
  const sizeClassname = {
    sm: "px-3 py-1 rounded-md text-sm",
    md: "px-6 py-2 rounded-lg text-base",
    lg: "px-8 py-2.5 rounded-xl text-lg"
  };
  const colors = {
    primary: "rgb(22 163 74)",
    info: "rgb(43 127 255)",
    warning: "rgb(254 154 0)",
    error: "rgb(251 44 54)"
  };
  const Comp = isLink ? "a" : "button";
  return <Comp href={isLink ? href : undefined} target={isLink ? target : undefined} className={`inline-block duration-150 transition-all font-medium ${variantClassname[variant]} ${sizeClassname[size]} ${className}`} style={{
    "--color": colors[color],
    "--color-lightest": `color-mix(in srgb, ${colors[color]}, white 90%)`,
    "--color-lighter": `color-mix(in srgb, ${colors[color]}, white 80%)`,
    "--color-light": `color-mix(in srgb, ${colors[color]}, white 10%)`,
    "--color-dark": `color-mix(in srgb, ${colors[color]}, black 10%)`,
    ...style
  }}>
      {children}
    </Comp>;
};

export const SDKsList = ({className = ""}) => {
  const sdks = [{
    href: "https://github.com/CUFinder/cufinder-ts",
    title: "Typescript",
    description: "The Official TypeScript SDK for CUFinder APIs",
    imgSrc: "/images/logos/typescript.svg"
  }, {
    href: "https://github.com/CUFinder/cufinder-py",
    title: "Python",
    description: "The Official Python SDK for CUFinder APIs",
    imgSrc: "/images/logos/python.svg"
  }, {
    href: "https://github.com/CUFinder/cufinder-go",
    title: "Go",
    description: "The Official Go SDK for CUFinder APIs",
    imgSrc: "/images/logos/go.svg"
  }, {
    href: "https://github.com/CUFinder/cufinder-rust",
    title: "Rust",
    description: "The Official Rust SDK for CUFinder APIs",
    imgSrc: "/images/logos/rust.svg",
    darkRevert: true
  }, {
    href: "https://github.com/CUFinder/cufinder-ruby",
    title: "Ruby",
    description: "The Official Ruby SDK for CUFinder APIs",
    imgSrc: "/images/logos/ruby.svg"
  }];
  return <div className={`divide-y divide-slate-200 divide-solid ${className}`}>
      <h2>CUFinder Official SDKs</h2>
      <ul className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-y-4">
        {sdks.map(sdk => <li key={sdk.title}>
            <a href={sdk.href} target="_blank" className="flex items-center gap-4">
              <img src={sdk.imgSrc} alt={sdk.title} noZoom width={100} height={100} className={`w-12 !my-0 ${sdk.darkRevert ? "dark:invert-100" : ""}`} />
              <div>
                <div>
                  <p className="text-sm text-gray-800 dark:text-gray-200">{sdk.title}</p>
                </div>
                <div>
                  <p className="text-xs text-gray-500 leading-[1.2rem]">
                    {sdk.description}
                  </p>
                </div>
              </div>
            </a>
          </li>)}
      </ul>
    </div>;
};

<div id="cuf-use-cases" className="cuf-use-cases">
  ## Common Use Cases

  One identifier is often all it takes to complete a contact's full profile.

  * **Contact Enrichment:** Completing a person's profile with title, company, and socials.
  * **Lead Scoring:** Qualifying contacts with full professional detail.
  * **CRM Enrichment:** Backfilling missing fields on people records.
  * **Personalized Outreach:** Tailoring messages with accurate contact context.
  * **Recruiting:** Building richer candidate records from a single identifier.
</div>

<Badge color="blue" size="lg" icon="star" className="mt-3">
  Credit usage is 10 per record found.
</Badge>

## Attributes

<ParamField body="full_name" type="string" required>
  Full name
</ParamField>

<ParamField body="company" type="string" required>
  Company name
</ParamField>

## Response

<CodeGroup>
  ```json Response theme={null}
  {
      "status": 1,
      "data": {
          "confidence_level": 97,
          "query": "iain mckenzie at stripe",
          "person": {
              "first_name": "iain",
              "last_name": "mckenzie",
              "full_name": "iain mckenzie",
              "linkedin_url": "linkedin.com/in/iain-mckenzie",
              "summary": null,
              "followers_count": 0,
              "facebook": null,
              "twitter": null,
              "avatar": "media.cufinder.io/person_profile/iain-mckenzie",
              "country": "canada",
              "state": null,
              "city": null,
              "job_title": "engineering",
              "job_title_categories": [],
              "company_name": "stripe",
              "company_linkedin": "linkedin.com/company/stripe",
              "company_website": "https://stripe.com",
              "company_size": "1,001-5,000",
              "company_industry": "technology, information and internet",
              "company_facebook": "facebook.com/stripepayments",
              "company_twitter": "twitter.com/stripe",
              "company_country": "united states",
              "company_state": "california",
              "company_city": "south san francisco",
              "email": "iain.mckenzie@stripe.com",
              "phone": null
          },
          "credit_count": 9761
      }
  }
  ```
</CodeGroup>

<div className="mt-20">
  ## Person Enrichment API Typescript SDK

  <CodeGroup>
    ```typescript Request theme={null}
    import { Cufinder } from '@cufinder/cufinder-ts';

    // Initialize the client
    const client = new Cufinder('your-api-key-here');

    // Initialize with more options
    const client = new Cufinder('your-api-key-here', { timeout: 60000 });

    const result = await client.tep('iain mckenzie', 'stripe');
    console.log(result);
    ```
  </CodeGroup>
</div>

<div className="mt-12">
  ## Person Enrichment API Python SDK

  <CodeGroup>
    ```python Request theme={null}
     from cufinder import Cufinder

    # Initialize the client
    client = Cufinder('your-api-key-here')

    # Initialize with more options
    client = Cufinder('your-api-key-here', timeout=60)

    result = client.tep('iain mckenzie', 'stripe')
    print(result)
    ```
  </CodeGroup>
</div>

<div className="mt-12">
  ## Person Enrichment API Go SDK

  <CodeGroup>
    ```go Request theme={null}
    package main

    import (
        "fmt"
        "log"
        
        "github.com/cufinder/cufinder-go"
    )

    func main() {
        // Initialize the client
        sdk := cufinder.NewSDK("your-api-key-here")
        
        // Initialize with more options
        sdk := cufinder.NewSDKWithConfig(cufinder.ClientConfig{
            APIKey:     "your-api-key-here",
            BaseURL:    "https://api.cufinder.io/v2",
            Timeout:    60 * time.Second,
            MaxRetries: 3,
        })
    }

    result, err := sdk.TEP("iain mckenzie", "stripe")
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result)
    ```
  </CodeGroup>
</div>

<div className="mt-12">
  ## Person Enrichment API Ruby SDK

  <CodeGroup>
    ```ruby Request theme={null}
    require 'cufinder_ruby'

    # Initialize the client
    client = Cufinder::Client.new(api_key: 'your-api-key-here')

    # Initialize with more options
    client = Cufinder::Client.new(
        api_key: 'your-api-key-here',
        timeout: 60,
        max_retries: 3
    )

    result = client.tep(full_name: 'iain mckenzie', company: 'stripe')
    puts result
    ```
  </CodeGroup>
</div>

<div className="mt-12">
  ## Person Enrichment API Rust SDK

  <CodeGroup>
    ```rust Request theme={null}
    use cufinder_rust::CufinderSDK;

    #[tokio::main]
    async fn main() -> Result<(), Box<dyn std::error::Error>> {
        // Initialize the client
        let sdk = CufinderSDK::new("your-api-key-here".to_string())?;
        
        // Initialize with more options
        let sdk = CufinderSDK::with_config(ClientConfig {
            api_key: "your-api-key-here".to_string(),
            base_url: "https://api.cufinder.io/v2".to_string(),
            timeout: Duration::from_secs(60),
            max_retries: 3,
        })?;
        
        Ok(())
    }

    let result = sdk.tep("iain mckenzie", "stripe").await?;
    println!("{:?}", result);
    ```
  </CodeGroup>
</div>

{/* <div className="mt-20">
<ReadMore link="https://cufinder.io/apis/person-enrichment-api">
Person Enrichment API
</ReadMore>
</div> */}

## Related APIs

<CardGroup cols={2}>
  <Card title="Person Search" icon="search" href="/apis/person-search">
    Search 1B+ profiles with combined filters.
  </Card>

  <Card title="LinkedIn Profile Enrichment" icon="brand-linkedin" href="/apis/linkedin-profile-enrichment">
    Enrich a person from their LinkedIn profile.
  </Card>

  <Card title="Reverse Email Lookup" icon="mail-search" href="/apis/reverse-email-lookup">
    Identify the person behind an email address.
  </Card>

  <Card title="LinkedIn Profile Email Finder" icon="mail" href="/apis/linkedin-profile-email-finder">
    Find an email from a LinkedIn profile.
  </Card>
</CardGroup>
