# With shell, you can just pass the correct header with each request
curl "https://api.contactout.com" \
  -H "authorization: basic"
  -H "token: <YOUR_API_TOKEN>"

curl "https://api.contactout.com/v1/people/linkedin/personal_email_status?profile=https://www.linkedin.com/in/example-person" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "email": true
  }
}

curl "https://api.contactout.com/v1/people/linkedin/work_email_status?profile=https://www.linkedin.com/in/example-person" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "email": true,
    "email_status": 'Verified | Unverified | null'
  }
}

curl "https://api.contactout.com/v1/people/linkedin/phone_status?profile=https://www.linkedin.com/in/example-person" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "phone": true
  }
}

curl "https://api.contactout.com/v1/people/linkedin?profile=https://www.linkedin.com/in/example-person&include_phone=true" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "url": "https://www.linkedin.com/in/example-person",
    "email": [
      "[email protected]",
      "[email protected]"
    ],
    "work_email": [
      "[email protected]"
    ],
    "personal_email": [
      "[email protected]"
    ],
    "phone": [
      "phone number 1"
    ],
    "github":[
      "github_name"
    ]
  }
}

{
  "status_code": 404,
  "message": "Not Found"
}

curl "https://api.contactout.com/v1/people/linkedin_member_id?member_id=12345&include_phone=true" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "member_id": 12345,
    "email": [
      "[email protected]",
      "[email protected]"
    ],
    "work_email": [
      "[email protected]"
    ],
    "personal_email": [
      "[email protected]"
    ],
    "phone": [
      "phone number 1"
    ],
    "github":[
      "github_name"
    ]
  }
}

{
  "status_code": 404,
  "message": "Not Found"
}

curl 'https://api.contactout.com/v1/people/linkedin/batch' \
--header 'Content-Type: application/json' \
--header 'Authorization: basic' \
--header "token: <YOUR_API_TOKEN>"
--data '{
    "profiles": [
        "https://linkedin.com/in/example-person-1",
        "https://linkedin.com/in/example-person-2",
        "https://linkedin.com/in/example-person-3"
    ]
}'

{
  "status_code": 200,
  "profiles": {
    "https://linkedin.com/in/example-person-1": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ],
    "https://linkedin.com/in/example-person-2": [
      "[email protected]"
    ],
    "https://linkedin.com/in/example-person-3": [
      "[email protected]"
    ]
  }
}

{
  "status_code": 200,
  "profiles": {
    "https://linkedin.com/in/example-person-1": [],
    "https://linkedin.com/in/example-person-2": [],
    "https://linkedin.com/in/example-person-3": []
  }
}

curl 'https://api.contactout.com/v2/people/linkedin/batch' \
--header 'Content-Type: application/json' \
--header 'Authorization: basic' \
--header "token: <YOUR_API_TOKEN>"
--data '{
    "callback_url": "https://api.contactout.com/enrich-test-callback-endpoint",
    "profiles": [
        "https://linkedin.com/in/example-person-1",
        "https://linkedin.com/in/example-person-2",
        "https://linkedin.com/in/example-person-3"
    ]
}'

{
  "status": "QUEUED",
  "job_id": "96d1c156-fc66-46ef-b053-be6dbb45cf1f"
}

curl "https://api.contactout.com/v2/people/linkedin/batch/96d1c156-fc66-46ef-b053-be6dbb45cf1f" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "data": {
    "uuid": "96d1d610-f163-484e-a433-3006c862c14d",
    "status": "SENT",
    "result": {
      "https://www.linkedin.com/in/example-person-1": {
        "emails": [
          "[email protected]"
        ],
        "personal_emails": [],
        "work_emails": [
          "[email protected]"
        ]
      },
      "https://www.linkedin.com/in/example-person-2": {
        "emails": [
          "[email protected]",
          "[email protected]"
        ],
        "personal_emails": [
          "[email protected]"
        ],
        "work_emails": [
          "[email protected]"
        ]
      },
      "https://www.linkedin.com/in/example-person-3": {
        "emails": [
          "[email protected]",
          "[email protected]"
        ],
        "personal_emails": [
          "[email protected]"
        ],
        "work_emails": [
          "[email protected]"
        ]
      }
    }
  }
}

