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

# refreshCompanyBankAccountStatus

> ⚠️ WARNING: Sandbox Only Method. Pleaee do not include this in production flows

### Required inputs:

- `companyId`: The ID of the test company, not an individual bank account ID.

### Response:

A `bankAccountStatus` of `ready` or `active` indicates success. If no active funding source exists, the method returns `success: false` with an empty status.

### Notes:

- Link a company bank account before retrying a response with no active funding source.
- Sandbox routing numbers must be valid; this method does not bypass routing-number validation or bank account verification.
- Account verification may take up to 1 hour in sandbox. If the status still will not flip after this time, please reach out to support.



## OpenAPI

````yaml POST /sandbox/refreshCompanyBankAccountStatus
openapi: 3.1.0
info:
  title: Default module
  description: |
    Webhook events emitted when a company's KYB status is created or changes.

    Rollfi sends these requests to the webhook URL configured for the client.
    Consumers should return a successful 2xx response after accepting the event.
  version: 1.0.0
servers: []
security: []
tags:
  - name: Admin Portal
  - name: TimeOff Admin
  - name: TimeTracking Admin
  - name: TimeOff User
  - name: TimeTracking User
  - name: TimeTracking Reports
  - name: TimeOff Reports
  - name: Pay Schedule Webhooks
  - name: Pay Period Webhooks
  - name: Employee Bank Account Webhooks
  - name: Employee KYC Webhooks
  - name: Company Bank Account Webhooks
  - name: Company Webhooks
  - name: Employee Status Webhooks
  - name: Sandbox
paths:
  /sandbox/refreshCompanyBankAccountStatus:
    post:
      tags:
        - Sandbox
      summary: refreshCompanyBankAccountStatus
      description: >-
        ⚠️ WARNING: Sandbox Only Method. Pleaee do not include this in
        production flows


        ### Required inputs:


        - `companyId`: The ID of the test company, not an individual bank
        account ID.


        ### Response:


        A `bankAccountStatus` of `ready` indicates success. If no active funding
        source exists, the method returns `success: false` with an empty status.


        ### Notes:


        - Link a company bank account before retrying a response with no active
        funding source.

        - Sandbox routing numbers must be valid; this method does not bypass
        routing-number validation or bank account verification.

        - Account verification may take up to 1 hour in sandbox. If the status
        still will not flip after this time, please reach out to support.
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                method:
                  type: string
                  default: refreshCompanyBankAccountStatus
                companyId:
                  type: string
                  format: uuid
                  description: The ID of the sandbox company.
              required:
                - method
                - companyId
            example:
              method: refreshCompanyBankAccountStatus
              companyId: 8b2f4a91-6c35-4d7e-9a10-2f83c5e6b074
      responses:
        '200':
          description: >-
            The current bank account result or an error response. Check the
            response body rather than relying on the HTTP status alone.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  bankAccountStatus:
                    type: string
                    description: >-
                      A ready or active status indicates that at least one
                      active company funding source is approved. May be empty if
                      no status is available.
                  message:
                    type: string
                  error:
                    type:
                      - object
                      - string
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
              examples:
                '1':
                  summary: Success
                  value:
                    success: true
                    bankAccountStatus: ready
                    message: Company bank account status is ready.
          headers: {}
      deprecated: false
      security: []

````

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