--- updatedAt: 2026-06-04T10:32:52.000Z agentTools: projectIndex: https://docs.companyenrich.com/llms.txt --- # Lookup person **Cost:** 5 credits per successful call Looks up a person by email address. We resolve the company from the email domain first, then match the person by email local-part patterns. Returns the best deterministic match when found. # OpenAPI definition ````json { "openapi": "3.0.1", "info": { "title": "Company Enrich API", "description": "The Company Enrich API provides programmatic access to a comprehensive database of company and person data for enrichment, search, and lead generation.\n\n## Key Features\n\n- **Company Enrichment** — Enrich company profiles by domain, ID, or matching properties. Supports single lookups, batch requests, and bulk background jobs.\n- **Company Search** — Search and filter companies by industry, location, size, technology usage, keywords, and more. Supports page-based, cursor-based, and async export pagination.\n- **People Search** — Search for professionals by job title, company, location, and other criteria. Export results in CSV or JSON.\n- **Similar Companies** — Find companies similar to a given company based on shared attributes.\n- **Company Lists** — Create and manage saved lists of companies for organizing and exporting your data.\n\n## Authentication\n\nAll API requests require a Bearer token passed in the `Authorization` header:\n\n```\nAuthorization: Bearer YOUR_API_TOKEN\n```\n\nYou can generate API tokens from your [dashboard](https://companyenrich.com/dashboard).\n\n## Credits\n\nMost API calls consume credits. The credit cost for each endpoint is documented in its description. You can check your remaining credit balance using the User endpoint.\n\n## Rate Limiting\n\nThe global API limiter allows **500 requests per minute** per IP address. Authenticated API routes also use a per-user route limiter based on plan capabilities.\nSupplementary lookup endpoints (such as keyword/technology/industry autocompletes) use a separate per-user route-level bucket.", "termsOfService": "https://companyenrich.com/terms-and-conditions", "contact": { "url": "https://companyenrich.com/", "email": "support@companyenrich.com" }, "version": "1.0.0" }, "servers": [ { "url": "https://api.companyenrich.com" } ], "paths": { "/people/lookup": { "post": { "tags": [ "People / Search" ], "summary": "Lookup person", "description": "**Cost:** 5 credits per successful call\n\nLooks up a person by email address.\n\nWe resolve the company from the email domain first, then match the person by email local-part patterns.\nReturns the best deterministic match when found.", "parameters": [ { "name": "expand", "in": "query", "description": "Expandable response fields. Repeat the parameter to request multiple expansions.\n\nSupported values:\n- `education`: costs 1 credit per person and adds the `education` field to `PersonInfo`.", "schema": { "type": "array", "items": { "enum": [ "education" ], "type": "string" } } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonLookupRequest" } } }, "required": true }, "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonInfo" } } } }, "400": { "description": "Bad Request", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "401": { "description": "Unauthorized", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Payment Required", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Not Found", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Unprocessable Entity", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/HttpValidationProblemDetails" } } } }, "429": { "description": "Too Many Requests", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } } }, "components": { "schemas": { "CompanyHandle": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier of the company", "format": "uuid" }, "name": { "maxLength": 1024, "type": "string", "description": "The name of the company", "nullable": true }, "domain": { "maxLength": 1024, "type": "string", "description": "The primary domain name of the company", "nullable": true }, "industry": { "type": "string", "description": "The main industry of the company", "nullable": true }, "logo_url": { "type": "string", "description": "The logo URL of the company", "nullable": true } }, "description": "The matched educational institution", "nullable": true }, "CountryInfo": { "type": "object", "properties": { "code": { "type": "string", "description": "The ISO 3166-1 alpha-2 code of the country" }, "name": { "type": "string", "description": "The name of the country" }, "latitude": { "type": "number", "description": "The latitude of the country", "format": "float", "nullable": true }, "longitude": { "type": "number", "description": "The longitude of the country", "format": "float", "nullable": true } }, "description": "The origin country information of the company", "nullable": true }, "HttpValidationProblemDetails": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "status": { "type": "integer", "format": "int32", "nullable": true }, "detail": { "type": "string", "nullable": true }, "instance": { "type": "string", "nullable": true }, "errors": { "type": "object", "additionalProperties": { "type": "array", "items": { "type": "string" } } } } }, "NullableOfPersonDepartment": { "enum": [ "c-suite", "c-suite/executive", "c-suite/finance-executive", "c-suite/founder", "c-suite/human-resources-executive", "c-suite/information-technology-executive", "c-suite/legal-executive", "c-suite/marketing-executive", "c-suite/medical-health-executive", "c-suite/operations-executive", "c-suite/sales-executive", "product-management", "product-management/product-development", "product-management/product-management", "engineering-technical", "engineering-technical/artificial-intelligence-machine-learning", "engineering-technical/bioengineering", "engineering-technical/biometrics", "engineering-technical/business-intelligence", "engineering-technical/chemical-engineering", "engineering-technical/cloud-mobility", "engineering-technical/data-science", "engineering-technical/devops", "engineering-technical/digital-transformation", "engineering-technical/emerging-technology-innovation", "engineering-technical/engineering-technical", "engineering-technical/industrial-engineering", "engineering-technical/mechanic", "engineering-technical/mobile-development", "engineering-technical/project-management", "engineering-technical/research-development", "engineering-technical/scrum-master-agile-coach", "engineering-technical/software-development", "engineering-technical/support-technical-services", "engineering-technical/technician", "engineering-technical/technology-operations", "engineering-technical/test-quality-assurance", "engineering-technical/ui-ux", "engineering-technical/web-development", "design", "design/all-design", "design/product-ui-ux-design", "design/graphic-design", "education", "education/teacher", "education/principal", "education/superintendent", "education/professor", "finance", "finance/accounting", "finance/finance", "finance/financial-planning-analysis", "finance/financial-reporting", "finance/financial-strategy", "finance/financial-systems", "finance/internal-audit-control", "finance/investor-relations", "finance/mergers-acquisitions", "finance/real-estate-finance", "finance/financial-risk", "finance/shared-services", "finance/sourcing-procurement", "finance/tax", "finance/treasury", "human-resources", "human-resources/compensation-benefits", "human-resources/culture-diversity-inclusion", "human-resources/employee-labor-relations", "human-resources/health-safety", "human-resources/human-resource-information-system", "human-resources/human-resources", "human-resources/hr-business-partner", "human-resources/learning-development", "human-resources/organizational-development", "human-resources/recruiting-talent-acquisition", "human-resources/talent-management", "human-resources/workforce-management", "human-resources/people-operations", "information-technology", "information-technology/application-development", "information-technology/business-service-management-itsm", "information-technology/collaboration-web-app", "information-technology/data-center", "information-technology/data-warehouse", "information-technology/database-administration", "information-technology/ecommerce-development", "information-technology/enterprise-architecture", "information-technology/help-desk-desktop-services", "information-technology/hr-financial-erp-systems", "information-technology/information-security", "information-technology/information-technology", "information-technology/infrastructure", "information-technology/it-asset-management", "information-technology/it-audit-it-compliance", "information-technology/it-operations", "information-technology/it-procurement", "information-technology/it-strategy", "information-technology/it-training", "information-technology/networking", "information-technology/project-program-management", "information-technology/quality-assurance", "information-technology/retail-store-systems", "information-technology/servers", "information-technology/storage-disaster-recovery", "information-technology/telecommunications", "information-technology/virtualization", "legal", "legal/acquisitions", "legal/compliance", "legal/contracts", "legal/corporate-secretary", "legal/ediscovery", "legal/ethics", "legal/governance", "legal/governmental-affairs-regulatory-law", "legal/intellectual-property-patent", "legal/labor-employment", "legal/lawyer-attorney", "legal/legal", "legal/legal-counsel", "legal/legal-operations", "legal/litigation", "legal/privacy", "marketing", "marketing/advertising", "marketing/brand-management", "marketing/content-marketing", "marketing/customer-experience", "marketing/customer-marketing", "marketing/demand-generation", "marketing/digital-marketing", "marketing/ecommerce-marketing", "marketing/event-marketing", "marketing/field-marketing", "marketing/lead-generation", "marketing/marketing", "marketing/marketing-analytics-insights", "marketing/marketing-communications", "marketing/marketing-operations", "marketing/product-marketing", "marketing/public-relations", "marketing/search-engine-optimization-pay-per-click", "marketing/social-media-marketing", "marketing/strategic-communications", "marketing/technical-marketing", "medical-health", "medical-health/anesthesiology", "medical-health/chiropractics", "medical-health/clinical-systems", "medical-health/dentistry", "medical-health/dermatology", "medical-health/doctors-physicians", "medical-health/epidemiology", "medical-health/first-responder", "medical-health/infectious-disease", "medical-health/medical-administration", "medical-health/medical-education-training", "medical-health/medical-research", "medical-health/medicine", "medical-health/neurology", "medical-health/nursing", "medical-health/nutrition-dietetics", "medical-health/obstetrics-gynecology", "medical-health/oncology", "medical-health/opthalmology", "medical-health/optometry", "medical-health/orthopedics", "medical-health/pathology", "medical-health/pediatrics", "medical-health/pharmacy", "medical-health/physical-therapy", "medical-health/psychiatry", "medical-health/psychology", "medical-health/public-health", "medical-health/radiology", "medical-health/social-work", "operations", "operations/call-center", "operations/construction", "operations/corporate-strategy", "operations/customer-service-support", "operations/enterprise-resource-planning", "operations/facilities-management", "operations/leasing", "operations/logistics", "operations/office-operations", "operations/operations", "operations/physical-security", "operations/project-development", "operations/quality-management", "operations/real-estate", "operations/safety", "operations/store-operations", "operations/supply-chain", "sales", "sales/account-management", "sales/business-development", "sales/channel-sales", "sales/customer-retention-development", "sales/customer-success", "sales/field-outside-sales", "sales/inside-sales", "sales/partnerships", "sales/revenue-operations", "sales/sales", "sales/sales-enablement", "sales/sales-engineering", "sales/sales-operations", "sales/sales-training", "consulting", "consulting/consultant", null ], "description": "The department of the person", "nullable": true }, "NullableOfPersonSeniority": { "enum": [ "owner", "founder", "c-suite", "partner", "vp", "head", "director", "manager", "senior", "entry", "intern", null ], "description": "The seniority level of the person", "nullable": true }, "PersonEducationInfo": { "required": [ "institutionName" ], "type": "object", "properties": { "institutionName": { "type": "string", "description": "The name of the educational institution" }, "institution": { "$ref": "#/components/schemas/CompanyHandle" }, "socialHandle": { "type": "string", "description": "The social media handle of the educational institution", "nullable": true }, "degree": { "type": "array", "items": { "type": "string" }, "description": "The degrees or fields of study associated with this education entry", "nullable": true }, "startYear": { "type": "integer", "description": "The year this education entry started", "format": "int16", "nullable": true }, "endYear": { "type": "integer", "description": "The year this education entry ended", "format": "int16", "nullable": true } } }, "PersonExperience": { "required": [ "type" ], "type": "object", "anyOf": [ { "$ref": "#/components/schemas/PersonExperiencePersonCompanyExperience" }, { "$ref": "#/components/schemas/PersonExperiencePersonUnknownExperience" } ], "discriminator": { "propertyName": "type", "mapping": { "company": "#/components/schemas/PersonExperiencePersonCompanyExperience", "unknown": "#/components/schemas/PersonExperiencePersonUnknownExperience" } } }, "PersonExperiencePersonCompanyExperience": { "properties": { "type": { "enum": [ "company" ], "type": "string" }, "company": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier of the company", "format": "uuid" }, "name": { "maxLength": 1024, "type": "string", "description": "The name of the company", "nullable": true }, "domain": { "maxLength": 1024, "type": "string", "description": "The primary domain name of the company", "nullable": true }, "industry": { "type": "string", "description": "The main industry of the company", "nullable": true }, "logo_url": { "type": "string", "description": "The logo URL of the company", "nullable": true } }, "nullable": true }, "startDate": { "type": "string", "format": "date", "nullable": true }, "endDate": { "type": "string", "format": "date", "nullable": true }, "isCurrent": { "type": "boolean" }, "isMatched": { "type": "boolean" }, "position": { "type": "string", "nullable": true }, "seniority": { "enum": [ "owner", "founder", "c-suite", "partner", "vp", "head", "director", "manager", "senior", "entry", "intern", null ], "nullable": true }, "department": { "enum": [ "c-suite", "c-suite/executive", "c-suite/finance-executive", "c-suite/founder", "c-suite/human-resources-executive", "c-suite/information-technology-executive", "c-suite/legal-executive", "c-suite/marketing-executive", "c-suite/medical-health-executive", "c-suite/operations-executive", "c-suite/sales-executive", "product-management", "product-management/product-development", "product-management/product-management", "engineering-technical", "engineering-technical/artificial-intelligence-machine-learning", "engineering-technical/bioengineering", "engineering-technical/biometrics", "engineering-technical/business-intelligence", "engineering-technical/chemical-engineering", "engineering-technical/cloud-mobility", "engineering-technical/data-science", "engineering-technical/devops", "engineering-technical/digital-transformation", "engineering-technical/emerging-technology-innovation", "engineering-technical/engineering-technical", "engineering-technical/industrial-engineering", "engineering-technical/mechanic", "engineering-technical/mobile-development", "engineering-technical/project-management", "engineering-technical/research-development", "engineering-technical/scrum-master-agile-coach", "engineering-technical/software-development", "engineering-technical/support-technical-services", "engineering-technical/technician", "engineering-technical/technology-operations", "engineering-technical/test-quality-assurance", "engineering-technical/ui-ux", "engineering-technical/web-development", "design", "design/all-design", "design/product-ui-ux-design", "design/graphic-design", "education", "education/teacher", "education/principal", "education/superintendent", "education/professor", "finance", "finance/accounting", "finance/finance", "finance/financial-planning-analysis", "finance/financial-reporting", "finance/financial-strategy", "finance/financial-systems", "finance/internal-audit-control", "finance/investor-relations", "finance/mergers-acquisitions", "finance/real-estate-finance", "finance/financial-risk", "finance/shared-services", "finance/sourcing-procurement", "finance/tax", "finance/treasury", "human-resources", "human-resources/compensation-benefits", "human-resources/culture-diversity-inclusion", "human-resources/employee-labor-relations", "human-resources/health-safety", "human-resources/human-resource-information-system", "human-resources/human-resources", "human-resources/hr-business-partner", "human-resources/learning-development", "human-resources/organizational-development", "human-resources/recruiting-talent-acquisition", "human-resources/talent-management", "human-resources/workforce-management", "human-resources/people-operations", "information-technology", "information-technology/application-development", "information-technology/business-service-management-itsm", "information-technology/collaboration-web-app", "information-technology/data-center", "information-technology/data-warehouse", "information-technology/database-administration", "information-technology/ecommerce-development", "information-technology/enterprise-architecture", "information-technology/help-desk-desktop-services", "information-technology/hr-financial-erp-systems", "information-technology/information-security", "information-technology/information-technology", "information-technology/infrastructure", "information-technology/it-asset-management", "information-technology/it-audit-it-compliance", "information-technology/it-operations", "information-technology/it-procurement", "information-technology/it-strategy", "information-technology/it-training", "information-technology/networking", "information-technology/project-program-management", "information-technology/quality-assurance", "information-technology/retail-store-systems", "information-technology/servers", "information-technology/storage-disaster-recovery", "information-technology/telecommunications", "information-technology/virtualization", "legal", "legal/acquisitions", "legal/compliance", "legal/contracts", "legal/corporate-secretary", "legal/ediscovery", "legal/ethics", "legal/governance", "legal/governmental-affairs-regulatory-law", "legal/intellectual-property-patent", "legal/labor-employment", "legal/lawyer-attorney", "legal/legal", "legal/legal-counsel", "legal/legal-operations", "legal/litigation", "legal/privacy", "marketing", "marketing/advertising", "marketing/brand-management", "marketing/content-marketing", "marketing/customer-experience", "marketing/customer-marketing", "marketing/demand-generation", "marketing/digital-marketing", "marketing/ecommerce-marketing", "marketing/event-marketing", "marketing/field-marketing", "marketing/lead-generation", "marketing/marketing", "marketing/marketing-analytics-insights", "marketing/marketing-communications", "marketing/marketing-operations", "marketing/product-marketing", "marketing/public-relations", "marketing/search-engine-optimization-pay-per-click", "marketing/social-media-marketing", "marketing/strategic-communications", "marketing/technical-marketing", "medical-health", "medical-health/anesthesiology", "medical-health/chiropractics", "medical-health/clinical-systems", "medical-health/dentistry", "medical-health/dermatology", "medical-health/doctors-physicians", "medical-health/epidemiology", "medical-health/first-responder", "medical-health/infectious-disease", "medical-health/medical-administration", "medical-health/medical-education-training", "medical-health/medical-research", "medical-health/medicine", "medical-health/neurology", "medical-health/nursing", "medical-health/nutrition-dietetics", "medical-health/obstetrics-gynecology", "medical-health/oncology", "medical-health/opthalmology", "medical-health/optometry", "medical-health/orthopedics", "medical-health/pathology", "medical-health/pediatrics", "medical-health/pharmacy", "medical-health/physical-therapy", "medical-health/psychiatry", "medical-health/psychology", "medical-health/public-health", "medical-health/radiology", "medical-health/social-work", "operations", "operations/call-center", "operations/construction", "operations/corporate-strategy", "operations/customer-service-support", "operations/enterprise-resource-planning", "operations/facilities-management", "operations/leasing", "operations/logistics", "operations/office-operations", "operations/operations", "operations/physical-security", "operations/project-development", "operations/quality-management", "operations/real-estate", "operations/safety", "operations/store-operations", "operations/supply-chain", "sales", "sales/account-management", "sales/business-development", "sales/channel-sales", "sales/customer-retention-development", "sales/customer-success", "sales/field-outside-sales", "sales/inside-sales", "sales/partnerships", "sales/revenue-operations", "sales/sales", "sales/sales-enablement", "sales/sales-engineering", "sales/sales-operations", "sales/sales-training", "consulting", "consulting/consultant", null ], "nullable": true } } }, "PersonExperiencePersonUnknownExperience": { "properties": { "type": { "enum": [ "unknown" ], "type": "string" }, "companyName": { "type": "string", "nullable": true }, "startDate": { "type": "string", "format": "date", "nullable": true }, "endDate": { "type": "string", "format": "date", "nullable": true }, "isCurrent": { "type": "boolean" }, "isMatched": { "type": "boolean" }, "position": { "type": "string", "nullable": true }, "seniority": { "enum": [ "owner", "founder", "c-suite", "partner", "vp", "head", "director", "manager", "senior", "entry", "intern", null ], "nullable": true }, "department": { "enum": [ "c-suite", "c-suite/executive", "c-suite/finance-executive", "c-suite/founder", "c-suite/human-resources-executive", "c-suite/information-technology-executive", "c-suite/legal-executive", "c-suite/marketing-executive", "c-suite/medical-health-executive", "c-suite/operations-executive", "c-suite/sales-executive", "product-management", "product-management/product-development", "product-management/product-management", "engineering-technical", "engineering-technical/artificial-intelligence-machine-learning", "engineering-technical/bioengineering", "engineering-technical/biometrics", "engineering-technical/business-intelligence", "engineering-technical/chemical-engineering", "engineering-technical/cloud-mobility", "engineering-technical/data-science", "engineering-technical/devops", "engineering-technical/digital-transformation", "engineering-technical/emerging-technology-innovation", "engineering-technical/engineering-technical", "engineering-technical/industrial-engineering", "engineering-technical/mechanic", "engineering-technical/mobile-development", "engineering-technical/project-management", "engineering-technical/research-development", "engineering-technical/scrum-master-agile-coach", "engineering-technical/software-development", "engineering-technical/support-technical-services", "engineering-technical/technician", "engineering-technical/technology-operations", "engineering-technical/test-quality-assurance", "engineering-technical/ui-ux", "engineering-technical/web-development", "design", "design/all-design", "design/product-ui-ux-design", "design/graphic-design", "education", "education/teacher", "education/principal", "education/superintendent", "education/professor", "finance", "finance/accounting", "finance/finance", "finance/financial-planning-analysis", "finance/financial-reporting", "finance/financial-strategy", "finance/financial-systems", "finance/internal-audit-control", "finance/investor-relations", "finance/mergers-acquisitions", "finance/real-estate-finance", "finance/financial-risk", "finance/shared-services", "finance/sourcing-procurement", "finance/tax", "finance/treasury", "human-resources", "human-resources/compensation-benefits", "human-resources/culture-diversity-inclusion", "human-resources/employee-labor-relations", "human-resources/health-safety", "human-resources/human-resource-information-system", "human-resources/human-resources", "human-resources/hr-business-partner", "human-resources/learning-development", "human-resources/organizational-development", "human-resources/recruiting-talent-acquisition", "human-resources/talent-management", "human-resources/workforce-management", "human-resources/people-operations", "information-technology", "information-technology/application-development", "information-technology/business-service-management-itsm", "information-technology/collaboration-web-app", "information-technology/data-center", "information-technology/data-warehouse", "information-technology/database-administration", "information-technology/ecommerce-development", "information-technology/enterprise-architecture", "information-technology/help-desk-desktop-services", "information-technology/hr-financial-erp-systems", "information-technology/information-security", "information-technology/information-technology", "information-technology/infrastructure", "information-technology/it-asset-management", "information-technology/it-audit-it-compliance", "information-technology/it-operations", "information-technology/it-procurement", "information-technology/it-strategy", "information-technology/it-training", "information-technology/networking", "information-technology/project-program-management", "information-technology/quality-assurance", "information-technology/retail-store-systems", "information-technology/servers", "information-technology/storage-disaster-recovery", "information-technology/telecommunications", "information-technology/virtualization", "legal", "legal/acquisitions", "legal/compliance", "legal/contracts", "legal/corporate-secretary", "legal/ediscovery", "legal/ethics", "legal/governance", "legal/governmental-affairs-regulatory-law", "legal/intellectual-property-patent", "legal/labor-employment", "legal/lawyer-attorney", "legal/legal", "legal/legal-counsel", "legal/legal-operations", "legal/litigation", "legal/privacy", "marketing", "marketing/advertising", "marketing/brand-management", "marketing/content-marketing", "marketing/customer-experience", "marketing/customer-marketing", "marketing/demand-generation", "marketing/digital-marketing", "marketing/ecommerce-marketing", "marketing/event-marketing", "marketing/field-marketing", "marketing/lead-generation", "marketing/marketing", "marketing/marketing-analytics-insights", "marketing/marketing-communications", "marketing/marketing-operations", "marketing/product-marketing", "marketing/public-relations", "marketing/search-engine-optimization-pay-per-click", "marketing/social-media-marketing", "marketing/strategic-communications", "marketing/technical-marketing", "medical-health", "medical-health/anesthesiology", "medical-health/chiropractics", "medical-health/clinical-systems", "medical-health/dentistry", "medical-health/dermatology", "medical-health/doctors-physicians", "medical-health/epidemiology", "medical-health/first-responder", "medical-health/infectious-disease", "medical-health/medical-administration", "medical-health/medical-education-training", "medical-health/medical-research", "medical-health/medicine", "medical-health/neurology", "medical-health/nursing", "medical-health/nutrition-dietetics", "medical-health/obstetrics-gynecology", "medical-health/oncology", "medical-health/opthalmology", "medical-health/optometry", "medical-health/orthopedics", "medical-health/pathology", "medical-health/pediatrics", "medical-health/pharmacy", "medical-health/physical-therapy", "medical-health/psychiatry", "medical-health/psychology", "medical-health/public-health", "medical-health/radiology", "medical-health/social-work", "operations", "operations/call-center", "operations/construction", "operations/corporate-strategy", "operations/customer-service-support", "operations/enterprise-resource-planning", "operations/facilities-management", "operations/leasing", "operations/logistics", "operations/office-operations", "operations/operations", "operations/physical-security", "operations/project-development", "operations/quality-management", "operations/real-estate", "operations/safety", "operations/store-operations", "operations/supply-chain", "sales", "sales/account-management", "sales/business-development", "sales/channel-sales", "sales/customer-retention-development", "sales/customer-success", "sales/field-outside-sales", "sales/inside-sales", "sales/partnerships", "sales/revenue-operations", "sales/sales", "sales/sales-enablement", "sales/sales-engineering", "sales/sales-operations", "sales/sales-training", "consulting", "consulting/consultant", null ], "nullable": true } } }, "PersonInfo": { "required": [ "id" ], "type": "object", "properties": { "id": { "type": "integer", "description": "The unique identifier of the person", "format": "int64" }, "name": { "maxLength": 1024, "type": "string", "description": "The full name of the person", "nullable": true }, "location": { "$ref": "#/components/schemas/PersonLocationInfo" }, "first_name": { "type": "string", "description": "The first name of the person", "nullable": true }, "last_name": { "type": "string", "description": "The last name of the person", "nullable": true }, "socials": { "$ref": "#/components/schemas/PersonSocialUrls" }, "experiences": { "type": "array", "items": { "$ref": "#/components/schemas/PersonExperience" }, "description": "The work experiences of the person" }, "education": { "type": "array", "items": { "$ref": "#/components/schemas/PersonEducationInfo" }, "description": "The education history of the person. This field is only returned when `expand=education` is requested.", "nullable": true }, "position": { "type": "string", "description": "The job position/title of the person", "nullable": true }, "seniority": { "$ref": "#/components/schemas/NullableOfPersonSeniority" }, "department": { "$ref": "#/components/schemas/NullableOfPersonDepartment" }, "image_url": { "type": "string", "description": "The image URL of the person", "nullable": true }, "updated_at": { "type": "string", "description": "The timestamp representing when the person's data was last updated", "format": "date-time", "nullable": true } } }, "PersonLocationInfo": { "type": "object", "properties": { "country": { "$ref": "#/components/schemas/CountryInfo" }, "address": { "type": "string", "nullable": true } }, "description": "The location information of the person", "nullable": true }, "PersonLookupRequest": { "required": [ "email" ], "type": "object", "properties": { "email": { "type": "string", "description": "The email address of the person to look up" } } }, "PersonSocialUrls": { "type": "object", "properties": { "linkedin_url": { "type": "string", "description": "The LinkedIn URL of the company", "format": "uri", "nullable": true } }, "description": "The social URLs of the person" }, "ProblemDetails": { "type": "object", "properties": { "type": { "type": "string", "nullable": true }, "title": { "type": "string", "nullable": true }, "status": { "type": "integer", "format": "int32", "nullable": true }, "detail": { "type": "string", "nullable": true }, "instance": { "type": "string", "nullable": true } } } }, "securitySchemes": { "Bearer": { "type": "apiKey", "description": "API Token used for authentication. Example: \"Authorization: Bearer {token}\"", "name": "Authorization", "in": "header", "x-bearer-format": "bearer" } } }, "security": [ { "Bearer": [] } ], "tags": [ { "name": "People / Search", "description": "Search people by various criteria with page-based or cursor-based pagination." } ] } ````