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

# addCompanyLocation

> 
The `addCompanyLocation` API is used to add a company location. This step sets up the company's primary physical location and is essential for regional compliance, tax jurisdiction, and audit readiness.

### What it does:

- Establishes the company's physical presence and operational address
- Enables proper tax jurisdiction for payroll processing and ensures regional compliance

## Location Options:

| Location | Description |
|----------|-------------|
|**WorkLocation**|Physical addresses where the company has employees working in the United States|
|**MailingAddress**|Address where company correspondence and official mail is sent|
|**FilingAddress**|Address used for tax filings and regulatory submissions with government agencies|

### Notes:
- This step must be completed before beginning the KYB verification process and is required for accurate payroll processing across different jurisdictions.
- Companies must maintain **at least one** filing address at all times



## OpenAPI

````yaml post /companyOnboarding/addCompanyLocation
openapi: 3.0.1
info:
  title: Default module
  description: ''
  version: 1.0.0
servers: []
security:
  - basic: []
tags: []
paths:
  /companyOnboarding/addCompanyLocation:
    post:
      tags: []
      summary: addCompanyLocation
      description: >-

        The `addCompanyLocation` API is used to add a company location. This
        step sets up the company's primary physical location and is essential
        for regional compliance, tax jurisdiction, and audit readiness.


        ### What it does:


        - Establishes the company's physical presence and operational address

        - Enables proper tax jurisdiction for payroll processing and ensures
        regional compliance


        ## Location Options:


        | Location | Description |

        |----------|-------------|

        |**WorkLocation**|Physical addresses where the company has employees
        working in the United States|

        |**MailingAddress**|Address where company correspondence and official
        mail is sent|

        |**FilingAddress**|Address used for tax filings and regulatory
        submissions with government agencies|


        ### Notes:

        - This step must be completed before beginning the KYB verification
        process and is required for accurate payroll processing across different
        jurisdictions.

        - Companies must maintain **at least one** filing address at all times
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                method:
                  type: string
                  title: addCompanyLocation
                  example: addCompanyLocation
                companyLocation:
                  type: object
                  properties:
                    companyId:
                      type: string
                      format: uuid
                    companyLocation:
                      type: string
                      title: Enum
                      maxLength: 20
                      example: 'Suggested Values : Main, Branch, Corporate'
                    address1:
                      type: string
                      maxLength: 40
                    address2:
                      type: string
                      maxLength: 40
                      title: mandatory
                    city:
                      type: string
                      maxLength: 40
                    state:
                      type: string
                      title: Enum
                      maxLength: 2
                      enum:
                        - TX
                        - AK
                        - ND
                        - IL
                        - MA
                        - KS
                        - AS
                        - AL
                        - UT
                        - SD
                        - MI
                        - DC
                        - GA
                        - SC
                        - TN
                        - OK
                        - CO
                        - CA
                        - ME
                        - MO
                        - WY
                        - MD
                        - VT
                        - NM
                        - CT
                        - AZ
                        - WI
                        - VA
                        - WV
                        - NJ
                        - DE
                        - NC
                        - PR
                        - IN
                        - MT
                        - NH
                        - HI
                        - IA
                        - KY
                        - WA
                        - OH
                        - FL
                        - OR
                        - MP
                        - GU
                        - MN
                        - MS
                        - PA
                        - NE
                        - RI
                        - ID
                        - LA
                        - NY
                        - NV
                        - AR
                    zipcode:
                      type: string
                      title: Must be Five or Nine Digits
                    phoneNumber:
                      type: string
                      title: Must be 10 digits
                      example: '9874563210'
                    isWorkLocation:
                      type: boolean
                      title: mandatory
                    isMailingAddress:
                      type: boolean
                      title: mandatory
                    isFilingAddress:
                      type: boolean
                      title: mandatory
                  required:
                    - companyId
                    - companyLocation
                    - address1
                    - city
                    - state
                    - zipcode
                    - isWorkLocation
                    - isMailingAddress
                    - isFilingAddress
                  x--orders:
                    - companyLocation
                    - address1
                    - city
                    - state
                    - zipcode
                    - country
                    - phoneNumber
                    - isWorkLocation
                    - isMailingAddress
                    - isFilingAddress
                    - companyId
                    - address2
              required:
                - method
                - companyLocation
              x--orders:
                - method
                - companyLocation
            example:
              method: addCompanyLocation
              companyLocation:
                companyId: 33A04AFB-4317-464A-B1E0-BAB610086174
                companyLocation: Main
                address1: 8745 Colard Ln
                address2: ''
                city: Lyons
                state: CO
                zipcode: '80540'
                phoneNumber: '9889890989'
                isWorkLocation: true
                isMailingAddress: true
                isFilingAddress: true
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  companyLocation:
                    type: object
                    properties:
                      companyLocationId:
                        type: string
                      status:
                        type: string
                      message:
                        type: string
                    required:
                      - status
                      - companyLocationId
                    x--orders:
                      - companyLocationId
                      - status
                      - message
                required:
                  - companyLocation
                x--orders:
                  - companyLocation
              examples:
                '1':
                  summary: Success
                  value:
                    companyLocation:
                      companyLocationId: EAE2367A-F86E-4495-B403-627FCCFD8184
                      status: Verification pending
                      message: Company Location has been saved successfully.
                '2':
                  summary: Exception
                  value:
                    error:
                      - code: 400
                        message: Company Location is mandatory and cannot be empty.
          headers: {}
        '400':
          description: ''
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: array
                    items:
                      type: object
                      properties:
                        code:
                          type: integer
                        message:
                          type: string
                      required:
                        - code
                required:
                  - error
          headers: {}
      deprecated: false
      security:
        - basic: []
components:
  securitySchemes:
    basic:
      type: http
      scheme: basic

````