find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/forwardai:forwardai-business-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: ForwardAI Precise Business API
  version: 2.0.0
  description: ForwardAI Precise APIs
  contact:
    name: ForwardAI
    url: https://www.forwardai.com
servers:
- url: https://api.forwardai.com
  description: ForwardAI Precise APIs URL (US Region)
- url: https://api.4wdai.com
  description: ForwardAI Precise APIs URL (Sandbox)
tags:
- name: Business
paths:
  /v2/business/:
    post:
      summary: Initiate the business onboarding process
      description: ''
      security:
      - basicAuth: []
      tags:
      - Business
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBusiness'
      responses:
        '201':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Business
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: 5fb651114120bc3baa71c6e7
                      businessName:
                        type: string
                        example: Alex Textiles
                      email:
                        type: string
                        example: alex@companyinfo.com
                      industryType:
                        type: string
                        example: '23'
                      subIndustryType:
                        type: string
                        example: '2'
                      isEmailEnabled:
                        type: boolean
                      isWebhookEnabled:
                        type: boolean
                      connectionUrl:
                        type: string
                        example: https://aibank.forwardai.com/connect/business/6201eb754228d50fc775cd54
                      status:
                        type: string
                        example: PENDING
        '400':
          description: Bad Request Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: postV2Business
      x-operation-id-source: derived
    get:
      summary: Fetch a list of all businesses
      description: ''
      security:
      - basicAuth: []
      tags:
      - Business
      parameters:
      - $ref: '#/components/parameters/pageNumber'
      - $ref: '#/components/parameters/pageSize'
      - $ref: '#/components/parameters/sortOrder'
      - $ref: '#/components/parameters/businessSortBy'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Business List
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: 61090ffb59eea15c1d634e07
                        name:
                          type: string
                          example: Demo Company
                        legalName:
                          type: string
                          example: Demo Company
                        email:
                          type: string
                          example: user@forwardai.com
                        businessEmail:
                          type: string
                          example: dev@forwardai.com
                        website:
                          type: string
                          example: https://www.forwardai.com/
                        industry:
                          type: object
                          properties:
                            code:
                              type: string
                              example: '22'
                            name:
                              type: string
                              example: Utilities
                        subIndustry:
                          type: object
                          properties:
                            code:
                              type: string
                              example: '2212'
                            name:
                              type: string
                              example: Natural Gas Distribution
                        addresses:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                example: BILLING
                              line1:
                                type: string
                                example: 23 Main Street real
                              line2:
                                type: string
                                example: Central city
                              city:
                                type: string
                                example: Marineville
                              country:
                                type: string
                                example: USA
                              postalCode:
                                type: string
                                example: '123456'
                              region:
                                type: string
                                example: New York
                        phoneNumbers:
                          type: array
                          items:
                            type: object
                            properties:
                              type:
                                type: string
                                example: PRIMARY
                              countryCode:
                                type: string
                                example: '+1'
                              phoneNumber:
                                type: string
                                example: '12345678'
                        provider:
                          type: string
                          example: xero
                        status:
                          type: string
                          example: CONNECTED
                        syncStatus:
                          type: string
                          example: COMPLETED
                        connectionUrl:
                          type: string
                          example: https://aibank.forwardai.com/connect/business/6201eb754228d50fc775cd54
                        baseCurrency:
                          type: string
                          example: USD
                        businessStartDate:
                          type: string
                          example: '2021-07-09'
                        fiscalYearStartMonth:
                          type: string
                          example: January
                        connectionDate:
                          type: string
                          example: '2020-11-25'
                        lastModifiedDate:
                          type: string
                          example: '2022-02-10T07:28:26.832Z'
        '400':
          description: Bad Request Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getV2Business
      x-operation-id-source: derived
  /v2/business/{businessId}:
    get:
      summary: Fetch the details of a business
      description: ''
      security:
      - basicAuth: []
      parameters:
      - $ref: '#/components/parameters/businessId'
      tags:
      - Business
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Success
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        example: 61090ffb59eea15c1d634e07
                      name:
                        type: string
                        example: Demo Company
                      legalName:
                        type: string
                        example: Demo Company
                      email:
                        type: string
                        example: user@forwardai.com
                      businessEmail:
                        type: string
                        example: dev@forwardai.com
                      website:
                        type: string
                        example: https://www.forwardai.com/
                      industry:
                        type: object
                        properties:
                          code:
                            type: string
                            example: '22'
                          name:
                            type: string
                            example: Utilities
                      subIndustry:
                        type: object
                        properties:
                          code:
                            type: string
                            example: '2212'
                          name:
                            type: string
                            example: Natural Gas Distribution
                      addresses:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              example: BILLING
                            line1:
                              type: string
                              example: 23 Main Street
                            line2:
                              type: string
                              example: Central city
                            city:
                              type: string
                              example: Marineville
                            country:
                              type: string
                              example: USA
                            postalCode:
                              type: string
                              example: '123456'
                            region:
                              type: string
                              example: New York
                      phoneNumbers:
                        type: array
                        items:
                          type: object
                          properties:
                            type:
                              type: string
                              example: PRIMARY
                            countryCode:
                              type: string
                              example: '+1'
                            phoneNumber:
                              type: string
                              example: '12345678'
                      provider:
                        type: string
                        example: xero
                      status:
                        type: string
                        example: CONNECTED
                      syncStatus:
                        type: string
                        example: COMPLETED
                      connectionUrl:
                        type: string
                        example: https://api.forwardai.com/business/6205f7babc933f577b00b276
                      baseCurrency:
                        type: string
                        example: USD
                      businessStartDate:
                        type: string
                        example: '2021-07-09'
                      fiscalYearStartMonth:
                        type: string
                        example: January
                      connectionDate:
                        type: string
                        example: '2020-11-25'
                      lastModifiedDate:
                        type: string
                        example: '2022-02-10T07:28:26.832Z'
        '400':
          description: Bad Request Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getV2BusinessByBusinessId
      x-operation-id-source: derived
  /v2/business/{businessId}/connections:
    get:
      summary: Fetch details of business connections
      description: ''
      security:
      - basicAuth: []
      parameters:
      - $ref: '#/components/parameters/businessId'
      tags:
      - Business
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: success
                  data:
                    $ref: '#/components/schemas/BusinessConnection'
        '400':
          description: Bad Request Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getV2BusinessByBusinessIdConnections
      x-operation-id-source: derived
  /v2/business/{businessId}/connections/accounting/verify:
    get:
      summary: To check the status of the connection between a business and accounting…
      description: ''
      security:
      - basicAuth: []
      parameters:
      - $ref: '#/components/parameters/businessId'
      tags:
      - Business
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: The connection is in connected state.
                  data:
                    $ref: '#/components/schemas/BusinessAccountingConnection'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: getV2BusinessByBusinessIdConnectionsAccountingVerify
      x-operation-id-source: derived
  /v2/business/{businessId}/disconnect:
    post:
      summary: Disconnect a business
      description: ''
      security:
      - basicAuth: []
      parameters:
      - $ref: '#/components/parameters/businessId'
      tags:
      - Business
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Business disconnected successfully.
                  data:
                    type: object
                    example: null
        '400':
          description: Bad Request Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequestError'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: postV2BusinessByBusinessIdDisconnect
      x-operation-id-source: derived
  /v2/business/{businessId}/sync:
    post:
      summary: Syncing business data
      description: ''
      security:
      - basicAuth: []
      parameters:
      - $ref: '#/components/parameters/businessId'
      tags:
      - Business
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: We have initiated your request, we will update you shortly.
                  data:
                    type: object
                    properties:
                      requestId:
                        type: string
                        example: 61090ffb59eea15c1d634e07
                  metadata:
                    $ref: '#/components/schemas/BusinessSyncMetaData'
        '401':
          description: Unauthorized Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedError'
        '409':
          description: Conflict
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BusinessSyncRequestError'
        '500':
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      operationId: postV2BusinessByBusinessIdSync
      x-operation-id-source: derived
