> ## 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 Contractor Information

> Retrieve key information about a single 1099 contractor by contractorID.

This request uses the `contractorID` attribute to return key information about the contractor, contained within the [Contractor Object](/reference/contractors/contractor-object). This is the same underlying route as [Get Contractors](/reference/contractors/get-contractors), which lists/filters instead of looking up a single contractor - the API doesn't distinguish these with separate routes, so each page documents the query parameters for its own intended usage.

<Note>
  This applies to 1099 contractors. For W-2 employees, use the [Get Employee Information](/reference/employees/get-employee-information) request instead.
</Note>

## Returns

Returns response status and the [Contractor Object](/reference/contractors/contractor-object) for the requested contractor.

| attribute | type    | description                                                                                                                                                                        |
| --------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| success   | boolean | Response status                                                                                                                                                                    |
| data      | object  | Contractor Object for the requested contractor                                                                                                                                     |
| errors    | array   | Contains a list of error objects which consists of: `message` (error message) and `code` (error code, see [Error codes](https://docs.zeal.com/reference/introduction/error-codes)) |


## 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

````