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

# Supplier Onboarding and KYC

> Before a new business relationship, you need to verify that the company it's real and healthy, know who ultimately owns and controls it.

* **Trigger –** New Supplier Request
* **Cadence –** Per supplier, On-off
* **Mode –** Synchronus
* **Product –** Inyett Company Find / Inyett Company Data / Inyett Company Control

# Process

```mermaid theme={null}
flowchart LR
    Request["Supplier request<br/>name or org number"] --> Known{"Org number<br/>known?"}

    Known -->|Yes| Data["Company Data<br/>info · UBO · directors · sign"]
    Known -->|No| Find["Company Find<br/>search and resolve"]
    Find --> Data

    Data --> Accounts["Company Data<br/>registered accounts"]
    Accounts --> Match{"Bank details<br/>match registry?"}

    Match -->|No| Hold["Hold for manual<br/>verification"]
    Match -->|Yes| Control["Company Control<br/>main-rating"]

    Control --> Rating{"Rating"}
    Rating -->|Green| Approve["Approve and write<br/>to vendor master"]
    Rating -->|Yellow| Review["Manual review"]
    Rating -->|Red| Decline["Decline"]

    Approve --> Portfolio["Add to Company Monitor<br/>portfolio - see W5"]
```

# Step by step

1. Resolve the company registration number from a name or address<br />`GET /3/{pc}/companies?query=acme`
2. Pull the registry record and legal status<br />`GET /3/{pc}/company-data/companies/{country}/{orgNr}/info`
3. Identify ultimate beneficial owners for AML<br />`GET .../beneficial-owner`
4. Fetch directors and who may sign for the company<br />`GET .../directors · GET .../sign`
5. Confirm the bank account they gave you is registered to them<br />`GET .../accounts`
6. Score the company before approving<br />`GET /3/{pc}/control/companies/{country}/{orgNr}/main-rating`
7. Write the verified record back to your vendor master

<Note>
  Everything here is synchronous and independent — issue the Company Data calls in parallel and assemble client-side. A full onboarding pack is typically five concurrent requests.
</Note>