# References codes & lists

Some fields and parameters in the Apentis API use **standardized codes or enumerations** rather than free text. This page documents those code spaces so integrators can **validate inputs (requests)** and **render labels (responses)** consistently.

### How to use this page

* **Codes are stable identifiers.** Treat `id`/`code` as the source of truth; labels may evolve.
* **Case sensitivity:** Some spaces are **UPPERCASE** (e.g., `EQ`, `FI`), others are human-readable labels (e.g., document type names). Each section below states the rule.
* **Validation:** Unless noted otherwise, unknown codes should be rejected with **HTTP 400**.

### Where codes/enums appear (at a glance)

#### Business relations

<table><thead><tr><th width="292">Field / Param</th><th>In</th><th>Allowed values</th></tr></thead><tbody><tr><td><code>type</code></td><td>Business relations</td><td>See <a href="#business-relation-types-type">Business relation types</a></td></tr><tr><td><code>nationality</code></td><td>Business relations</td><td>ISO 3166-1 (alpha-2), e.g., <code>CH</code>, <code>LU</code>, <code>PL</code></td></tr><tr><td><code>fiscalCountry</code>, <code>countryOfResidence</code>, <code>bankAccountCountry</code>, <code>countryOfOperation</code></td><td>Business relations</td><td>ISO 3166-1 (alpha-2), e.g., <code>CH</code>, <code>LU</code>, <code>PL</code></td></tr><tr><td><code>language</code></td><td>Business relations</td><td>See <a href="#languages-language">Languages</a></td></tr><tr><td><code>relationshipStatus</code></td><td>Business relations</td><td>See <a href="#relationship-statuses-relationshipstatus">Relationship statuses</a></td></tr><tr><td><code>relationStatus</code></td><td>Business relations</td><td>See <a href="#relation-statuses-relationstatus">Relation statuses</a></td></tr><tr><td><code>service</code></td><td>Business relations</td><td>See <a href="#services-service">Services</a></td></tr><tr><td><code>maritalStatus</code></td><td>Business relations</td><td>See <a href="#marital-statuses-maritalstatus">Marital statuses</a></td></tr><tr><td><code>wealthSource</code></td><td>Business relations</td><td>See <a href="#wealth-sources-wealthsource">Wealth sources</a></td></tr><tr><td><code>originOfBusinessRelation</code></td><td>Business relations</td><td>See <a href="#origin-of-business-relation-originofbusinessrelation">Origin of business relation</a></td></tr><tr><td><code>crsStatus</code></td><td>Business relations</td><td>See <a href="#crs-statuses-crsstatus">CRS statuses</a></td></tr><tr><td><code>industrySector</code></td><td>Business relations</td><td>See <a href="#industry-sectors-industrysector">Industry sectors</a></td></tr><tr><td><code>complexityOfBoStructure</code></td><td>Business relations</td><td>See <a href="#complexity-of-bo-structure-complexityofbostructure">Complexity of BO structure</a></td></tr><tr><td><code>legalForm</code></td><td>Business relations</td><td>See <a href="#legal-forms-legalform">Legal forms</a></td></tr></tbody></table>

#### Business relations links

<table><thead><tr><th width="292">Field / Param</th><th>In</th><th>Allowed values</th></tr></thead><tbody><tr><td><code>role</code></td><td>Business relations links</td><td>See <a href="#roles-role">Roles</a></td></tr></tbody></table>

#### KYC documents

<table><thead><tr><th width="292">Field / Param</th><th>In</th><th>Allowed values</th></tr></thead><tbody><tr><td><code>documentType</code> </td><td>KYC documents</td><td>See <a href="#document-types">Document types</a></td></tr><tr><td><code>documentIssuer</code></td><td>KYC documents</td><td>ISO 3166-1 (alpha-2), e.g., <code>CH</code>, <code>LU</code>, <code>PL</code></td></tr></tbody></table>

#### AML/KYC results

<table><thead><tr><th width="292">Field / Param</th><th>In</th><th>Allowed values</th></tr></thead><tbody><tr><td><code>amlRiskRating</code></td><td>AML/KYC results</td><td>See <a href="#aml-risk-ratings-amlriskrating">AML risk ratings</a></td></tr><tr><td><code>dueDiligenceType</code></td><td>AML/KYC results</td><td>See <a href="#due-diligence-types-duediligencetype">Due diligence types</a></td></tr><tr><td><code>relationAcceptanceStatus</code></td><td>AML/KYC results</td><td>See <a href="#relation-acceptance-statuses-relationacceptancestatus">Relation acceptance statuses</a></td></tr><tr><td><code>accountStatus</code></td><td>AML/KYC results</td><td>See <a href="#account-statuses-accountstatus">Account statuses</a></td></tr><tr><td><code>blockingReason</code></td><td>AML/KYC results</td><td>See <a href="#blocking-reasons-blockingreason">Blocking reasons</a></td></tr><tr><td><code>kycStatus</code></td><td>AML/KYC results</td><td>See <a href="#kyc-statuses-kycstatus">KYC statuses</a></td></tr></tbody></table>

