FactSet People API
Fetch People Profiles, Job History, or get associated positions and names of companies.
OpenAPI Specification
openapi: 3.0.0
info:
title: FactSet People API
version: 1.2.0
description: |
The FactSet People API exposes FactSet data for individuals and their jobs.
contact:
name: FactSet Research Systems
email: [email protected]
servers:
- url: https://api.factset.com/content
description: Production Server
security:
- BasicAuth: []
tags:
- name: Factset People
paths:
/factset-people/v1/profiles:
get:
summary: Factset Return information about the person with the specified entity ID.
description: >
Returns a summary of basic information about the person referenced by
the entityId specified in the URI.
tags:
- Factset People
operationId: getPeopleProfiles
parameters:
- $ref: '#/components/parameters/profileEntityId'
responses:
'200':
description: Array of Profile Ojects
content:
application/json:
schema:
$ref: '#/components/schemas/peopleProfilesResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
post:
summary: Factset Returns profile information for a large list of people.
tags:
- Factset People
operationId: getPeopleProfilesForList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/peopleProfilesRequest'
responses:
'200':
description: Array of People Profile Objects
content:
application/json:
schema:
$ref: '#/components/schemas/peopleProfilesResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
/factset-people/v1/jobs:
get:
summary: Factset Returns the Job history of the person.
description: >
Returns the `Job` history of the person referenced by the entityId
specified in the request.
tags:
- Factset People
operationId: getPeopleJobs
parameters:
- $ref: '#/components/parameters/entityId'
- $ref: '#/components/parameters/status'
- $ref: '#/components/parameters/level'
- $ref: '#/components/parameters/type'
responses:
'200':
description: Array of Job objects.
content:
application/json:
schema:
$ref: '#/components/schemas/peopleJobsResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
post:
summary: Factset Returns the Job history for the large list of people.
description: >
Returns the `Job` history of the person referenced by the entityId
specified in the request.
tags:
- Factset People
operationId: getPeopleJobsForList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/peopleJobsRequest'
responses:
'200':
description: Array of Job objects.
content:
application/json:
schema:
$ref: '#/components/schemas/peopleJobsResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
/factset-people/v1/company-people:
get:
summary: Factset Returns the list of people for the specified company identifiers
description: >
Returns the list of executives associated the company identifier
requested. Information includes the job functions, email, phone, title,
name, and FactSet Entity Identifier. The personId returned can then be
used in the `/profiles` endpoint to learn more about the given person.
tags:
- Factset People
operationId: getCompanyPeople
parameters:
- $ref: '#/components/parameters/companyId'
- $ref: '#/components/parameters/jobFunction'
responses:
'200':
description: Array of Company People objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyPeopleResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
post:
summary: >-
Factset Returns the list of people associated for a large list of company identitifers
description: >
Returns the list of executives associated the company identifier
requested. Information includes the job functions, email, phone, title,
name, and FactSet Entity Identifier. The personId returned can then be
used in the /profiles endpoint to learn more about the given person.
tags:
- Factset People
operationId: getCompanyPeopleForList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/companyPeopleRequest'
responses:
'200':
description: Array of Company People objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyPeopleResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
/factset-people/v1/company-positions:
get:
summary: >-
Factset Returns the list of people for the specified company identifiers and position
description: >
Returns the list of people, name, and title for a list of company ids
and requested position. Positions include-
* Chairman
* Chief Executive Officer
* President
* Chief Operating Officer
* Chief Financial Officer
* Chief Technology Officer
* Chief Investment Officer
* Founder(s)
* Compliance Officer
* Admin
* Independent Director
* Directors/Board Members
* Investor Relations
* Legal Counsel
* Treasurer
* Sales and Marketing Managers
* Human Resources
tags:
- Factset People
operationId: getCompanyPositions
parameters:
- $ref: '#/components/parameters/companyId'
- $ref: '#/components/parameters/position'
responses:
'200':
description: Array of Company Positions objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyPositionsResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
post:
summary: >-
Factset Returns the list of people associated for a large list of company identitifers and position
description: >
Returns the list of people, name, and title for a list of company ids
and requested position. Positions include-
* Chairman
* Chief Executive Officer
* President
* Chief Operating Officer
* Chief Financial Officer
* Chief Technology Officer
* Chief Investment Officer
* Founder(s)
* Compliance Officer
* Admin
* Independent Director
* Directors/Board Members
* Investor Relations
* Legal Counsel
* Treasurer
* Sales and Marketing Managers
* Human Resources
tags:
- Factset People
operationId: getCompanyPositionsForList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/companyPositionsRequest'
responses:
'200':
description: Array of Company Positions objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyPositionsResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
/factset-people/v1/company-compensation:
get:
summary: >-
Factset Returns the compensation details of the people for the specified company identifier
description: >-
Returns the list of company-level executive compensation data items for
the top executives listed in annual filings.The coverage of the
compensation details for the executives are limited to US region. All
the compensation figures are expressed in raw units.
tags:
- Factset People
operationId: getCompanyCompensation
parameters:
- $ref: '#/components/parameters/companyId'
responses:
'200':
description: Array of Company Compensation objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyCompensationResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
post:
summary: >-
Factset Returns the compensation details for the people for the specified company identifier
description: >-
Returns the list of company-level executive compensation data items for
the top executives listed in annual filings for the most recent fiscal
year. The coverage of the compensation details for the executives are
limited to US region. All the compensation figures are expressed in raw
units.
tags:
- Factset People
operationId: getCompanyCompensationForList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/companyCompensationRequest'
responses:
'200':
description: Array of Company Positions objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyCompensationResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
/factset-people/v1/company-stats:
get:
summary: Factset Returns statistics about top leadership of a company.
description: >
Returns the statistics such as the average age, tenure, compensation of
leadership, number of executives, and the gender diversity of
leadership. We can utilize the data for analyzing a company's board and
management.
tags:
- Factset People
operationId: getCompanyStats
parameters:
- $ref: '#/components/parameters/companyId'
- $ref: '#/components/parameters/mbType'
responses:
'200':
description: Array of Company Stats objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyStatsResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
post:
summary: Factset Returns statistics about top leadership of a company.
description: >-
Returns the statistics such as the average age, tenure, compensation of
leadership, number of executives, and the gender diversity of
leadership. We can utilize the data for analyzing a company's board and
management.
tags:
- Factset People
operationId: getCompanyStatsForList
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/companyStatsRequest'
responses:
'200':
description: Array of Company Positions objects.
content:
application/json:
schema:
$ref: '#/components/schemas/companyStatsResponse'
'400':
$ref: '#/components/responses/400'
'401':
$ref: '#/components/responses/401'
'403':
$ref: '#/components/responses/403'
'415':
$ref: '#/components/responses/415'
'500':
$ref: '#/components/responses/500'
components:
securitySchemes:
BasicAuth:
type: http
scheme: basic
parameters:
entityId:
name: ids
description: List of FactSet Person Entity identifier.
in: query
schema:
type: array
items:
type: string
minItems: 1
maxItems: 1000
required: true
explode: false
example:
- 0DPHLH-E
- 07MZV9-E
profileEntityId:
name: ids
description: List of FactSet Person Entity identifier.
in: query
schema:
type: array
items:
type: string
minItems: 1
maxItems: 500
required: true
explode: false
example:
- 0DPHLH-E
- 07MZV9-E
status:
name: status
description: Select only Jobs with a certain status primary, active, or inactive.
in: query
schema:
type: string
enum:
- ALL
- PRIMARY
- ACTIVE
- INACTIVE
default: ALL
level:
name: level
description: >-
Select the level of detail only main Jobs or include other Jobs at a
company.
in: query
schema:
type: string
enum:
- SUMMARY
- DETAIL
default: DETAIL
type:
name: type
description: Select only Jobs of a certain type board member or employee.
in: query
schema:
type: string
enum:
- ALL
- BRD
- EMP
default: ALL
companyId:
name: ids
description: >
The requested company identifier. FactSet Identifiers, tickers, CUSIP,
SEDOL, and ISIN are accepted inputs. <p>***ids limit** = 1000 per
request*</p>
*<p>Make note, GET Method URL request lines are also limited to a total
length of 8192 bytes (8KB). In cases where the service allows for
thousands
of ids, which may lead to exceeding this request line limit of 8KB, its
advised for any requests with large request lines to be requested
through
the respective "POST" method.</p>*
in: query
schema:
type: array
items:
type: string
minItems: 1
maxItems: 1000
required: true
explode: false
example:
- AAPL-US
- IBM-US
jobFunction:
name: function
description: >-
Controls the types of people returned based on high-level job functions.
Filter by - |function|description| ||| |PEOPLE|Retrieve **ALL**
Executives of a requested company| |OFFICER|Retrieve only the Officers
of a requested company| |DIRECTOR|Retrieve only the Directors of a
requested company|
in: query
schema:
type: string
enum:
- PEOPLE
- OFFICER
- DIRECTOR
example: PEOPLE
default: PEOPLE
required: false
position:
name: position
description: >
Controls the position details returned for the requested company. By
default, the service returns the CEO name, title, and ID for the
requested company ids.
|position|description|
|||
|CHAIR|Chairman|
|CEO|Chief Executive Officer|
|PRES|President|
|COO|Chief Operating Officer|
|CFO|Chief Financial Officer|
|CTO|Chief Technology Officer|
|CIO|Chief Investment Officer|
|FOU|Founder(s)|
|CMP|Compliance Officer|
|ADM|Admin|
|IND|Independent Director|
|BRD|Directors/Board Members|
|IR|Investor Relations|
|LEG|Legal Counsel|
|TREAS|Treasurer|
|MKT|Sales and Marketing Managers|
|HR|Human Resources|
in: query
schema:
type: string
enum:
- CHAIR
- CEO
- PRES
- COO
- CFO
- CTO
- CIO
- FOU
- CMP
- ADM
- IND
- BRD
- IR
- LEG
- TREAS
- MKT
- HR
example: FOU
default: CEO
required: false
mbType:
name: mbType
description: >-
Search based on the management and board types. The types include -
|type|description|||||MB|Management & Board||MGMT|Management||BRD|Board|
in: query
schema:
type: string
enum:
- MB
- MGMT
- BRD
default: MB
schemas:
peopleProfilesRequest:
title: Profiles Request
type: object
properties:
ids:
$ref: '#/components/schemas/ids'
required:
- ids
peopleProfilesResponse:
title: Profiles Response
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/profile'
profile:
title: Profile
type: object
description: Basic information about a person entity.
properties:
requestId:
type: string
description: Person identifier used in the request.
example: 0DPHLH-E
personId:
description: FactSet Entity Identifier for the Person
type: string
example: 0DPHLH-E
nullable: true
lastName:
description: Last Name
type: string
example: Snow
x-fds-fql-formula: FPD_PERSON('LAST_NAME')
nullable: true
factsetName:
description: Name
type: string
example: Philip Snow
x-fds-fql-formula: FPD_PERSON('NAME')
nullable: true
firstName:
description: First Name
type: string
example: Frederick
x-fds-fql-formula: FPD_PERSON('FIRST_NAME')
nullable: true
middleName:
description: Middle Name
type: string
example: Philip
x-fds-fql-formula: FPD_PERSON('MIDDLE_NAME')
nullable: true
formalName:
description: Formal Name
type: string
example: Frederick Philip Snow
x-fds-fql-formula: FPD_PERSON('FORMAL_NAME')
nullable: true
properName:
description: Proper Name
type: string
example: Snow Frederick Philip CFA
x-fds-fql-formula: PROPER_NAME
nullable: true
salutation:
description: Primary Salutation of Name
type: string
example: Mr.
x-fds-fql-formula: FPD_PERSON(SALUTATION)
nullable: true
highestDegree:
description: The Highest Held Degree Code.
type: string
example: GRD
x-fds-fql-formula: FPD_PERSON('EDU_DEGREE_CODE')
nullable: true
highestDegreeInst:
description: The Highest Degree Institution Name.
type: string
example: Thunderbird School of Global Management
x-fds-fql-formula: FPD_PERSON('EDU_INST')
nullable: true
suffix:
description: Suffix of Name
type: string
example: CFA
x-fds-fql-formula: FPD_PERSON('SUFFIX')
nullable: true
age:
description: Person's age in years.
type: number
format: integer
example: 57
x-fds-fql-formula: FPD_PERSON('AGE')
nullable: true
gender:
description: Person's Gender.
type: string
example: Male
x-fds-fql-formula: FPD_PERSON('GENDER')
nullable: true
salary:
description: Most Recent Salary
type: number
format: integer
example: 525846
x-fds-fql-formula: FPD_PERSON('SALARY')
nullable: true
totalCompensation:
description: Most Recent Total Compensation
type: number
format: integer
example: 4719062
x-fds-fql-formula: FPD_PERSON(TOTAL_COMP)
nullable: true
primaryCompanyId:
description: Entity identifier of primary `Company` of employment.
type: string
example: 0016YD-E
nullable: true
primaryCompanyName:
description: Name of primary company of employment
type: string
example: FactSet Research Systems, Inc.
x-fds-fql-formula: FPD_PERSON('PRIMARY_CO_NAME')
nullable: true
primaryTitle:
description: Title at primary `Company` of employment
type: string
example: Chief Executive Officer & Director
x-fds-fql-formula: FPD_PERSON(PRIMARY_TITLE)
nullable: true
biography:
description: Brief biography of the person requested.
type: string
example: >-
Frederick Philip Snow is Chief Executive Officer & Director at
FactSet Research Systems, Inc. He is also on the board of FactSet
Systems India Pvt Ltd., Quantopian, Inc. and Vermilion Holdings Ltd.
and Member of CFA Institute. Mr. Snow received an undergraduate
degree from the University of California, Berkeley and a graduate
degree from Thunderbird School of Global Management.
x-fds-fql-formula: FPD_PERSON('BIO')
nullable: true
peopleJobsRequest:
title: Jobs Request
type: object
properties:
ids:
$ref: '#/components/schemas/ids'
status:
$ref: '#/components/schemas/status'
level:
$ref: '#/components/schemas/level'
type:
$ref: '#/components/schemas/type'
required:
- ids
peopleJobsResponse:
title: Jobs Response
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/job'
job:
title: Job
type: object
description: Basic information about a person's `Job`.
properties:
companyCity:
description: City the job is located in.
type: string
example: Norwalk
x-fds-fql-formula: FPD_PERSON_JOBS(CITY)
nullable: true
companyId:
description: FactSet Identifier for the company.
type: string
example: 0016YD-E
nullable: true
companyName:
description: Name of the company.
type: string
example: FactSet Research Systems, Inc.
x-fds-fql-formula: FPD_PERSON_JOBS(CO_NAME)
nullable: true
jobEndDate:
description: Ending date for the Job.
type: string
format: date
example: '0001-01-01'
x-fds-fql-formula: FPD_PERSON_JOBS(EDATE)
nullable: true
jobFunctionCode:
description: Job function code.
type: string
example: CEO
x-fds-fql-formula: FPD_PERSON_JOBS(JOB_FUNC_CODE)
nullable: true
jobFunctionName:
description: Description of the job.
type: string
example: Chief Executive Officer
x-fds-fql-formula: FPD_PERSON_JOBS(JOB_FUNC_DESC)
nullable: true
jobStartDate:
description: Starting date for the Job.
type: string
format: date
example: '2015-07-01'
x-fds-fql-formula: FPD_PERSON_JOBS(SDATE)
nullable: true
jobTitle:
description: Job Title
type: string
example: Chief Executive Officer & Director
x-fds-fql-formula: FPD_PERSON_JOBS(TITLE)
nullable: true
personId:
description: FactSet Entity Identifier for the Person.
type: string
example: 0DPHLH-E
nullable: true
requestId:
description: Original identifier used for the request.
type: string
example: 0DPHLH-E
companyPeopleRequest:
title: Company People Request
type: object
properties:
ids:
$ref: '#/components/schemas/companyIds'
function:
$ref: '#/components/schemas/function'
required:
- ids
companyPeopleResponse:
title: Company People Response
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/companyPeople'
companyPeople:
title: Company People
type: object
description: List of executives for the specified company identifier.
properties:
fsymId:
description: FactSet Identifier for the company requested.
type: string
example: 000C7F-E
nullable: true
email:
description: Email of the person
type: string
example:
nullable: true
name:
description: FactSet Name of the person
type: string
example: Tim Cook
nullable: true
jobFunction1:
description: Job Function1
type: string
example: Chief Executive Officer
x-fds-fql-formula: FPD_CO_PEOPLE_JOBFUNC
nullable: true
jobFunction2:
description: Job Function2
type: string
example: Director/Board Member
x-fds-fql-formula: FPD_CO_PEOPLE_JOBFUNC
nullable: true
jobFunction3:
description: Job Function3
type: string
example:
nullable: true
jobFunction4:
description: Job Function4
type: string
example:
x-fds-fql-formula: FPD_CO_PEOPLE_JOBFUNC
nullable: true
mainPhone:
description: Main Phone Numbers of the executives.
type: string
example: 1.408.996.1010
x-fds-fql-formula: FPD_CO_PEOPLE_PHONE_MAIN
nullable: true
personId:
description: FactSet Entity Identifier for the Person.
type: string
example: 05F520-E
nullable: true
phone:
description: Phone number of the executives.
type: string
example:
x-fds-fql-formula: FPD_CO_PEOPLE_PHONE
nullable: true
requestId:
description: Original identifier used for the request.
type: string
example: AAPL-US
title:
description: Executive titles for a specified company.
type: string
example: Chief Executive officer & Director
x-fds-fql-formula: FPD_CO_PEOPLE_TITLES
nullable: true
companyPositionsRequest:
title: Company Positions Request
type: object
properties:
ids:
$ref: '#/components/schemas/companyIds'
position:
$ref: '#/components/schemas/position'
required:
- ids
companyPositionsResponse:
title: Company Positions Response
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/companyPositions'
companyPositions:
title: Company Positions
type: object
description: List of executives for the specified company identifier.
properties:
fsymId:
description: FactSet Identifier for the company.
type: string
example: 006XY7-E
nullable: true
personId:
description: Factset Entity Identifier for the Person
type: string
example: 05H8B8-E
nullable: true
name:
description: FactSet Name of the person
type: string
example: Elon Reeve Musk
nullable: true
title:
description: The requested Position Title
type: string
example: Technoking of Tesla
x-fds-fql-formula: FPD_CO_PEOPLE_BY_POSITION(TITLE)
nullable: true
yearsAtFirm:
description: >-
The number of years individual is at firm. For founders, this is
since inception.
type: number
format: double
example: 17.78
x-fds-fql-formula: FPD_CO_PEOPLE_BY_POSITION(YRS_FIRM))
nullable: true
age:
description: The age of the person requested.
type: number
format: integer
example: 48
x-fds-fql-formula: FPD_CO_PEOPLE_BY_POSITION(AGE))
nullable: true
gender:
description: The Gender of the person requested.
type: string
example: Male
x-fds-fql-formula: FPD_CO_PEOPLE_BY_POSITION(GENDER))
nullable: true
requestPosition:
description: The requested position code.
type: string
example: CEO
nullable: true
requestId:
description: Original identifier used for the request.
type: string
example: TSLA-US
companyCompensationRequest:
title: Company Compensation Request
type: object
properties:
ids:
$ref: '#/components/schemas/companyIds'
required:
- ids
companyCompensationResponse:
title: Company Compensation Response
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/companyCompensation'
companyCompensation:
title: Company Compensation
type: object
description: >-
List of executives and their compensation details for the specified
company identifier.
properties:
name:
description: FactSet Name of the person
type: string
example: Tim Cook
nullable: true
personId:
description: Factset Entity Identifier for the Person
type: string
example: 05F520-E
nullable: true
title:
description: The requested Position Title
type: string
example: Chief Executive Officer & Director
x-fds-fql-formula: FPD_CO_COMPENSATION(EXEC_TITLE)
nullable: true
salary:
descri
# --- truncated at 32 KB (43 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/factset/refs/heads/main/openapi/people-openapi-original.yml