components:
  schemas:
    BusinessSyncMetaData:
      type: object
      properties:
        businessId:
          type: string
          example: 61383a7e462e85067ab34f9e
        instituteId:
          type: string
          example: 5fb657984670bc3baa71c6e7
    BusinessSyncRequestError:
      type: object
      properties:
        status:
          type: boolean
          example: false
        message:
          type: string
          example: The business is already in the process of syncing
        error:
          type: object
          properties:
            type:
              type: string
              example: BusinessSyncRequestError
            message:
              type: string
              example: The business is already in the process of syncing
            errorCode:
              type: number
              example: 1002
            serviceCode:
              type: number
              example: 1002
    BusinessConnection:
      type: array
      items:
        type: object
        properties:
          id:
            type: string
            example: 5ca73f5a-537b-4c5d-828f-1b002f784daa
          businessId:
            type: string
            example: 61383a7e462e85067ab34f9e
          status:
            type: string
            example: CONNECTED
          integrationType:
            type: string
            example: ACCOUNTING
    BusinessAccountingConnection:
      type: object
      properties:
        id:
          type: string
          example: 5ca73f5a-537b-4c5d-828f-1b002f784daa
        businessId:
          type: string
          example: 61383a7e462e85067ab34f9e
        status:
          type: string
          example: CONNECTED
        integrationType:
          type: string
          example: ACCOUNTING
        verifiedAt:
          type: string
          example: '2024-01-04T09:45:31.066Z'
        lastUpdatedAt:
          type: string
          example: '2024-01-03T02:44:51.036Z'
    CreateBusiness:
      type: object
      required:
      - businessName
      - email
      properties:
        businessName:
          type: string
        industryType:
          type: string
        subIndustryType:
          type: string
        redirectURL:
          type: string
        email:
          type: string
        isEmailEnabled:
          type: boolean
        webhookMetadata:
          type: object
          properties:
            key1:
              type: string
            key2:
              type: string
            key3:
              type: string
    Error:
      type: object
      properties:
        status:
          type: boolean
          example: false
        message:
          type: string
          example: Error
        error:
          type: object
          properties:
            type:
              type: string
              example: InternalServerError
            smTraceId:
              type: string
              example: 5fd77529a859933f504527e1
            message:
              type: string
              example: error message
            errorCode:
              type: number
              example: 1001
            serviceCode:
              type: number
              example: 1002
    BadRequestError:
      type: object
      properties:
        status:
          type: boolean
          example: false
        message:
          type: string
          example: Error
        error:
          type: object
          properties:
            type:
              type: string
              example: RequestValidationError
            message:
              type: string
              example: Invalid Request Parameters
            errorCode:
              type: number
              example: 1002
            serviceCode:
              type: number
              example: 1002
    UnauthorizedError:
      type: object
      properties:
        status:
          type: boolean
          example: false
        message:
          type: string
          example: Error
        error:
          type: object
          properties:
            type:
              type: string
              example: HttpException
            message:
              type: string
              example: Missing authorization details
            errorCode:
              type: number
              example: 1006
            serviceCode:
              type: number
              example: 1040
  parameters:
    businessSortBy:
      in: query
      name: sortBy
      schema:
        type: string
        enum:
        - lastVisited
        - lastConnected
      required: false
    sortOrder:
      in: query
      name: sortOrder
      schema:
        type: string
        enum:
        - asc
        - desc
      required: false
    businessId:
      in: path
      name: businessId
      schema:
        type: string
      required: true
    pageNumber:
      in: query
      name: pageNumber
      description: Any integer between 1 and 10000
      schema:
        type: number
      required: false
    pageSize:
      in: query
      name: pageSize
      description: Any integer between 1 and 1000
      schema:
        type: number
      required: false
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
x-provenance:
  method: searched
  source: https://docs.forwardai.com/reference
  harvested: '2026-10-20'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-accounts-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-accounts.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-attributes-ratios.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-billpayments-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-billpayments.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-bills-id-attachment-download.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-bills-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-bills.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-creditnotes-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-creditnotes.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-customeranalysis-id-dueoverduetrend.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-customeranalysis-id-insights.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-customers-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-customers.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-debitnotes-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-debitnotes.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-employees-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-employees.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-expenses-recurringexpenses.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-income-recurringincome.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-invoicepayments-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-invoicepayments.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-invoicepdf-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-invoices-id-attachment-download.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-invoices-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-invoices.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-items-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-items.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-journals-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-journals.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-kpi-ebitda.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-purchaseorders-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-purchaseorders.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-apaging.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-araging.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-balancesheet.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-cashflowstatement.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-generalledger-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-profitandloss.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-reports-trialbalance.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-shorttermcashflow-details.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-shorttermcashflow-summary.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-shorttermcashflow-topinflowheads.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-shorttermcashflow-topoutflowheads.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-taxrates-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-taxrates.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-vendors-id.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-accounting-vendors.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-connections-accounting-verify.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid-connections.md
  - https://docs.forwardai.com/reference/get_v2-business-businessid.md
  - https://docs.forwardai.com/reference/get_v2-business.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-accounts.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-billpayments.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-bills-id-attachment.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-bills.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-creditnotes.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-customers.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-debitnotes.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-invoicepayments.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-invoices-id-attachment.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-invoices.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-items.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-journals.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-purchaseorders.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-accounting-vendors.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-disconnect.md
  - https://docs.forwardai.com/reference/post_v2-business-businessid-sync.md
  - https://docs.forwardai.com/reference/post_v2-business.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-accounts.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-billpayments.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-bills.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-creditnotes.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-customers.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-debitnotes.md
  - https://docs.forwardai.com/reference/put_v2-business-businessid-accounting-invoicepayments.md


# --- truncated at 32 KB (32 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/forwardai/refs/heads/main/openapi/forwardai-business-api-openapi.yml