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

# Get Contractors

> Retrieve information on contractors for a company, with optional filters.

This uses the same underlying endpoint as [Get Contractor Information](/reference/contractors/get-contractor-information), which looks up a single contractor by `contractorID` instead of listing/filtering - the API does not distinguish these with separate routes, so the query parameters accepted differ by intended usage. This page's usage: pass `companyID` and any of the optional filters below (omit `contractorID`) to get a filtered list of contractors.


## OpenAPI

````yaml openapi/zeal-api.json get /contractors
openapi: 3.1.0
info:
  title: zeal-api
  version: '1.0'
servers:
  - url: https://api.zeal.com
security:
  - sec0: []
paths:
  /contractors:
    get:
      summary: Get Contractor Information
      description: Request key information from The Contractor Object
      operationId: retrieve-contractor-information
      parameters:
        - name: companyID
          in: query
          description: Company ID of employer
          required: true
          schema:
            type: string
        - name: contractorID
          in: query
          description: ID of Contractor
          required: false
          schema:
            type: string
        - name: onboarded
          in: query
          description: Filter by Contractor onboarded status
          required: false
          schema:
            type: boolean
        - name: employment_status
          in: query
          description: Filter by Contractor employment status
          required: false
          schema:
            type: string
        - name: type
          in: query
          description: Filter by Contractor type
          required: false
          schema:
            type: string
            enum:
              - business
              - individual
        - name: email
          in: query
          description: Filter by Contractor email
          required: false
          schema:
            type: string
        - name: external_id
          in: query
          description: Filter by Contractor external ID
          required: false
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                Result:
                  value:
                    success: true
                    data:
                      contractorID: '1234567890'
                      companyID: 1b5n28nrideucd24
                      onboarded: true
                      type: partnership
                      first_name: erlich
                      middle_name: 'null'
                      last_name: bachman
                      email: erlichbachman2@zeal.com
                      working_state: MA
                      ssn: '123456789'
                      ein: 'null'
                      business_name: 'null'
                      address: 320 Pancake Hollow Road
                      city: Highland
                      state: NY
                      zip: '12528'
                      employment_status: live
                      external_id: '1234'
                      paycard_requested: false
                      paycard_enabled: false
                      kyc_status: approved
                      ssn_verification_status: approved
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                    default: true
                  data:
                    type: object
                    properties:
                      contractorID:
                        type: string
                        example: '1234567890'
                      companyID:
                        type: string
                        example: 1b5n28nrideucd24
                      onboarded:
                        type: boolean
                        example: true
                        default: true
                      type:
                        type: string
                        example: partnership
                      first_name:
                        type: string
                        example: erlich
                      middle_name:
                        type: string
                        example: 'null'
                      last_name:
                        type: string
                        example: bachman
                      email:
                        type: string
                        example: erlichbachman2@zeal.com
                      working_state:
                        type: string
                        example: MA
                      ssn:
                        type: string
                        example: '123456789'
                      ein:
                        type: string
                        example: 'null'
                      business_name:
                        type: string
                        example: 'null'
                      address:
                        type: string
                        example: 320 Pancake Hollow Road
                      city:
                        type: string
                        example: Highland
                      state:
                        type: string
                        example: NY
                      zip:
                        type: string
                        example: '12528'
                      employment_status:
                        type: string
                        example: live
                      external_id:
                        type: string
                        example: '1234'
                      paycard_requested:
                        type: boolean
                        example: false
                        default: true
                      paycard_enabled:
                        type: boolean
                        example: false
                        default: true
                      kyc_status:
                        type: string
                        example: approved
                      ssn_verification_status:
                        type: string
                        example: approved
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value:
                    success: false
                    errors:
                      - message: Contractor ID is not formatted correctly
                        code: 13
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                    default: true
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        message:
                          type: string
                          example: Contractor ID is not formatted correctly
                        code:
                          type: integer
                          example: 13
                          default: 0
      deprecated: false
components:
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: Authorization
      x-bearer-format: bearer

````