v1

latestOpenAPI 3.0.32026-08-06150495.9 KB
Financial Reconciliation API

Financial Deduction Breakdown

This endpoint retrieves the financial overview for a specific client.

Request

  • Method: GET

  • Base URL: {{base-url}}

  • Path: /finance-manager/financial/overview

  • Query Parameters:

    • clientId (string, required): The unique identifier of the client for whom the financial overview is being requested.

Request Body

  • Type: Raw (JSON)

  • Description: The request body includes the following parameters:

    • startDate (string): The start date for the overview.

    • endDate (string): The end date for the overview.

    • listingIds (array): An array of listing IDs.

    • channel (array): An array of channels.

    • payoutDates (array): An array of payout dates.

Response

  • Status: 200

  • Content-Type: application/json

  • Description: The response will be a JSON object with the following schema:

{
  "status": boolean,
  "statusCode": number,
  "message": string,
  "result": {
    "dashboard": string,
    "startDate": string,
    "endDate": string,
    "previousStartDate": string,
    "previousEndDate": string,
    "overview": {
      "payout": {
        "totalRevenue": number,
        "deductions": {
          "total": number,
          "commission": number,
          "merchantFee": number,
          "promoValue": {
            "promoValue": number,
            "ezReward": number,
            "preferredPartnerProgram": number
          },
          "paymentTransactionFee": number,
          "deliveryFee": {
            "deliveryFee": number,
            "deliveryCommission": number
          },
          "marketing": {
            "marketingAdjustments": number
          },
          "miscellaneous": {
            "tips": number,
            "taxWithHeld": number,
            "commissionTax": number,
            "otherPayments": number
          }
        },
        "tax": {
          "taxToBePaid": number
        },
        "estimatedPayout": number,
        "differenceBifurcation": {
          "total": number,
          "errorCharges": {
            "total": number,
            "itemValue": number,
            "itemTax": number
          },
          "adjustments": {
            "total": number,
            "itemValue": number,
            "itemTax": number
          }
        },
        "netPayout": {
          "total": number,
          "refundByVoosh": number
        },
        "payoutDiff": {
          "total": number,
          "itemValue": number,
          "itemTax": number
        }
      },
      "tax": {
        "taxRemittedToState": number,
        "taxRemittedToMerchant": number
      }
    },
    "graph": [
      {
        "key": string,
        "range": [number],
        "value": number,
        "type": string,
        "bifurcation": {}
      }
    ]
  },
  "error": string
}

get/finance-manager/financial/overview

Query parameters

clientIdstring
Example:604517c0-fae8-41b7-8c20-0fe4778e415c

(required) – The common ID between Voosh and the partner, used to identify the client.

Headers

access-tokenstring
Example:{{access-token}}

(required) – The unique token ID provided to the partner for authentication and secure data access.

Request body

channelstring[]
endDatestring
listingIdsstring[]
startDatestring

Example request

{
  "channel": [
    "DOORDASH",
    "UBEREATS",
    "GRUBHUB",
    "EZCATER"
  ],
  "endDate": "2025-03-25",
  "listingIds": [
    "P5441",
    "P5461",
    "P5471",
    "P5481",
    "P5491",
    "P5501",
    "P5511",
    "P5531",
    "P5541",
    "P5551",
    "P5561",
    "P5571",
    "P5581",
    "P8191"
  ],
  "payoutDates": [],
  "startDate": "2025-02-23"
}

Response

200