Read more about our API and how to connect on docs.inyett.com
contact: email: support@inyett.com version: '2.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 Find description: Free-text and organisation-number search for companies. - 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: /2/{profileCountry}/find/companies: get: tags: - Inyett Company Find summary: Search for company using name or company id description: >- Free-text search for a company by name, or an exact lookup by organisation number/company id. Returns a paginated list of matches ordered by relevance. operationId: findGet 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: query description: Country se or no required: true schema: type: string - name: query in: query description: Search for name or organisation number/company id required: true schema: type: string - name: page in: query description: Page schema: type: integer format: int32 - name: pageSize in: query description: Page size of the result schema: type: integer format: int32 - name: AppId in: header description: App id schema: type: string responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Generic_PageResult_1_Company' example: data: - orgNumber: '5522334455' name: Foo AB statusDescription: Aktivt statusCode: '100' statusName: Aktivt legalGroup: AB legalGroupText: Privat aktiebolag town: HELSINGBORG address: Redaregatan 50 coAddress: '' zipCode: '25236' email: '' webAddress: '' registrationDate: '2009-04-06T00:00:00' taxRegistered: true findScore: 100 - orgNumber: '5566778899' name: Bar AB statusDescription: Aktivt statusCode: '100' statusName: Aktivt legalGroup: AB legalGroupText: Privat aktiebolag town: HELSINGBORG address: Redaregatan 51 coAddress: '' zipCode: '25236' email: '' webAddress: '' registrationDate: '2009-04-06T00:00:00' taxRegistered: true findScore: 76.660706 total: 2 '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). Generic_PageResult_1_Company: type: object properties: data: type: array items: $ref: '#/components/schemas/Find.Company' nullable: true total: type: integer format: int64 additionalProperties: false description: >- A page of company search results, together with the total number of matches. 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. Find.Company: type: object properties: orgNumber: type: string nullable: true name: type: string nullable: true statusDescription: type: string nullable: true statusCode: type: string nullable: true statusName: type: string nullable: true legalGroup: type: string nullable: true legalGroupText: type: string nullable: true town: type: string nullable: true address: type: string nullable: true coAddress: type: string nullable: true zipCode: type: string nullable: true phoneNumber: type: string nullable: true faxNumber: type: string nullable: true email: type: string nullable: true webAddress: type: string nullable: true registrationDate: type: string format: date-time nullable: true taxRegistered: type: boolean nullable: true findScore: type: number format: double nullable: true safeNo: type: string nullable: true additionalProperties: false description: >- A company search result, including registration status, contact details and a relevance score. 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 ````