curl "https://api.contactout.com/v1/people/[email protected]" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "email": "[email protected]",
    "linkedin": "https://www.linkedin.com/in/terry"
  }
}

{
  "status_code": 404,
  "message": "Not Found"
}

curl "  https://api.contactout.com/v1/linkedin/enrich?profile=https://www.linkedin.com/in/example-person" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

  {
  "status_code": 200,
  "profile": {
    "url": "https://www.linkedin.com/in/example-person",
    "email": [
      "[email protected]",
      "[email protected]"
    ],
    "work_email": [
      "[email protected]"
    ],
    "personal_email": [
      "[email protected]"
    ],
    "phone": [
      "+1234567891"
    ],
    "github":[
      "github_name"
    ],
    "twitter": [
      "twitter_username"
    ],
    "fullName": "Example Person",
    "headline": "Manager, Business Operations & Marketing at OBM",
    "industry": "Broadcast Media",
    "company": {
      "name": "OBM",
      "url": "https://www.linkedin.com/company/obm",
      "website": "http://obm.in",
      "headquarter": "HQ"
    },
    "location": "Bermuda"
  }
}

{
  "status_code": 200,
  "profile": []
}

curl "https://api.contactout.com/v1/email/[email protected]" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "profile": {
    "email": "[email protected]",
    "fullName": "Bobbi Singh",
    "headline": "Manager, Business Operations & Marketing at OBM International",
    "industry": "Broadcast Media",
    "linkedinUrl": "https://www.linkedin.com/in/bobbisingh",
    "confidenceLevel": "",
    "altMatches": [],
    "phone": " +61.438347437",
    "twitter": "",
    "github": "",
    "company": {
      "name": "OBM International",
      "url": "https://www.linkedin.com/company/obm-international",
      "website": "http://obm.international",
      "headquarter": "HQ",
      "locations": [
        {
          "line1": "Address Line 1",
          "line2": "Address Line 2",
          "city": "City",
          "state": "State",
          "country": "US",
          "postalCode": "12345",
          "description": "Headquarters"
        }
      ]
    },
    "locality": "Bermuda",
    "summary": "An experienced professional with over 19 years in Marketing (digital, print, radio, television), Communications, Content Creation, Copy Writing, Website Maintenance, Social Media Exploitation, Relationship Building, Business Development, Business Operations, Training and Leadership.\\n",
    "experience": [
      {
        "end": "Present",
        "start": 2018,
        "title": "Manager, Business Operations & Marketing",
        "description": "Established in 1936, OBMI is a global master planning, architecture and design firm, with a rich history of shaping the architectural landscape of Bermuda. Within the firm, I support the OBMI Bermuda office on a multi-faceted level. My commitment to relationship building & client management, together with my passion and proficiency in marketing & communications, allows me to be an integral member of the team. Currently, my mandates include:Marketing•\tLead all marketing initiatives for the OBMI Bermuda office•\tCreation all print and digital ads for the local market•\tCreate, design and execute the quarterly newsletter•\tCopy & creative of OBMI Bermuda articles for local and international publication•\tManage Google My Business content•\tOversee see all aspects of the OBMI Bermuda website•\tCapture and analyze various metrics to identify areas of enhancement•\tExplore industry trends, best practices and innovative marketing solutions for potential adoptionBusiness Operations•\tProject management •\tClient relationship management•\tVendor & consultant management•\tOffice administration•\tPrimary point of contact for Bermuda office•\tCollaborate with corporate office in Miami on marketing & company-wide initiatives/roll-outs",
        "organization": [
          {
            "name": "OBM International",
            "profile_url": "https://www.linkedin.com/company/obm-international"
          }
        ]
      }
    ],
    "education": [
      {
        "end": "2004",
        "name": "George Brown College",
        "major": "Journalism",
        "start": "2002",
        "degrees": [
          "Journalism"
        ],
        "profile_url": "http://www.linkedin.com/edu/george-brown-college-19978"
      }
    ],
    "skills": "Web Content, Customer Experience, Direct Marketing, Internal Communications, Event Management, Retail Communications, Social Media Marketing, Training Delivery, Training & Development, Sports, Hockey, NFL, Management, Employee Training, Retail",
    "interests": "Training and Communications, Sports Marketing, Online Marketing and Creative, Electronic Direct Mail and Direct Mail",
    "certifications": [
      {
        "end": "Present",
        "start": "October 2013",
        "title": "Central Challenges of American National Security, Strategy and the Press: An Introduction",
        "license": "License HarvardX/HKS-211.1x/3T2013",
        "certificate_authority": "edX"
      }
    ],
    "websites": "Personal Website - http://www.sportschick.ca\nCompany Website - http://bermudasun.bm/",
    "volunteering": [
      {
        "start": "October 2013",
        "end": "Present",
        "title": "Research",
        "duration": "10 years",
        "organization": [
          {
            "name": "Bermuda Zoological Society"
          }
        ],
        "causes": [
          "Animal Welfare",
          "Education",
          "Environment",
          "Poverty Alleviation"
        ]
      }
    ],
    "recommendations": "",
    "publications": [
      {
        "url": "http://www.vimeo.com/16870597",
        "date": "May 2005",
        "title": "The Dejon Simmons Story",
        "authors": [
          "Dejon Simons"
        ],
        "summary": "De’Jon’s tell-all documentary titled “The Dejon Simmons Story” explores all aspects of his accident, his reaction, and how he’s come to accept who he has become today.",
        "publisher": "Road Safety Council"
      }
    ],
    "honors": [
      {
        "date": "August 2011",
        "title": "Ross \"Blackie\" Talbot Educational Awardee 2010 & 2011",
        "description": "Awarded a scholarship for two consecutive years for academic achievement and financial need.",
        "organization": "HSBC Bank"
      }
    ]
  }
}

