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

# People in company search

> Find the people at one company

Returns the people at one company, narrowed by people filters. Records have the same shape as
[people search](https://docs.firmable.com/partner/people-search.md).

Get `companyId` from [company search](https://docs.firmable.com/partner/company-search.md). The body accepts the six
[people filters](https://docs.firmable.com/partner/filters.md#people-filters) only. An unknown company id returns no records.


## OpenAPI

````yaml POST /partner/{partner}/companies/{companyId}/people
openapi: 3.0.1
info:
  title: Firmable API
  description: >-
    The Firmable API provides access to company and people data across multiple
    countries including Australia, New Zealand, Singapore, Malaysia, Indonesia,
    Philippines, Hong Kong, Japan, Vietnam, South Korea, Thailand, United
    States, and Canada. Use it to look up company profiles, retrieve contact
    information, and search for people by company, position, seniority, and
    department.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.firmable.com
security:
  - bearerAuth: []
paths:
  /partner/{partner}/companies/{companyId}/people:
    post:
      description: >-
        Returns the people at one company, narrowed by people filters. An
        unknown company id returns no records.
      parameters:
        - name: partner
          in: path
          required: true
          description: >-
            Your platform's identifier. Firmable gives it to you during
            onboarding.
          schema:
            type: string
        - name: companyId
          in: path
          required: true
          description: >-
            Firmable company id, starting f, from company search. (example:
            f000000000101)
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerPeopleInCompanyRequest'
            example:
              filters:
                department:
                  - '14'
              page:
                from: 0
                size: 25
      responses:
        '200':
          description: People at the company
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PartnerPeopleSearch'
              example:
                records:
                  - id: fp000000000201
                    name: Jordan Lee
                    position: Chief Financial Officer
                    company_name: Harbourline Logistics
                    company_id: f000000000101
                    has_email: true
                    has_phone: true
                    has_mobile: true
                    has_dnd_phone: false
                total: 41
                page:
                  from: 0
                  size: 25
        '401':
          description: Missing or invalid API key
components:
  schemas:
    PartnerPeopleInCompanyRequest:
      type: object
      properties:
        filters:
          type: object
          description: >-
            An object of filter identifier to an array of 1 to 100 codes. Codes
            within one filter are combined with OR. Different filters are
            combined with AND. Get codes from GET /filter-options. Accepts the
            six people filters only.
          properties:
            position:
              type: array
              description: >-
                Job title. Free text. Example codes: contains:chief financial
                officer
              minItems: 1
              maxItems: 100
              items:
                type: string
            seniority:
              type: array
              description: 'Seniority. List codes. Example codes: 3, 4'
              minItems: 1
              maxItems: 100
              items:
                type: string
            department:
              type: array
              description: 'Department. List codes. Example codes: 2, 14'
              minItems: 1
              maxItems: 100
              items:
                type: string
            skills:
              type: array
              description: 'Skills. Free text. Example codes: contains:python'
              minItems: 1
              maxItems: 100
              items:
                type: string
            current_role_duration:
              type: array
              description: 'Job change. List codes. Example codes: 4, 13'
              minItems: 1
              maxItems: 100
              items:
                type: string
            people_location:
              type: array
              description: 'Location (People). State codes. Example codes: state:QLD, AU:AU'
              minItems: 1
              maxItems: 100
              items:
                type: string
        country:
          type: array
          description: The markets to search, as market codes. Every market when omitted.
          items:
            type: string
            enum:
              - AU
              - NZ
              - SG
              - MY
              - ID
              - PH
              - TH
              - VN
              - HK
              - JP
              - KR
              - US
              - CA
        page:
          type: object
          properties:
            from:
              type: integer
              minimum: 0
              maximum: 10000
              default: 0
              description: Offset, 0 to 10,000.
            size:
              type: integer
              minimum: 1
              maximum: 100
              default: 25
              description: Records per page, 1 to 100.
    PartnerPeopleSearch:
      type: object
      properties:
        records:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                description: >-
                  Firmable person id. Pass it to people enrichment for contact
                  details.
              name:
                type: string
                description: Full name
              position:
                type: string
                description: Current job title
              company_name:
                type: string
                description: Employer name
              company_id:
                type: string
                description: Employer's Firmable company id
              has_email:
                type: boolean
                description: Firmable holds a work email for the person
              has_phone:
                type: boolean
                description: Firmable holds a phone number for the person
              has_mobile:
                type: boolean
                description: Firmable holds a mobile number for the person
              has_dnd_phone:
                type: boolean
                description: >-
                  A phone number Firmable holds for the person is on a Do Not
                  Call register
        total:
          type: integer
          description: Total matching people
        page:
          type: object
          properties:
            from:
              type: integer
              minimum: 0
              maximum: 10000
              default: 0
              description: Offset, 0 to 10,000.
            size:
              type: integer
              minimum: 1
              maximum: 100
              default: 25
              description: Records per page, 1 to 100.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.