{"components":{"schemas":{"BadRequest":{"description":"Returned when something is wrong in the request, e.g. failed argument validation or missed argument","properties":{"attributes":{"description":"Invalid attributes","items":{"$ref":"#/components/schemas/RequestAttribute"},"type":"array"},"error":{"default":"BadRequest","description":"Error name","type":"string"},"message":{"default":"Required arguments are missing in the request","description":"Description of the request error","type":"string"}},"type":"object"},"BalanceSheetAssetItems":{"properties":{"bsCashAndCashEquivalents":{"description":"Cash and bank balances","format":"double","type":"number"},"bsTotalAssets":{"description":"Total assets","format":"double","type":"number"},"bsTotalCurrentAssets":{"description":"Total short term assets","format":"double","type":"number"},"bsTotalInventories":{"description":"Total Inventories","format":"double","type":"number"},"bsTotalNonCurrentAssets":{"description":"Total long term assets","format":"double","type":"number"}},"type":"object"},"BalanceSheetEquityLiabilityItems":{"properties":{"bsShareCapital":{"description":"Share capital","format":"double","type":"number"},"bsTotalCurrentLiabilities":{"description":"Total current liabilities","format":"double","type":"number"},"bsTotalEquity":{"description":"Total equity","format":"double","type":"number"},"bsTotalEquityAndLiabilities":{"description":"Total equity and liabilities","format":"double","type":"number"},"bsTotalLongTermLiabilities":{"description":"Total long term liabilities","format":"double","type":"number"}},"type":"object"},"CompanyFinancialInformationResults":{"description":"Roaring Group company Company financial information results","properties":{"records":{"description":"found Company financial information results","items":{"$ref":"#/components/schemas/FinancialInformation"},"type":"array"},"status":{"$ref":"#/components/schemas/SearchResultStatus"}},"type":"object"},"FinancialInformation":{"properties":{"amountMultiplicator":{"description":"1 means the amounts are in singular currency","format":"int32","type":"integer"},"audited":{"description":"Audited or not","type":"boolean"},"auditingCompany":{"description":"Name of auditing company","type":"string"},"auditorOpinion":{"description":"Opinion of the auditor","type":"string"},"balanceSheetAssetItems":{"allOf":[{"$ref":"#/components/schemas/BalanceSheetAssetItems"}],"description":"Balance sheet asset items.  Max 2 decimals"},"balanceSheetEquityLiabilityItems":{"allOf":[{"$ref":"#/components/schemas/BalanceSheetEquityLiabilityItems"}],"description":"Balance sheet liability items.  Max 2 decimals"},"changeDate":{"description":"Date for the latest change (Date in ISO 8601 standard)","type":"string"},"companyId":{"description":"National identifier for the company - NIF number","type":"string"},"currency":{"description":"Currency of the financial statement","type":"string"},"dividend":{"description":"Dividend","format":"double","type":"number"},"keyRatioItems":{"allOf":[{"$ref":"#/components/schemas/KeyRatioItems"}],"description":"Key ratios. Max 2 decimals"},"numberOfEmployees":{"description":"Number of employees","format":"int32","type":"integer"},"profitLossItems":{"allOf":[{"$ref":"#/components/schemas/ProfitLossItems"}],"description":"Profit and loss items. Max 2 decimals"},"yearOfBalanceSheet":{"description":"Year of balance sheet","type":"string"}},"type":"object"},"KeyRatioItems":{"properties":{"kpiEbitda":{"description":"Earnings before interest, tax and depreciation","format":"double","type":"number"},"kpiEbitdaMarginPercent":{"description":"Ebitda/net turnover, percent","format":"double","type":"number"},"kpiEquityRatioPercent":{"description":"Equity/total assets, percent","format":"double","type":"number"},"kpiQuickRatioPercent":{"description":"Quick ratio: Short term assets except inventories/ current liabilities, percent","format":"double","type":"number"},"kpiReturnOnCapitalEmployedPercent":{"description":"Return on capital employed : Earnings before interest expenses and tax/total assets, percent","format":"double","type":"number"},"kpiReturnOnEquityPercent":{"description":"Return on equity: Profit before tax/Equity, percent","format":"double","type":"number"}},"type":"object"},"ProfitLossItems":{"properties":{"plEbit":{"description":"Earnings before interest and tax","format":"double","type":"number"},"plNetProfitLoss":{"description":"Profit or loss for the year","format":"double","type":"number"},"plNetTurnover":{"description":"Net amount of turnover","format":"double","type":"number"},"plProfitLossAfterFinItems":{"description":"Profit or loss before tax","format":"double","type":"number"},"plSales":{"description":"Sales","format":"double","type":"number"}},"type":"object"},"RequestAttribute":{"description":"Incorrect attribute of request","properties":{"attribute":{"description":"Parameter name","type":"string"},"value":{"description":"Parameter value, subject for validation","type":"string"}},"type":"object"},"SearchResultStatus":{"description":"Description of search result","properties":{"code":{"description":"0 - found, 1 - not found","format":"int32","type":"integer"},"text":{"description":"search result description","type":"string"}},"type":"object"},"ServerError":{"description":"Internal server error","properties":{"error":{"default":"InternalServerError","description":"Error name","type":"string"},"message":{"default":"An internal server error occurred, please contact the system administrator with information on the error","description":"Description of the request error","type":"string"}},"type":"object"}},"securitySchemes":{"OAuth2":{"description":"All requests require authentication via OAuth2 client credentials.\n\nBase URL: https://api.roaring.io\n\n1. Obtain a Consumer key and Consumer secret from https://developer.roaring.io/keys\n   (separate sandbox and production pairs).\n2. Request an access token by POSTing to the token endpoint:\n\n   POST https://api.roaring.io/token\n   Content-Type: application/x-www-form-urlencoded\n   Authorization: Basic base64(consumer-key:consumer-secret)\n\n   body: grant_type=client_credentials\n\n   Tokens are valid for 3600 seconds. The response contains an access_token of\n   type Bearer.\n3. Send the access token on every API call:\n\n   Authorization: Bearer <access_token>","flows":{"clientCredentials":{"tokenUrl":"https://api.roaring.io/token","scopes":{}}},"type":"oauth2"}}},"info":{"description":"Company financial information\n\nAll requests require authentication via OAuth2 client credentials.\n\nBase URL: https://api.roaring.io\n\n1. Obtain a Consumer key and Consumer secret from https://developer.roaring.io/keys\n   (separate sandbox and production pairs).\n2. Request an access token by POSTing to the token endpoint:\n\n   POST https://api.roaring.io/token\n   Content-Type: application/x-www-form-urlencoded\n   Authorization: Basic base64(consumer-key:consumer-secret)\n\n   body: grant_type=client_credentials\n\n   Tokens are valid for 3600 seconds. The response contains an access_token of\n   type Bearer.\n3. Send the access token on every API call:\n\n   Authorization: Bearer <access_token>","title":"Company financial information","version":"1.0","x-logo":{"url":"https://assets.roaring.io/svg/economy-overview-icon-v3.1.svg"}},"openapi":"3.0.1","paths":{"/{companyId}":{"get":{"description":"AsOfDate supported","operationId":"view","parameters":[{"description":"id of company","in":"path","name":"companyId","required":true,"schema":{"type":"string"}},{"description":"number of latest years to include","in":"query","name":"years","schema":{"default":5,"format":"int32","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyFinancialInformationResults"}}},"description":"OK, successfull response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequest"}}},"description":"Returned when something is wrong in the request, e.g. failed argument validation or arguments are missing"},"404":{"description":"Requested resource could not be found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServerError"}}},"description":"An internal server error occurred, please contact the system administrator with information on the error"}},"summary":"Fetch company financial information","tags":["FinancialInformationEs"]}}},"security":[{"OAuth2":[]}],"servers":[{"url":"https://api.roaring.io/es/company/financial-information/1.0"}],"x-category":"company","x-countries":["es"],"x-id":"FinancialInformationApiEs"}