> ## Documentation Index
> Fetch the complete documentation index at: https://docs.inyett.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search for company using name or company id

> 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.



## OpenAPI

````yaml https://api-test.inyett.com/swagger/v3/swagger.json get /3/{profileCountry}/find/companies
openapi: 3.0.4
info:
  title: Inyett Automation
  description: |-
    <p>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.</p><h3>How to connect</h3>
                        <p>Read more about our API and how to connect on <a href='https://docs.inyett.com/home' target='_blank'>docs.inyett.com</a></p> 
  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}/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

````