> ## Documentation Index > Fetch the complete documentation index at: https://docs.bigdata.com/llms.txt > Use this file to discover all available pages before exploring further. # Private Company People > Returns the people who hold or held a position at one private company: who they are, their title, what kind of position it is, whether they still hold it, and when it started and ended. One company per request, keyed by RavenPack entity ID. Results are paged: send back `pagination.cursor` to get the next page, and keep going until `pagination.has_cursor` is false. A company the data provider has no positions for comes back with an empty `results`. ## OpenAPI ````yaml /api-rest/openapi/openapi_structured_data.json post /v1/private-company-people/query openapi: 3.1.0 info: title: Bigdata Structured Data API description: Bigdata API documentation version: 1.0.0 servers: - url: https://api.bigdata.com/ security: - ApiKeyAuth: [] tags: - name: Market Data description: >- Market data endpoints including intraday prices, daily prices, price changes, and real-time quotes - name: Analyst Estimates description: >- Analyst estimates and ratings including analyst ratings, estimates, target prices, and earnings surprises - name: Financials & Ratios description: >- Financial statements and ratios including balance sheet, income statement, cash flow statement, key metrics TTM, and company ratios TTM - name: Company & Events description: >- Company information and events including company profile and events calendar - name: Fund Holdings description: >- Institutional fund holdings from SEC 13F filings including fund holdings and stock fund holdings - name: Knowledge Graph description: Corporate ownership and hierarchy data. - name: Private Markets description: >- Private company data including profile, headquarters, funding totals and valuation - name: Fixed Income description: 'Bond reference data: the bonds a company has issued and their terms' paths: /v1/private-company-people/query: post: tags: - Private Markets summary: Private Company People description: >- Returns the people who hold or held a position at one private company: who they are, their title, what kind of position it is, whether they still hold it, and when it started and ended. One company per request, keyed by RavenPack entity ID. Results are paged: send back `pagination.cursor` to get the next page, and keep going until `pagination.has_cursor` is false. A company the data provider has no positions for comes back with an empty `results`. operationId: Private_Company_People_v1_private_company_people_query_post requestBody: content: application/json: schema: $ref: '#/components/schemas/PublicPeopleQuery' required: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PublicPeopleResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/BadRequestError' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/TooManyRequestsError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerError' components: schemas: PublicPeopleQuery: properties: identifier: $ref: '#/components/schemas/SingleIdentifier' description: >- Object specifying which identifier you are using to request the company profile. You must supply one type and its corresponding value. limit: type: integer maximum: 100 minimum: 1 title: Limit description: Positions to return, from 1 to 100. default: 100 examples: - 100 cursor: anyOf: - type: string maxLength: 256 - type: 'null' title: Cursor description: >- Token for the next page. Send back 'pagination.cursor' from the previous response, unchanged and with the same identifier; 'limit' may differ. Omit it for the first page. additionalProperties: false type: object required: - identifier title: PublicPeopleQuery example: identifier: type: rp_entity_id value: UWCVKI limit: 100 PublicPeopleResponse: properties: results: items: $ref: '#/components/schemas/PublicPosition' type: array title: Results description: >- People who hold or held a position at the company, one entry per position, in the order the data provider lists them. A response holds one page; send `pagination.cursor` back as `cursor` for the next. Empty when the provider has no positions for the company. errors: anyOf: - items: $ref: '#/components/schemas/ErrorDetail' type: array - type: 'null' title: Errors metadata: $ref: '#/components/schemas/PublicPeopleMetadata' pagination: anyOf: - $ref: '#/components/schemas/Pagination' - type: 'null' sources: items: $ref: '#/components/schemas/Source' type: array title: Sources description: >- The content catalog sources the response was built from, one entry per source. Empty when no catalog source contributed. usage: anyOf: - $ref: '#/components/schemas/Usage' - type: 'null' description: >- Tokens the request consumed, per content tier. Present only for API keys billed in tokens. type: object required: - results - metadata title: PublicPeopleResponse BadRequestError: properties: statusCode: type: integer const: 400 title: Statuscode default: 400 message: type: string title: Message type: object required: - message title: BadRequestError description: Bad Request Error example: message: Bad Request Error statusCode: 400 TooManyRequestsError: properties: statusCode: type: integer const: 429 title: Statuscode default: 429 message: type: string title: Message type: object required: - message title: TooManyRequestsError description: Too many requests. Please try again later. example: message: Too many requests. Please try again later. statusCode: 429 InternalServerError: properties: statusCode: type: integer const: 500 title: Statuscode default: 500 message: type: string title: Message type: object required: - message title: InternalServerError description: Internal Server Error example: message: Internal Server Error statusCode: 500 SingleIdentifier: properties: type: $ref: '#/components/schemas/IdentifierTypeEnum' description: >- Object specifying which identifier you are using to request the data. You must supply one type and its corresponding value. Only one identifier should be provided per request. examples: - rp_entity_id value: type: string maxLength: 6 minLength: 6 title: Value description: >- Bigdata uses the RavenPack Entity identifier (RP_Entity_ID) to uniquely reference entities such as companies. This identifier is a 6-character alphanumeric code (letters and numbers only). Example: Alphabet Inc. (`4A6F00`) examples: - 4A6F00 type: object required: - type - value title: SingleIdentifier PublicPosition: properties: name: anyOf: - type: string - type: 'null' title: Name description: Name of the person who holds or held the position. examples: - Sam Altman title: anyOf: - type: string - type: 'null' title: Title description: The position's title. examples: - Co-Founder and CEO role_type: anyOf: - $ref: '#/components/schemas/RoleType' - type: 'null' description: The kind of position. examples: - executive is_current: anyOf: - type: boolean - type: 'null' title: Is Current description: Whether the person still holds the position. started_on: anyOf: - $ref: '#/components/schemas/DateWithPrecision' - type: 'null' description: Date the person started in the position. ended_on: anyOf: - $ref: '#/components/schemas/DateWithPrecision' - type: 'null' description: Date the person left the position. type: object title: PublicPosition description: One position a person holds or held at the company. ErrorDetail: properties: message: anyOf: - type: string - type: 'null' title: Message type: object title: ErrorDetail PublicPeopleMetadata: properties: request_id: anyOf: - type: string - type: 'null' title: Request Id timestamp: type: string title: Timestamp rp_entity_id: type: string maxLength: 6 minLength: 6 title: Rp Entity Id description: The RavenPack entity ID of the company requested. examples: - UWCVKI type: object required: - rp_entity_id title: PublicPeopleMetadata Pagination: properties: cursor: anyOf: - type: string - type: 'null' title: Cursor description: Next page token or URL to retrieve the next page of results. examples: - 00000DexaRK4NT6t has_cursor: type: boolean title: Has Cursor description: Whether there are more pages available after this one. default: false examples: - true type: object title: Pagination description: Common pagination response for endpoints that support pagination. Source: properties: id: type: string title: Id description: Content catalog identifier of the source. examples: - CA9FA3 name: type: string title: Name description: Catalog name of the dataset the data came from. examples: - Corporate Fundamentals type: object required: - id - name title: Source description: >- A content catalog source that contributed data to a structured-data response. Usage: additionalProperties: type: integer type: object title: Usage description: >- Public structured-data usage for a request, aggregated per content tier. A flat object keyed per content tier, where each key is derived from the content tier identifier by dropping the ``content-`` prefix and appending ``_tokens`` (e.g. ``corporate-fundamentals`` -> ``corporate_fundamentals_tokens``). It is sparse: only tiers with non-zero tokens appear, and an absent key means zero tokens for that tier. IdentifierTypeEnum: type: string enum: - rp_entity_id title: IdentifierTypeEnum RoleType: anyOf: - type: string enum: - executive - employee - advisor - board_member - board_observer title: RoleType description: What kind of position a person holds at a company. - type: string DateWithPrecision: properties: value: type: string format: date title: Value description: The date. examples: - '2015-12-08' precision: anyOf: - $ref: '#/components/schemas/DatePrecision' - type: 'null' description: >- How much of the date is known. Parts of the date beyond it carry no meaning. examples: - day type: object required: - value title: DateWithPrecision description: A date that may be known only to the month or the year. DatePrecision: anyOf: - type: string enum: - day - month - year title: DatePrecision description: >- How much of a date is known. Parts of the date beyond it carry no meaning. - type: string securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.