{
  "status_code": 404,
  "message": "Not Found"
}

curl "https://api.contactout.com/v1/domain/enrich" \
--header 'Content-Type: application/json' \
--header 'Authorization: basic' \
--header "token: <YOUR_API_TOKEN>"
--data '{
    "domains": [
        "test.com"
    ]
}'

{
  "status_code": 200,
  "companies": {
    "contactout.com": {
      "li_vanity": "https://www.linkedin.com/company/test",
      "name": "Test",
      "domain": "test.com",
      "website": "http://test.com",
      "type": "Privately Held",
      "headquarter": "San Francisco, US",
      "country": "United States",
      "size": 89,
      "founded_at": 2015,
      "locations": [
        {
          "city": "San Francisco",
          "country": "US",
          "isPrimary": true
        }
      ],
      "industry": "Computer Software",
      "specialties": [],
      "technologies_used": [
        "laravel",
        "microsoft",
        "lever",
        "ahrefs",
        "vidyard",
        "entelo",
        "help desk",
        "salesforce",
        "reuse",
        "to go",
        "unicorn",
        "facebook",
        "sales navigator",
        "linkedin",
        "for business",
        "asx",
        "convey",
        "salesloft",
        "roadmap",
        "pipedrive",
        "tasker",
        "elasticsearch",
        "bitly",
        "trajectory",
        "crm",
        "data management"
      ],
      "revenue": "$5.4M"
    }
  }
}

{
  "status_code": 200,
  "companies": []
}

curl "https://api.contactout.com/v1/people/search" \
--header 'Content-Type: application/json' \
--header 'Authorization: basic' \
--header "token: <YOUR_API_TOKEN>"
--data '
  {
    "page": 1,
    "name": "John Smith",
    "job_title": [
      "Vice President",
      "VP Of Product"
    ],
    "exclude_job_titles": [
      "Sales"
    ],
    "current_titles_only": false,
    "include_related_job_titles": false,
    "skills": [
      "Network Security",
      "Networking"
    ],
    "location": [
      "Sydney, Australia"
    ],
    "company": [
      "ContactOut"
    ],
    "exclude_companies": [
      "Google"
    ],
    "domain":[
      "https://contactout.com"
    ],
    "industry: [
      "Computer Software",
      "Computer Networking"
    ],
    "company_size": [
      "1_10",
      "11_50"
    ],
    "current_company_only": false,
    "data_types" : [
      "personal_email",
      "work_email",
      "phone"
    ],
    "reveal_info" : true
  }