#### Cashflow monitoring

<table><thead><tr><th width="292">Field / Param</th><th>In</th><th>Allowed values</th></tr></thead><tbody><tr><td><code>currency</code></td><td>Cashflow monitoring</td><td>ISO 4217 currency code (e.g., <code>EUR</code>, <code>USD</code>)</td></tr><tr><td><code>transactionType</code></td><td>Cashflow monitoring</td><td>See <a href="#transaction-types-transactiontype">Transaction types</a></td></tr><tr><td><code>transactionDirection</code></td><td>Cashflow monitoring</td><td>See <a href="#transaction-directions-transactiondirection">Transaction directio</a>ns</td></tr><tr><td><code>originCountry</code>, <code>destinationCountry</code></td><td>Cashflow monitoring</td><td>ISO 3166-1 (alpha-2), e.g., <code>CH</code>, <code>LU</code>, <code>PL</code></td></tr><tr><td><code>analysisResultStatus</code></td><td>Cashflow monitoring</td><td>See <a href="#analysis-result-statuses-analysisresultstatus">Analysis result statuses</a></td></tr><tr><td><code>riskLevel</code></td><td>Cashflow monitoring</td><td>See <a href="#risk-levels-risklevel">Risk levels</a></td></tr><tr><td><code>complianceReviewStatus</code></td><td>Cashflow monitoring</td><td>See <a href="#compliance-review-statuses-compliancereviewstatus">Compliance review statuses</a></td></tr></tbody></table>

#### Portfolio data

<table><thead><tr><th width="292">Field / Param</th><th>In</th><th>Allowed values</th></tr></thead><tbody><tr><td><code>security_asset_class_id</code></td><td>Portfolio data</td><td>See <a href="#security-asset-class-codes-security_asset_class_id">Security asset class codes</a></td></tr><tr><td><code>security_sector_id</code></td><td>Portfolio data</td><td>See <a href="#security-sector-codes-security_sector_id">Security sector codes</a></td></tr><tr><td><code>security_industry_id</code></td><td>Portfolio data</td><td>See <a href="#security-industry-codes-security_industry_id">Security industry codes</a></td></tr><tr><td><code>security_country_id</code></td><td>Portfolio data</td><td>ISO 3166-1 (alpha-2), e.g., <code>CH</code>, <code>LU</code>, <code>PL</code></td></tr><tr><td><code>security_currency_id</code>, <code>portfolio_currency_id</code></td><td>Portfolio data</td><td>ISO 4217, e.g., <code>EUR</code>, <code>USD</code>, <code>CHF</code></td></tr><tr><td><code>custodian_id</code></td><td>Portfolio data</td><td>e.g., <code>BIL LU</code>, <code>EFG MC</code></td></tr></tbody></table>

### Business relation types (`type`)

**Used in:** Business relations\
**Rule:** Must be one of the codes below.

| id                 | label              |
| ------------------ | ------------------ |
| Association        | Association        |
| Company            | Company            |
| Family             | Family             |
| Foundation         | Foundation         |
| Fund               | Fund               |
| Holding or SPV     | Holding or SPV     |
| Household          | Household          |
| Insurance company  | Insurance company  |
| Insurance contract | Insurance contract |
| Joint ownership    | Joint ownership    |
| Mandate            | Mandate            |
| Partnership        | Partnership        |
| Pension scheme     | Pension scheme     |
| Person             | Person             |
| Trust              | Trust              |

### Languages (`language`)

**Case:** UPPERCASE code\
**Used in:** Business relations\
**Rule:** Must be one of the codes below.

| id | label   |
| -- | ------- |
| EN | English |
| FR | French  |
| DE | German  |
| IT | Italian |
| ES | Spanish |
| NL | Dutch   |

### Relationship statuses (`relationshipStatus`)

**Used in:** Business relations\
**Rule:** Must be one of the codes below.

| id         | label      |
| ---------- | ---------- |
| Client     | Client     |
| Contact    | Contact    |
| Investment | Investment |
| Mandate    | Mandate    |
| Prospect   | Prospect   |

### Relation statuses (`relationStatus`)

**Case**: Lowercase code\
**Used in**: Business relations\
**Rule**: Must be one of the codes below.

| id         | label      |
| ---------- | ---------- |
| active     | Active     |
| terminated | Terminated |

### Services (`service`)

