--- updatedAt: 2026-06-03T16:27:31.000Z agentTools: projectIndex: https://developer.markaaz.com/llms.txt --- # Financials Data Financials Data # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Markaaz API Services 2.0", "description": "Markaaz API Services 2.0", "termsOfService": "https://markaaz.com/terms-and-conditions/", "contact": { "email": "support@markaaz.com" }, "license": { "name": "Copyright ©2023 Markaaz Inc. All rights reserved." }, "version": "v2.0" }, "security": [ { "Partner_API_Key": [] } ], "paths": { "/v2.0/business/financials": { "post": { "operationId": "v2.0_business_financials_create", "summary": "Financials Data", "description": "Financials Data", "parameters": [ { "name": "x-partner-id", "in": "header", "description": "Partner Id", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CSFinancialsRequest" } } }, "required": true }, "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FinancialsDataResponseMarkaazRoot" } } } }, "207": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MultiStatusWithMarkaazIdResponse" } } } }, "400": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestResponse" } } } }, "403": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnAuthorizedBizResponse" } } } }, "404": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceNotFoundResponse" } } } }, "429": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TooManyRequestsResponse" } } } }, "500": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServerErrorBizResponse" } } } }, "504": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatewayTimeoutResponse" } } } } }, "tags": [ "Markaaz Business Verification" ] }, "parameters": [] } }, "servers": [ { "url": "https://api-partner-sandbox.app.markaaz.com" }, { "url": "http://api-partner-sandbox.app.markaaz.com" } ], "components": { "securitySchemes": { "Partner_API_Key": { "type": "apiKey", "description": "Partner API Key", "name": "x-api-key", "in": "header" } }, "schemas": { "BadRequestResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "integer" }, "errors": { "title": "errors", "description": "errors", "type": "object" } } } }, "title": "Bad Request Response", "description": "Bad Request Response Data" }, "UnAuthorizedBizResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "integer" } } } }, "title": "UnAuthorized Response", "description": "UnAuthorized Response Data" }, "ResourceNotFoundResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" } } } }, "title": "Resource Not Found", "description": "Resource Not Found or bad URL" }, "TooManyRequestsResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" } } } }, "title": "Too Many Requests", "description": "Too many requests. Please try again later." }, "ServerErrorBizResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" }, "errors": { "title": "errors", "description": "Errors", "type": "string" } } } }, "title": "Server Error Response", "description": "Server Error Response Data" }, "GatewayTimeoutResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "integer" } } } }, "title": "Gateway Timeout Error Response", "description": "Gateway Timeout Error Response Data" }, "CSFinancialsRequest": { "required": [ "markaazId" ], "type": "object", "properties": { "markaazId": { "title": "markaazId", "description": "Markaaz Id", "type": "string", "maxLength": 16 }, "convertCurrency": { "title": "convertCurrency", "description": "Convert currency", "type": "string" }, "epInternalId": { "title": "epInternalId", "description": "A unique business identifier in the partners backend system. This can be provided for easier traceability between a partner system and a Markaaz ID.", "type": "string", "maxLength": 250 } } }, "FinancialsDataResponseMarkaazRoot": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "markaazId": { "title": "markaazId", "description": "Markaaz Id", "type": "string", "maxLength": 16 }, "epInternalId": { "title": "epInternalId", "description": "A unique business identifier in the partners backend system. This can be provided for easier traceability between a partner system and a Markaaz ID. Matching does not store the epInternalId.", "type": "string", "maxLength": 250 }, "bizInfo": { "title": "bizInfo", "description": "Business information data", "type": "object", "properties": { "dba": { "title": "DBA", "description": "Doing Business As", "type": "string", "maxLength": 1000 }, "legalName": { "title": "legalName", "description": "Business Legal Name", "type": "string", "maxLength": 1000 }, "taxId": { "title": "taxId", "description": "Business Tax Id", "type": "string", "maxLength": 100 }, "nationalId": { "title": "nationalId", "description": "National Id", "type": "string", "maxLength": 500 }, "addresses": { "title": "addresses", "description": "Addresses", "type": "array", "items": { "title": "AddressesItem", "description": "Addresses", "type": "object", "properties": { "type": { "title": "type", "description": "Indicates the type of address such as Primary, Registered or Secondary.", "type": "string" }, "line1": { "title": "line1", "description": "The first line of the address.", "type": "string" }, "line2": { "title": "line2", "description": "The second line of the address", "type": "string" }, "locality": { "title": "locality", "description": "The locality or city in which the business is based in.", "type": "string" }, "region": { "title": "region", "description": "The region or state in which the business is based in.", "type": "string" }, "postalCode": { "title": "postalCode", "description": "The postal code of the area in which the business is based in.", "type": "string" }, "country": { "title": "country", "description": "The country where the business is based in.", "type": "string" }, "latitude": { "title": "latitude", "description": "The latitude of the location of the business.", "type": "string" }, "longitude": { "title": "longitude", "description": "The longitude of the location of the business.", "type": "string" }, "geoprecision": { "title": "geoprecision", "description": "The geoprecision field.", "type": "string" }, "businessIndicator": { "title": "businessIndicator", "description": "The businessIndicator field.", "type": "string" }, "residentialIndicator": { "title": "residentialIndicator", "description": "The residentialIndicator field.", "type": "string" }, "sohoIndicator": { "title": "sohoIndicator", "description": "The small office home office inidcator.", "type": "string" } } } } } }, "financialStatements": { "title": "financialStatements", "description": "Financials details", "type": "array", "items": { "title": "financialStatement", "description": "Financials details", "type": "object", "properties": { "yearEndDate": { "title": "yearEndDate", "description": "Year End Date", "type": "string" }, "conversionDate": { "title": "conversionDate", "description": "Conversion Date", "type": "string" }, "conversionRate": { "title": "conversionRate", "description": "Conversion Rate", "type": "number" }, "numberOfWeeks": { "title": "numberOfWeeks", "description": "Number of Weeks", "type": "integer" }, "currency": { "title": "currency", "description": "Currency", "type": "string" }, "consolidatedAccounts": { "title": "consolidatedAccounts", "description": "Consolidated Accounts", "type": "boolean" }, "profitAndLoss": { "title": "profitAndLoss", "description": "profitAndLoss", "type": "object", "properties": { "revenue": { "title": "revenue", "description": "Revenue", "type": "number" }, "operatingCosts": { "title": "operatingCosts", "description": "Operating costs", "type": "number" }, "operatingProfit": { "title": "operatingProfit", "description": "Operating profit", "type": "number" }, "wagesAndSalaries": { "title": "wagesAndSalaries", "description": "Wages and salaries", "type": "number" }, "pensionCosts": { "title": "pensionCosts", "description": "Pension costs", "type": "number" }, "depreciation": { "title": "depreciation", "description": "Depreciation", "type": "number" }, "amortisation": { "title": "amortisation", "description": "Amortisation", "type": "number" }, "financialIncome": { "title": "financialIncome", "description": "Financial income", "type": "number" }, "financialExpenses": { "title": "financialExpenses", "description": "Financial expenses", "type": "number" }, "extraordinaryIncome": { "title": "extraordinaryIncome", "description": "Extraordinary income", "type": "number" }, "extraordinaryCosts": { "title": "extraordinaryCosts", "description": "Extraordinary costs", "type": "number" }, "profitBeforeTax": { "title": "profitBeforeTax", "description": "Profit before tax", "type": "number" }, "tax": { "title": "tax", "description": "tax", "type": "number" }, "profitAfterTax": { "title": "profitAfterTax", "description": "Profit after tax", "type": "number" }, "dividends": { "title": "dividends", "description": "Dividends", "type": "number" }, "minorityInterests": { "title": "minorityInterests", "description": "Minority Interests", "type": "number" }, "otherAppropriations": { "title": "otherAppropriations", "description": "Other Appropriations", "type": "number" }, "retainedProfit": { "title": "retainedProfit", "description": "Retained Profit", "type": "number" } } }, "balanceSheet": { "title": "balanceSheet", "description": "balanceSheet", "type": "object", "properties": { "landAndBuildings": { "title": "landAndBuildings", "description": "Land and buildings", "type": "number" }, "plantAndMachinery": { "title": "plantAndMachinery", "description": "Plant and machinery", "type": "number" }, "otherTangibleAssets": { "title": "otherTangibleAssets", "description": "Other tangible assets", "type": "number" }, "totalTangibleAssets": { "title": "totalTangibleAssets", "description": "Total tangible assets", "type": "number" }, "goodwill": { "title": "goodwill", "description": "Goodwill", "type": "number" }, "otherIntangibleAssets": { "title": "otherIntangibleAssets", "description": "Other intangible assets", "type": "number" }, "totalIntangibleAssets": { "title": "totalIntangibleAssets", "description": "Total intangible assets", "type": "number" }, "investments": { "title": "investments", "description": "Investments", "type": "number" }, "loansToGroup": { "title": "loansToGroup", "description": "Loans to group", "type": "number" }, "otherLoans": { "title": "otherLoans", "description": "Other loans", "type": "number" }, "miscellaneousFixedAssets": { "title": "miscellaneousFixedAssets", "description": "Miscellaneous fixed assets", "type": "number" }, "totalOtherFixedAssets": { "title": "totalOtherFixedAssets", "description": "Total other fixed assets", "type": "number" }, "totalFixedAssets": { "title": "totalFixedAssets", "description": "Total fixed assets", "type": "number" }, "rawMaterials": { "title": "rawMaterials", "description": "Raw materials", "type": "number" }, "workInProgress": { "title": "workInProgress", "description": "Work in progress", "type": "number" }, "finishedGoods": { "title": "finishedGoods", "description": "Finished goods", "type": "number" }, "otherInventories": { "title": "otherInventories", "description": "Other inventories", "type": "number" }, "totalInventories": { "title": "totalInventories", "description": "Total inventories", "type": "number" }, "tradeReceivables": { "title": "tradeReceivables", "description": "Trade receivables", "type": "number" }, "groupReceivables": { "title": "groupReceivables", "description": "Group receivables", "type": "number" }, "receivablesDueAfter1Year": { "title": "receivablesDueAfter1Year", "description": "Receivables due after one year", "type": "number" }, "miscellaneousReceivables": { "title": "miscellaneousReceivables", "description": "Miscellaneous receivables", "type": "number" }, "totalReceivables": { "title": "totalReceivables", "description": "Total receivables", "type": "number" }, "cash": { "title": "cash", "description": "Cash", "type": "number" }, "otherCurrentAssets": { "title": "otherCurrentAssets", "description": "Other current assets", "type": "number" }, "totalCurrentAssets": { "title": "totalCurrentAssets", "description": "Total current assets", "type": "number" }, "totalAssets": { "title": "totalAssets", "description": "Total assets", "type": "number" }, "tradePayables": { "title": "tradePayables", "description": "Trade payables", "type": "number" }, "bankLiabilities": { "title": "bankLiabilities", "description": "Bank liabilities", "type": "number" }, "otherLoansOrFinance": { "title": "otherLoansOrFinance", "description": "Other loans or finance", "type": "number" }, "groupPayables": { "title": "groupPayables", "description": "Group payables", "type": "number" }, "miscellaneousLiabilities": { "title": "miscellaneousLiabilities", "description": "Miscellaneous liabilities", "type": "number" }, "totalCurrentLiabilities": { "title": "totalCurrentLiabilities", "description": "Total current liabilities", "type": "number" }, "tradePayablesDueAfter1Year": { "title": "tradePayablesDueAfter1Year", "description": "Trade payables due after one year", "type": "number" }, "bankLiabilitiesDueAfter1Year": { "title": "bankLiabilitiesDueAfter1Year", "description": "Bank liabilities due after one year", "type": "number" }, "otherLoansOrFinanceDueAfter1Year": { "title": "otherLoansOrFinanceDueAfter1Year", "description": "Other loans or finance due after one year", "type": "number" }, "groupPayablesDueAfter1Year": { "title": "groupPayablesDueAfter1Year", "description": "Group payables due after one year", "type": "number" }, "miscellaneousLiabilitiesDueAfter1Year": { "title": "miscellaneousLiabilitiesDueAfter1Year", "description": "Miscellaneous liabilities due after one year", "type": "number" }, "totalLongTermLiabilities": { "title": "totalLongTermLiabilities", "description": "Total long term liabilities", "type": "number" }, "totalLiabilities": { "title": "totalLiabilities", "description": "Total liabilities", "type": "number" }, "calledUpShareCapital": { "title": "calledUpShareCapital", "description": "Called up share capital", "type": "number" }, "sharePremium": { "title": "sharePremium", "description": "Share premium", "type": "number" }, "revenueReserves": { "title": "revenueReserves", "description": "Revenue reserves", "type": "number" }, "otherReserves": { "title": "otherReserves", "description": "Other reserves", "type": "number" }, "totalShareholdersEquity": { "title": "totalShareholdersEquity", "description": "Total shareholders equity", "type": "number" } } }, "otherFinancials": { "title": "otherFinancials", "description": "otherFinancials", "type": "object", "properties": { "contingentLiabilities": { "title": "contingentLiabilities", "description": "Contingent liabilities", "type": "string" }, "workingCapital": { "title": "workingCapital", "description": "Working capital", "type": "number" }, "netWorth": { "title": "netWorth", "description": "Net worth", "type": "number" } } }, "ratios": { "title": "ratios", "description": "ratios", "type": "object", "properties": { "preTaxProfitMargin": { "title": "preTaxProfitMargin", "description": "preTaxProfitMargin", "type": "number" }, "returnOnCapitalEmployed": { "title": "returnOnCapitalEmployed", "description": "returnOnCapitalEmployed", "type": "number" }, "returnOnTotalAssetsEmployed": { "title": "returnOnTotalAssetsEmployed", "description": "returnOnTotalAssetsEmployed", "type": "number" }, "returnOnNetAssetsEmployed": { "title": "returnOnNetAssetsEmployed", "description": "returnOnNetAssetsEmployed", "type": "number" }, "salesOrNetWorkingCapital": { "title": "salesOrNetWorkingCapital", "description": "salesOrNetWorkingCapital", "type": "integer" }, "stockTurnoverRatio": { "title": "stockTurnoverRatio", "description": "stockTurnoverRatio", "type": "number" }, "debtorDays": { "title": "debtorDays", "description": "debtorDays", "type": "number" }, "creditorDays": { "title": "creditorDays", "description": "creditorDays", "type": "number" }, "currentRatio": { "title": "currentRatio", "description": "currentRatio", "type": "number" }, "liquidityRatioOrAcidTest": { "title": "liquidityRatioOrAcidTest", "description": "liquidityRatioOrAcidTest", "type": "number" }, "currentDebtRatio": { "title": "currentDebtRatio", "description": "currentDebtRatio", "type": "number" }, "gearing": { "title": "gearing", "description": "gearing", "type": "number" }, "equityInPercentage": { "title": "equityInPercentage", "description": "equityInPercentage", "type": "number" }, "totalDebtRatio": { "title": "totalDebtRatio", "description": "totalDebtRatio", "type": "number" } } } } } } } } }, "title": "markaaz", "description": "Markaaz root" }, "MultiStatusWithMarkaazIdResponse": { "required": [ "markaaz" ], "type": "object", "properties": { "markaaz": { "title": "markaaz", "description": "Markaaz Root", "type": "object", "properties": { "traceId": { "title": "traceId", "description": "Trace ID (UUID)", "type": "string" }, "markaazId": { "title": "markaazId", "description": "Markaaz ID", "type": "string" }, "message": { "title": "message", "description": "Message", "type": "string" }, "messageId": { "title": "messageId", "description": "Message Id", "type": "number" } } } }, "title": "No Content Response", "description": "No Content Response Data" } } } } ```