'

{
  "status_code": 200,
  "metadata": {
    "page": 1,
    "page_size": 25,
    "total_results": 45
  },
  "profiles": {
    "https://linkedin.com/in/at-JqjtXv": {
      "li_vanity": "at-JqjtXv",
      "full_name": "Llewellyn Ruecker",
      "title": "Research Assistant",
      "headline": "Research Assistant at Legros, Smitham and Kessler",
      "company": {
        "name": "Legros, Smitham and Kessler",
        "website": "nemo",
        "headquarter": "535 Kuhic Gardens Apt. 044",
        "domain": "hamill.net",
        "company_size": 3
      },
      "location": "Faheybury",
      "industry": "Dr. Trenton Hane III",
      "experience": [
        "Research Assistant at Legros, Smitham and Kessler in 2014 - Present"
      ],
      "education": [
        "Doctorate degree at Vertapple University in 2017 - 2021"
      ],
      "skills": [
        "Research",
        "Algorithms",
        "Budget Planning",
        "Storage",
        "Requirements Gathering",
        "Coding"
      ],
      "updated_at": "2023-03-31 00:00:00",
      "contact_availability" : {
        "personal_email" : true,
        "work_email": true,
        "phone": true
      },
      "contact_info": {
        "emails": ["[email protected]", "[email protected]"],
        "personal_emails": ["[email protected]"],
        "work_emails": ["[email protected]"],
        "phones": ["+123456789"]
      }
    },
    "https://www.linkedin.com/in/maxime-IX12tS": {
      ....
    },
    .....
  }
}

{
  "status_code": 200,
  "metadata": {
    "page": 1,
    "page_size": 25,
    "total_results": 0
  },
  "profiles": []
}

curl "https://api.contactout.com/v1/people/search" \
--header 'Content-Type: application/json' \
--header 'Authorization: basic' \
--header "token: <YOUR_API_TOKEN>"
--data '
  {
    "page": 1,
    "name": "John Smith",
    "output_fields" : [
        "title",
        "li_vanity"
    ]
  }

{
  "status_code": 200,
  "metadata": {
    "page": 1,
    "page_size": 25,
    "total_results": 0
  },
  "profiles": {
    "https://linkedin.com/in/at-JqjtXv": {
      "li_vanity": "at-JqjtXv",
      "title": "Research Assistant",
      "contact_availability" : {
        "personal_email" : true,
        "work_email": true,
        "phone": true
      },
      "contact_info": {
        "emails": [],
        "personal_emails": [],
        "work_emails": [],
        "phones": []
      }
    }
  }
}

curl "https://api.contactout.com/v1/email/[email protected]" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "data": {
    "status": "valid"
  }
}

curl 'https://api.contactout.com/v1/email/verify/batch' \
--header 'Content-Type: application/json' \
--header 'Authorization: basic' \
--header "token: <YOUR_API_TOKEN>"
--data '{
    "callback_url": "https://api.contactout.com/enrich-test-callback-endpoint",
    "emails": [
        "[email protected]",
        "[email protected]",
        "[email protected]"
    ]
}'

{
  "status": "QUEUED",
  "job_id": "96d1c156-fc66-46ef-b053-be6dbb45cf1f"
}

curl "https://api.contactout.com/v1/email/verify/batch/96d1c156-fc66-46ef-b053-be6dbb45cf1f" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "data": {
    "uuid": "992d8707-aa77-4499-92e4-cf3579c1d384",
    "status": "DONE",
    "result": {
      "[email protected]": "valid",
      "[email protected]": "accept_all",
      "[email protected]": "invalid"
    }
  }
}

curl "https://api.contactout.com/v1/stats?period=2023-04" \
--header "authorization: basic" \
--header "token: <YOUR_API_TOKEN>"

{
  "status_code": 200,
  "period": {
    "start": "2023-04-01",
    "end": "2023-04-31"
  },
  "usage": {
    "count": 500,
    "quota": 1000,
    "remaining": 500,
    "over_quota": 0,
    "phone_count": 500,
    "phone_quota": 1000,
    "phone_remaining": 500,
    "phone_over_quota": 0
  }
}