**Used in:** Business relations\
**Rule:** Apentis standard values are listed below. However, each client can configure its own list of acceptable values. Use the endpoint [`/business-relations/schema-config`](https://apentis.gitbook.io/apentis-api/pages/4024af2cfb822beed3f7d9709ecfed32959bf592#get-v1.1-business-relations-schema-config) to retrieve the list configured for your organisation.

| id                                                  | label                                             |
| --------------------------------------------------- | ------------------------------------------------- |
| estate\_planning                                    | Estate Planning                                   |
| family\_office                                      | Family Office                                     |
| fund\_setup\_and\_administration                    | Fund Setup and Administration                     |
| philanthropy\_advisory                              | Philanthropy Advisory                             |
| portfolio\_management\_advisory                     | Portfolio management - Advisory                   |
| portfolio\_management\_discretionary                | Portfolio management - Discretionary              |
| portfolio\_management\_non\_discretionary\_advisory | Portfolio management - Non-discretionary Advisory |
| portfolio\_management\_rto                          | Portfolio management - RTO                        |
| tax\_planning\_and\_optimization                    | Tax Planning and Optimization                     |
| wealth\_structuring                                 | Wealth Structuring                                |

### Marital statuses (maritalStatus)

**Used in:** Business relations\
**Rule:** Must be one of the codes below.

| id          | label       |
| ----------- | ----------- |
| Single      | Single      |
| Married     | Married     |
| Divorced    | Divorced    |
| Separated   | Separated   |
| Widower     | Widower     |
| Other       | Other       |
| Partnership | Partnership |

### Wealth sources (`wealthSource`)

**Case**: Lowercase code\
**Used in**: Business relations\
**Rule**: Must be one of the codes below.

| id                            | label                        |
| ----------------------------- | ---------------------------- |
| accumulated\_profit           | Accumulated profit           |
| capital\_from\_shareholders   | Capital from shareholders    |
| company\_sale\_ma\_exit       | Company sale / M\&A exit     |
| crypto\_assets                | Crypto assets                |
| divorce                       | Divorce                      |
| donation\_gifts\_from\_family | Donation / gifts from family |
| donation\_gifts\_from\_others | Donation / gifts from others |
| entrepreneurial\_activity     | Entrepreneurial activity     |
| financial\_investments        | Financial investments        |
| inheritance                   | Inheritance                  |
| insurance\_payout             | Insurance payout             |
| litigation\_compensation      | Litigation / compensation    |
| loan\_leverage                | Loan or leverage             |
| lottery\_gambling             | Lottery / gambling           |
| pension\_retirement\_fund     | Pension / retirement fund    |
| real\_estate                  | Real-Estate                  |
| salaries\_remuneration        | Salaries / Remuneration      |

### Origin of business relation (`originOfBusinessRelation`)

**Case**: Lowercase code\
**Used in**: Business relations\
**Rule**: Must be one of the codes below.

| id                               | label                              |
| -------------------------------- | ---------------------------------- |
| business\_intermediary           | Business intermediary              |
| distributor                      | Distributor                        |
| electronic\_platform             | Electronic platform                |
| family\_relation\_of\_employee   | Family relationship of an employee |
| family\_relationship             | Family relationship of a client    |
| historical\_client               | Historical client                  |
| other                            | Other                              |
| prospection                      | Prospection                        |
| relation\_with\_existing\_client | Relationship with existing client  |
| spontaneous\_approach            | Spontaneous approach               |
| tied\_agent                      | Tied agent                         |

### CRS statuses (`crsStatus`)

**Case**: Lowercase code\
**Used in**: Business relations\
**Rule**: Must be one of the codes below.

| id                     | label                 |
| ---------------------- | --------------------- |
| cbi\_rbi\_scheme       | CBI/RBI scheme        |
| conflicting\_indicia   | Conflicting indicia   |
| crs\_compliant         | CRS compliant         |
| missing\_documentation | Missing documentation |
| non\_crs               | Non CRS country       |

### Industry sectors (`industrySector`)

**Case**: Lowercase code\
**Used in**: Business relations\
**Rule:** Apentis standard values are listed below. However, each client can configure its own list of acceptable values. Use the endpoint [`/business-relations/schema-config`](https://apentis.gitbook.io/apentis-api/pages/4024af2cfb822beed3f7d9709ecfed32959bf592#get-v1.1-business-relations-schema-config) to retrieve the list configured for your organisation.

| id                                                              | label                                                                                                                             |
| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| a\_agriculture\_forestry\_and\_fishing                          | A - Agriculture, forestry and fishing                                                                                             |
| b\_mining\_and\_quarrying                                       | B - Mining and quarrying                                                                                                          |
| c\_manufacturing                                                | C - Manufacturing                                                                                                                 |
| d\_electricity\_gas\_steam\_and\_air\_conditioning\_supply      | D - Electricity, gas, steam and air conditioning supply                                                                           |
| e\_water\_supply\_sewerage\_waste\_management\_and\_remediation | E - Water supply; sewerage; waste management and remediation activities                                                           |
| f\_construction                                                 | F - Construction                                                                                                                  |
| g\_wholesale\_and\_retail\_trade\_motor\_vehicles               | G - Wholesale and retail trade; repair of motor vehicles and motorcycles                                                          |
| h\_transporting\_and\_storage                                   | H - Transporting and storage                                                                                                      |
| i\_accommodation\_and\_food\_service\_activities                | I - Accommodation and food service activities                                                                                     |
| j\_information\_and\_communication                              | J - Information and communication                                                                                                 |
| k\_financial\_and\_insurance\_activities                        | K - Financial and insurance activities                                                                                            |
| l\_real\_estate\_activities                                     | L - Real estate activities                                                                                                        |
| m\_professional\_scientific\_and\_technical\_activities         | M - Professional, scientific and technical activities                                                                             |
| n\_administrative\_and\_support\_service\_activities            | N - Administrative and support service activities                                                                                 |
| o\_public\_administration\_and\_defence                         | O - Public administration and defence; compulsory social security                                                                 |
| p\_education                                                    | P - Education                                                                                                                     |
| q\_human\_health\_and\_social\_work\_activities                 | Q - Human health and social work activities                                                                                       |
| r\_arts\_entertainment\_and\_recreation                         | R - Arts, entertainment and recreation                                                                                            |
| s\_other\_services\_activities                                  | S - Other services activities                                                                                                     |
| t\_households\_as\_employers\_and\_own\_use\_activities         | T - Activities of households as employers; undifferentiated goods - and services - producing activities of households for own use |
| u\_extraterritorial\_organisations\_and\_bodies                 | U - Activities of extraterritorial organisations and bodies                                                                       |

### Complexity of BO structure (`complexityOfBoStructure`)

**Case**: Lowercase code\
**Used in**: Business relations\
**Rule:** Apentis standard values are listed below. However, each client can configure its own list of acceptable values. Use the endpoint [`/business-relations/schema-config`](https://apentis.gitbook.io/apentis-api/pages/4024af2cfb822beed3f7d9709ecfed32959bf592#get-v1.1-business-relations-schema-config) to retrieve the list configured for your organisation.

| id                                                    | label                                           |
| ----------------------------------------------------- | ----------------------------------------------- |
| a\_less\_than\_3\_structure\_level\_in\_eu\_countries | A - less than 3 structure level in EU countries |
| b\_less\_than\_3\_structure\_level\_in\_any\_country  | B - less than 3 structure level in any country  |
| c\_3\_to\_6\_structure\_level\_in\_eu\_countries      | C - 3 to 6 structure level in EU countries      |
| d\_3\_to\_6\_structure\_level\_in\_any\_countries     | D - 3 to 6 structure level in any countries     |
| e\_more\_than\_6\_structure\_level                    | E - more than 6 structure level                 |

### Legal forms (`legalForm`)

**Used in**: Business relations\
**Rule**: Must be one of the codes below.

| id             | name                                                    | only for business relation type |
| -------------- | ------------------------------------------------------- | ------------------------------- |
| FCP            | Contractual fund \[FCP]                                 |                                 |
| FI             | Irrevocable Trust \[FI]                                 | Trust                           |
| FR             | Revocable Trust \[FR]                                   | Trust                           |
| SA             | Public limited company \[SA]                            |                                 |
| Sarl           | Private limited company \[Sarl]                         |                                 |
| SAS            | Simplified joint-stock company \[SAS]                   |                                 |
| SCA            | Partnership limited by shares \[SCA]                    |                                 |
| SCoSA          | Cooperative company \[SCoSA]                            |                                 |
| SCS            | Limited partnership \[SCS]                              |                                 |
| SCSp           | Special limited partnership \[SCSp]                     |                                 |
| SCSp SICAV SIF | Special limited partnership SICAV-SIF \[SCSp SICAV SIF] |                                 |
| SICAF          | Investment company with fixed capital \[SICAF]          |                                 |
| SICAV          | Investment company with variable capital \[SICAV]       |                                 |
| testamentary   | Testamentary                                            | Trust                           |

### Roles (`role`)

**Case:** lowercase code\
**Used in:** Business relations links\
**Rule:** Must be one of the codes below. Please see the [Business roles & relationships page](/apentis-api/business-roles-and-relationships.md) to see authorized links between entities.

| id                      | label                         |
| ----------------------- | ----------------------------- |
| auditor                 | Auditor                       |
| beneficial\_owner       | Beneficial owner              |
| beneficiary\_foundation | Beneficiary of the foundation |
| beneficiary\_trust      | Beneficiary of the trust      |
| board\_member           | Board member                  |
| contact                 | Contact (no AML screening)    |
| corporate\_director     | Corporate director            |
| curator                 | Curator                       |
| director                | Director                      |
| domicialiary            | Domiciliary agent             |
| founder                 | Founder (foundation)          |
| general\_partner        | General partner               |
| holder                  | Account holder                |
| key\_person             | Key person                    |
| legal\_guardian         | Legal guardian                |
| limited\_partner        | Limited partner               |
| liquidator              | Liquidator                    |
| member                  | Member                        |
| president               | President                     |
| protector               | Protector                     |
| proxy\_holder           | Proxy holder                  |
| representative          | Representative                |
| secretary               | Secretary                     |
| settlor                 | Settlor                       |
| shareholder             | Shareholder                   |
| treasurer               | Treasurer                     |
| trustee                 | Trustee                       |

### Document types (`documentType`)

**Used in:** KYC documents\
**Rule:** Must be one of the codes below. Codes are **as provided** below — they are **case-sensitive** and may include spaces, slashes or underscores.

| id                             | label                                                   |                                                          |
| ------------------------------ | ------------------------------------------------------- | -------------------------------------------------------- |
| Account opening form           | Account opening form                                    | Formulaire d’ouverture de compte                         |
| account\_valuation             | Account valuation                                       | Évaluation de compte                                     |
| Acknowledgement of receipt     | Acknowledgement of receipt - To invest with us          | Accusé de réception - Pour investir avec nous            |
| Advisory mandate contract      | Advisory mandate contract                               | Contrat de mandat de conseil                             |
| aml\_letter                    | AML letter                                              | Lettre anti-blanchiment                                  |
| AML risk assessment            | AML risk assessment                                     | Évaluation du risque LBC/FT                              |
| Annual accounts (audited)      | Annual accounts (audited)                               | Comptes annuels audités                                  |
| Annual accounts (unaudited)    | Annual accounts (unaudited)                             | Comptes annuels non audités                              |
| Annual report                  | Annual report                                           | Rapport annuel                                           |
| articles\_of\_incorporation    | Articles of Incorporation                               | Statuts constitutifs                                     |
| Association register           | Association register                                    | Registre des associations                                |
| Bank account details           | Bank account details                                    | Coordonnées bancaires                                    |
| Bank statement                 | Bank statement                                          | Relevé bancaire                                          |
| business\_continuity\_plan     | Business continuity plan (BCP / DRP)                    | Plan de continuité d'activité (BCP / DRP)                |
| Capitalization table           | Capitalization table                                    | Tabke de capitalisation                                  |
| Certificate of accommodation   | Certificate of accommodation                            | Certificat d'hébergement                                 |
| Certificate of good standing   | Certificate of good standing                            | Certificat de bonne conduite                             |
| certificate of incorporation   | Certificate of incorporation                            | Certificat de constitution                               |
| Certificate of incumbency      | Certificate of incumbency                               | Certificat d'incumbence                                  |
| Certificate of insurance       | Certificate of insurance                                | Certificat d'assurance                                   |
| Civil partnership certificate  | Civil partnership certificate                           | Certificat de partenariat civil                          |
| Client acceptance doc          | Client acceptance doc                                   | Document d'acceptation du client                         |
| client\_profile                | Client profile                                          | Profil client                                            |
| Collateral agreement           | Collateral agreement                                    | Accord de garantie                                       |
| Consumer loan agreement        | Consumer loan agreement                                 | Contrat de prêt à la consommation                        |
| Copy of transaction notices    | Copy of transaction notices (stocks, bonds,...)         | Copie des avis de transaction (actions, obligations,...) |
| Corporate structure            | Corporate structure                                     | Structure de l'entreprise                                |
| Criminal record                | Criminal record                                         | Extrait de casier judiciaire                             |
| CRS sefl-certification         | CRS – Self-Certification of Tax Residency               | CRS – Auto-certification de résidence fiscale            |
| DAC 6                          | DAC 6                                                   | DAC 6                                                    |
| death\_certificate             | Death certificate                                       | Certificat de décès                                      |
| declaration\_of\_BO            | Declaration of BO                                       | Déclaration du bénéficiaire effectif                     |
| deed                           | Deed                                                    | Acte notarié                                             |
| Discretionary mandate contract | Discretionary mandate contract                          | Contrat de mandat discrétionnaire                        |
| Divorce judgment               | Divorce judgment                                        | Jugement de divorce                                      |
| Driving licence                | Driving licence                                         | Permis de conduire                                       |
| Eligibility assessment         | Eligibility assessment                                  | Note d'éligibilité                                       |
| Employment certificate         | Employment certificate                                  | Attestation employeur                                    |
| Employment contract            | Employment contract                                     | Contrat de travail                                       |
| End of relationship doc        | End of relationship doc                                 | Document de fin de relation                              |
| Engagement letter              | Engagement letter                                       | Lettre d’engagement                                      |
| entering business relationship | File for entering into a business relationship (DER)    | Dossier d'entrée en relation d'affaires (DER)            |
| Equity ownership report        | Equity ownership report                                 | Rapport sur la détention du capital                      |
| Family record book             | Family record book                                      | Livret de famille                                        |
| FATCA classification           | FATCA classification                                    | Classification FATCA                                     |
| Financial statement            | Financial statement                                     | États financiers                                         |
| Financing plan                 | Financing plan                                          | Plan de financement                                      |
| general\_conditions            | General conditions                                      | Conditions générales                                     |
| Health insurance card          | Health insurance card                                   | Carte de sécurité sociale                                |
| ID card scan                   | ID card                                                 | Scan de la carte d'identité                              |
| investment\_profile            | Investment profile                                      | Profil d'investissement                                  |
| KYC Form                       | KYC form                                                | Fiche de renseignements - KYC                            |
| kyc\_report                    | KYC report                                              | Rapport KYC                                              |
| Life insurance contract        | Life insurance contract                                 | Contrat d'assurance-vie                                  |
| Limited partnership agreement  | Limited partnership agreement                           | Contrat de société en commandite                         |
| list\_authorized\_signatures   | List of authorized signatures                           | Liste des signatures autorisées                          |
| Management agreement           | Management agreement                                    | Contrat de gestion                                       |
| Management regulations         | Management regulations                                  | Règlement de gestion                                     |
| Marriage certificate           | Marriage certificate                                    | Certificat de mariage                                    |
| Memorandum of association      | Memorandum of association                               | Statuts constitutifs                                     |
| MIFID classification           | MIFID classification                                    | Classification MIFID                                     |
| MIFID form                     | MIFID form                                              | Formulaire MIFID                                         |
| Mortgage loan agreement        | Mortgage loan agreement                                 | Contrat de prêt hypothécaire                             |
| name\_check                    | Name check                                              | Vérification de nom                                      |
| Operating memorandum           | Operating memorandum                                    | Mémorandum opérationnel                                  |
| Others                         | Others                                                  | Autres                                                   |
| Passport                       | Passport                                                | Passeport                                                |
| Pay slip                       | Pay slip                                                | Fiche de paie                                            |
| Phone subscription             | Phone subscription                                      | Abonnement téléphonique                                  |
| power\_of\_attorney            | Power of attorney                                       | Procuration                                              |
| Private placement memorandum   | Private placement memorandum                            | Mémorandum de placement privé                            |
| Proof of domicile              | Proof of domicile                                       | Justificatif de domicile                                 |
| Proof of listing               | Proof of listing                                        | Preuve de cotation                                       |
| Proof of origin of capital     | Source of wealth documentation                          | Documentation de la source de richesse                   |
| Proof of public body           | Proof of public body                                    | Justificatif organisme public                            |
| Proof of regulation            | Proof of regulation                                     | Justificatif d’agrément réglementaire                    |
| Proof of supervision           | Proof of supervision                                    | Justificatif de supervision                              |
| PV board of directors          | Deliberation of the last Board of Directors             | Délibération du dernier Conseil d'administration         |
| PV BoD                         | PV BoD                                                  | Conseil d'administration PV                              |
| PV general assembly            | Minutes of the last General Assembly                    | Procès-verbal de la dernière Assemblée Générale          |
| RCS                            | Trade register extract                                  | Extrait du registre du commerce                          |
| Register of beneficial owners  | Register of beneficial owners                           | Registre des bénéficiaires effectifs                     |
| Register of directors          | Register of directors                                   | Registre des administrateurs                             |
| Register of shareholders       | Register of shareholders                                | Registre des actionnaires                                |
| Resident card                  | Resident card                                           | Carte de résident                                        |
| Residence certificate          | Residence certificate                                   | Certificat de résidence                                  |
| RTO mandate contract           | RTO mandate contract                                    | Contrat de mandat RTO                                    |
| Separation agreement           | Separation agreement                                    | Accord de séparation                                     |
| Share Purchase Agreement (SPA) | Share Purchase Agreement (SPA)                          | Contrat d'achat d'actions                                |
| Status                         | Articles of association of a company                    | Statuts de l'entreprise                                  |
| Structure chart                | Structure chart                                         | Organigramme                                             |
| Subscription agreement         | Subscription agreement                                  | Contrat de souscription                                  |
| Tax notice                     | Tax notice                                              | Avis d'imposition                                        |
| Tax registration number        | Tax registration number                                 | Numéro d'immatriculation fiscale                         |
| termination\_letter            | Termination letter                                      | Lettre de résiliation                                    |
| Trade / Economic license       | Trade / Economic license                                | Licence commerciale / économique                         |
| Transaction record             | Transaction record (stocks, bonds,...)                  | Relevé de transaction (actions, obligations,...)         |
| Tripartite agreement           | Tripartite agreement                                    | Accord tripartite                                        |
| Trust register documents       | Trust register documents                                | Documents du registre des fiducies                       |
| Unique Identification Number   | Unique Identification Number                            | Numéro d’identification unique                           |
| utility\_bill                  | Utility Bill                                            | Facture de services publics                              |
| VAT registration certificate   | VAT registration certificate                            | Certificat d'immatriculation à la TVA                    |
| VISA page                      | VISA page                                               | Page de visa                                             |
| visit\_report                  | Rapport de visite                                       | Rapport de visite                                        |
| W-8BEN                         | W-8BEN – Certificate of Foreign Status (FATCA)          | W-8BEN – Attestation de statut étranger (FATCA)          |
| W-9                            | W-9 – Request for Taxpayer ID and Certification (FATCA) | W-9 – Demande d’identification fiscale (FATCA)           |

### AML risk ratings (`amlRiskRating`)

**Case**: Lowercase code\
**Used in**: AML/KYC results\
**Rule**: Must be one of the codes below.

| id           | label       |
| ------------ | ----------- |
| low          | Low         |
| medium       | Medium      |
| medium\_high | Medium-high |
| high         | High        |
| prohibited   | Prohibited  |

### Due diligence types (`dueDiligenceType`)

**Case**: lowercase code\
**Used in**: AML/KYC results\
**Rule**: Must be one of the codes below.

| id         | label      |
| ---------- | ---------- |
| simplified | Simplified |
| standard   | Standard   |
| enhanced   | Enhanced   |

### Relation acceptance statuses (`relationAcceptanceStatus`)

**Used in**: AML/KYC results\
**Rule**: Must be one of the codes below.

| id          | label       |
| ----------- | ----------- |
| Approved    | Approved    |
| Rejected    | Rejected    |
| Conditional | Conditional |
| Revoked     | Revoked     |

### Account statuses (`accountStatus`)

**Used in**: AML/KYC results\
**Rule**: Must be one of the codes below.

| id           | label        |
| ------------ | ------------ |
| Active       | Active       |
| Soft blocked | Soft blocked |
| Hard blocked | Hard blocked |

### Blocking reasons (`blockingReason`)

**Case**: lowercase code\
**Used in**: AML/KYC results\
**Rule**: Must be one of the codes below.

| id                                  | label                            |
| ----------------------------------- | -------------------------------- |
| account\_opening\_pending\_approval | Account opening pending approval |
| aml\_escalation\_suspicious         | AML Escalation (suspicious)      |
| aml\_review\_pending                | AML Review Pending               |
| expired\_kyc                        | Expired KYC                      |
| fiu\_regulatory\_request            | FIU – Regulatory Request         |
| fraud                               | Fraud                            |
| legal                               | Legal                            |
| missing\_documents                  | Missing document(s)              |
| tax\_non\_compliance                | Tax non-compliance               |

### KYC statuses (`kycStatus`)

**Case**: lowercase code\
**Used in**: AML/KYC results\
**Rule**: Must be one of the codes below.

| id        | label     |
| --------- | --------- |
| to review | To review |
| reviewed  | Reviewed  |

### Transaction types (`transactionType`)

**Case**: lowercase code\
**Used in**: Cashflow monitoring\
**Rule**: Must be one of the codes below.

| id                 | label              |
| ------------------ | ------------------ |
| dividend           | To review          |
| coupon             | Reviewed           |
| interest-payment   | Interest payment   |
| bond-reimbursement | Bond reimbursement |
| forex              | Forex              |
| cash-transfer      | Cahs transfer      |
| fee                | Fee                |
| tax                | Tax                |
| time-deposit       | Time deposit       |
| loan               | Loan               |
| margin-call        | Margin call        |
| capital-call       | Capital call       |
| distribution       | Distribution       |
| other              | Other              |

### Transaction directions (`transactionDirection`)

**Case**: lowercase code\
**Used in**: Cashflow monitoring\
**Rule**: Must be one of the codes below.

| id      | label   |
| ------- | ------- |
| inflow  | Inflow  |
| outflow | Outflow |

### Analysis result statuses (`analysisResultStatus`)

**Case**: lowercase code\
**Used in**: Cashflow monitoring\
**Rule**: Must be one of the codes below.

| id             | label          |
| -------------- | -------------- |
| clear          | Clear          |
| flagged        | Flagged        |
| pending-review | Pending review |

### Risk levels (`riskLevel`)

**Case**: lowercase code\
**Used in**: Cashflow monitoring\
**Rule**: Must be one of the codes below.

| id     | label  |
| ------ | ------ |
| low    | Low    |
| medium | Medium |
| high   | High   |

### Compliance review statuses (`complianceReviewStatus`)

**Case**: lowercase code\
**Used in**: Cashflow monitoring\
**Rule**: Must be one of the codes below.

| id                   | label               |
| -------------------- | ------------------- |
| approved             | Approved            |
| under\_investigation | Under investigation |
| escalated            | Escalated           |
| dismissed            | Dismissed           |

### Security asset class codes (`security_asset_class_id`)

**Case:** UPPERCASE code\
**Used in:** Portfolio data\
**Rule:** Must be one of the codes below.

| id    | label                        |
| ----- | ---------------------------- |
| AR    | Absolute return              |
| CA    | Cash & Money markets         |
| CC    | Cryptocurrency               |
| CF    | Credit facility / loan       |
| CO    | Commodities                  |
| CV    | Convertible bond             |
| DE    | Derivative                   |
| EQ    | Equities                     |
| FI    | Fixed income                 |
| FRN   | Floating rate note           |
| FX    | Forex                        |
| HF    | Hedge fund                   |
| MAC   | Multi asset class            |
| MZ    | Mezzanine                    |
| NFA   | Non-financial assets         |
| OTHER | Others                       |
| PD    | Private debt                 |
| PE    | Private equity               |
| PP    | Perp bond                    |
| RE    | Real estate                  |
| RLI   | Reduced liquidity investment |
| SE    | Securitization               |
| SP    | Structured products          |
| VOL   | Volatilities                 |
| YI    | Yield                        |

### Security sector codes (`security_sector_id`)

**Used in:** Portfolio data\
**Case & format:** Codes are **case-sensitive** and may include non-alphanumeric values (e.g., `-`). Use **exact** values from the table below.

| id     | label                  |
| ------ | ---------------------- |
| -      | Diversified            |
| CD     | Consumer Discretionary |
| CS     | Consumer Staples       |
| EN     | Energy                 |
| FN     | Financials             |
| HC     | Health Care            |
| ID     | Industrials            |
| IT     | Information Technology |
| MA     | Materials              |
| Others | Others                 |
| RE     | Real Estate            |
| TE     | Communication Services |
| UT     | Utilities              |

{% hint style="warning" %}
Note: `-` represents **Diversified**. Keep it as the literal hyphen.
{% endhint %}

### Security industry codes (`security_industry_id`)

**Used in:** Portfolio data\
**Case & format:** Codes are **case-sensitive** and may include non-alphanumeric values (e.g., `-`). Use the **exact** values below.

{% hint style="danger" %}
Security industry and security sector are **jointly constrained**. In particular, `security_industry_id` is only valid **within** specific `security_sector_id` values.

**Rule:** the `(industry, sector)` pair must match the mapping below.
{% endhint %}

| industry `id` | industry `name`                          | sector `id` |
| ------------- | ---------------------------------------- | ----------- |
| -             | Diversified                              | -           |
| AC            | Automobiles & Components                 | CD          |
| BK            | Banks                                    | FN          |
| CDA           | Consumer Durables & Apparel              | CD          |
| CG            | Capital Goods                            | ID          |
| CPS           | Commercial & Professional Services       | ID          |
| DF            | Diversified Financials                   | FN          |
| EN            | Energy                                   | EN          |
| FBT           | Food, Beverage & Tobacco                 | CS          |
| FSR           | Food, Staples Retailing                  | CS          |
| HCES          | Health Care Equipment & Services         | HC          |
| HPP           | Household & Personal Products            | CS          |
| HRL           | Consumer services                        | CD          |
| IN            | Insurance                                | FN          |
| MA            | Materials                                | MA          |
| ME            | Media & Entertainment                    | TE          |
| PB            | Pharmaceuticals & Biotechnology          | HC          |
| RE            | Real Estate                              | RE          |
| RT            | Retailing                                | CD          |
| SS            | Software & Services                      | IT          |
| SSE           | Semiconductors & Semiconductor Equipment | IT          |
| THE           | Technology Hardware & Equipment          | IT          |
| TR            | Transportation                           | ID          |
| TS            | Telecommunication Services               | TE          |
| UT            | Utilities                                | UT          |

{% hint style="warning" %}
• Industry “**-**” (Diversified) pairs only with sector “**-**”.\
• Some sector codes (e.g., `Others`) currently have **no** industry breakdown; in such cases the API will either return `security_industry_id = "-"` .
{% endhint %}

### Change management

* **Additions:** New codes may be added; they won’t break clients that validate by **allow-list + fallback UI**.
* **Deprecations:** Deprecated codes remain valid for a grace period; we will publish deprecation notices here in the documentation and via the API release note.
* **Requests for new codes:** Open a ticket within the application or contact us at <support@apentis.eu> with the proposed code and a short business rationale.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apentis.gitbook.io/apentis-api/references-codes-and-lists.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.