Inyett Automation is a payment control and company screening API for Swedish and Norwegian businesses. It lets integrators automatically check a company's status and risk before doing business with it, monitor companies over time for changes, and screen outgoing payment batches for anomalies, sanctions and compliance issues before the money leaves the paying customer. It is used by ERP, payment and procurement systems that need this control built into their own workflows rather than as a manual step.
Read more about our API and how to connect on docs.inyett.com
contact: email: support@inyett.com version: '3.0' servers: [] security: - X-Api-Key: [] - Bearer: [] tags: - name: Inyett Company Control description: >- Risk assessment endpoints such as main rating, fraud, debt and payment remark checks, used to screen a company before paying it. - name: Inyett Company Data description: >- Company master data: addresses, accounts, owners, directors, financial statements and other registry information for a company. - name: Inyett Company Debts & Credits description: >- Aggregated debt and credit information for a company, including historical claims and payment remarks. - name: Inyett Company Find description: Free-text and organisation-number search for companies. - name: Inyett Company Insights description: >- The company relation graph: companies related to a given company, grouped by relation category (tag). - name: Inyett Company Monitor description: >- Continuous monitoring of company portfolios: create portfolios, add or remove companies to watch, and read back detected changes over time. - name: Inyett Payment Control description: >- Batch screening of outgoing payments: submit a payment batch for analysis and read back any warnings before the money leaves the customer. paths: /3/{profileCountry}/company-data/companies/{country}/{orgNr}/financial-key-results: get: tags: - Inyett Company Data summary: Financial key results for the company description: >- Returns key financial ratios and KPIs (e.g. solidity, profit margin, return on capital) per financial period, for the company itself. operationId: financialKeyResultsGet parameters: - name: profileCountry in: path description: >- The country whose scope/entitlement profile (SE or NO) is used to authorize the request. Determines which market-specific rules apply, independent of the country the requested company is registered in. required: true schema: $ref: '#/components/schemas/Country' - name: country in: path description: The country the requested company is registered in. required: true schema: $ref: '#/components/schemas/Country' - name: orgNr in: path description: >- The company's organisation number (personal identity number for a sole proprietorship), without separators. required: true schema: type: string - name: AppId in: header description: App id schema: type: string responses: '200': description: OK content: application/json: schema: type: array items: $ref: '#/components/schemas/FinancialKeyResult' example: - fromDate: '2023-01-01T00:00:00' toDate: '2023-12-31T00:00:00' grossProfitMargin: 93.9 profitMargin: 27.8 riskBuffer: 23.7 returnOnCapital: 37.8 rateOfReturnTimes: 695.9 returnOnWorkingCapital: 33.8 returnOnTotalCapital: 23.7 quickRatio: 294.4 workingCapital: 38577 solidity: 62.7 debtEquityRatio: 0.1 degreeOfDebt: 0.5 inventoryTurnover: 0 capitalTurnover: 0 turnoverPerEmployee: 1577 '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/FailResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/FailResponse' components: schemas: Country: enum: - SE - 'NO' type: string description: >- ISO country code supported for company lookups: SE (Sweden) or NO (Norway). FinancialKeyResult: type: object properties: fromDate: type: string format: date-time nullable: true toDate: type: string format: date-time grossProfitMargin: type: number format: double nullable: true profitMargin: type: number format: double nullable: true riskBuffer: type: number format: double nullable: true returnOnCapital: type: number format: double nullable: true returnOnTotCapital: type: number format: double nullable: true rateOfReturnTimes: type: number format: double nullable: true returnOnWorkingCapital: type: number format: double nullable: true returnOnTotalCapital: type: number format: double nullable: true quickRatio: type: number format: double nullable: true workingCapital: type: number format: double nullable: true solidity: type: number format: double nullable: true debtEquityRatio: type: number format: double nullable: true degreeOfDebt: type: number format: double nullable: true inventoryTurnover: type: number format: double nullable: true capitalTurnover: type: number format: double nullable: true turnoverPerEmployee: type: number format: double nullable: true additionalProperties: false description: >- Key financial ratios and KPIs (e.g. solidity, profit margin, return on capital) for a financial period. ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} description: >- A machine-readable error response following the RFC 7807 Problem Details format. FailResponse: type: object properties: message: type: string nullable: true additionalProperties: false description: >- Error response returned when a request fails, containing a human-readable message. securitySchemes: X-Api-Key: type: apiKey description: 'Api key needed to access the endpoints. X-Api-Key: My api key' name: X-Api-Key in: header Bearer: type: http description: Please enter a valid token scheme: Bearer bearerFormat: JWT ````