### Example API Request with Access Token (Shell)

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This example shows how to use a previously obtained access token to make an API request. It uses curl to send a POST request to the companies/getCollection endpoint with necessary headers and a JSON payload for filtering.

```shell
curl -X POST 'https://api.uc.se/se/companies/getCollection' \
    --header 'Content-Type: application/json' \
    --header 'cost-org: <cost-org>' \
    --header 'Authorization: Bearer <access_token>' \
    -d '{ "fields": { "INFORMATION_BASIC": true }, "filter": { "company.orgNumber": { "in": [ "165561375113" ] } } }'
```

--------------------------------

### Business Insight API Request Example

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

An example of a request body for the Business Insight API. It specifies the desired data fields and applies filters to target specific objects, such as a company by its organization number.

```json
{
  "fields": {
    "INFORMATION_BASIC": true
  },
  "filter": {
    "company.orgNumber": {
      "in": [
        "165561375113"
      ]
    }
  }
}
```

--------------------------------

### Example Screening Item Entity Structure

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet defines the structure for an entity found within a screening item. It includes details such as foundation date, name, start date, screening list, and associated addresses. This is part of the Business Insight API's output for risk assessment.

```json
{
  "foundationDate": "",
  "keyWordHitRating": "",
  "name": "Name associated with the screening item.",
  "startDate": "2025-04-02T15:06:38.037Z",
  "effectiveDate": "",
  "lastUpdated": "2025-04-02T15:06:38.037Z",
  "screeningList": "SANCTIONS_EU",
  "screeningType": "SANCTIONS",
  "description": {
    "comment": "Comment about the screening item",
    "sourceUrl": "https://www.uc.se/"
  },
  "itemIds": [
  ],
  "countries": [
    {
      "countryCode": "SE",
      "countryName": "Sweden",
      "countryType": ""
    }
  ],
  "aliases": [
    
  ],
  "addresses": [
    {
      "street": "Old town, Gamla stan",
      "zipCode": "17100",
      "city": "Stockholm City",
      "country": "Sweden",
      "countryCode": "SE"
    }
  ]
}
```

--------------------------------

### Price Details Structure Example

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet illustrates the pricing structure for the API product, including discount, currency, list price, and specific service details. It defines the cost associated with different API functionalities.

```json
{
        "price": {
            "discount": "0",
            "currency": "SEK",
            "listPrice": 0,
            "details": {
                "FIND_HISTORICAL_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": null,
                "FIND_WORKPLACES": null,
                "DECISION_MAKER_BASIC": null,
                "DECISION_MAKER_EMAIL": null,
                "DECISION_MAKER_LANDLINE": null,
                "FIND_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": null,
                "WORKPLACES": null,
                "COMPANY_INFO_EMAIL": null,
                "INFORMATION_BASIC": null
            }
        }
    }
```

--------------------------------

### GET /businesses

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves a list of businesses with their associated details. This endpoint allows filtering and retrieving comprehensive business data.

```APIDOC
## GET /businesses

### Description
Retrieves a list of businesses with their associated details. This endpoint allows filtering and retrieving comprehensive business data.

### Method
GET

### Endpoint
/businesses

### Parameters
#### Query Parameters
- **companyName** (string) - Optional - Filter businesses by company name.
- **industryCode** (string) - Optional - Filter businesses by industry code.
- **minEmployees** (integer) - Optional - Filter businesses by minimum number of employees.
- **maxEmployees** (integer) - Optional - Filter businesses by maximum number of employees.

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **items** (array) - A list of business objects.
  - **workplaces** (array) - Details about the workplaces of a business.
    - **industries** (array) - Industry classifications for a workplace.
      - **value** (object) - Industry value details.
        - **section** (string) - Industry section code.
        - **weight** (integer) - Industry weight.
        - **detailedGroup** (string) - Detailed industry group code.
    - **numberOfEmployees** (integer) - Number of employees at the workplace.
    - **lastModification** (string) - The date and time of the last modification.
    - **registeredDate** (string) - The registration date of the workplace.
    - **name** (string) - The name of the workplace.
    - **cfarNumber** (string) - The CFAR number of the workplace.
    - **headquarter** (boolean) - Indicates if this is the headquarter.
    - **active** (boolean) - Indicates if the workplace is active.
    - **contact** (object) - Contact information for the workplace.
  - **company** (object) - General company information.
    - **industries** (array) - Industry classifications for the company.
    - **numberOfEmployees** (object) - Range of employees for the company.
      - **min** (integer) - Minimum number of employees.
      - **max** (integer) - Maximum number of employees.
    - **lastModification** (string) - The date and time of the last modification.
    - **vat** (object) - VAT information.
      - **number** (string) - VAT number.
      - **active** (boolean) - Indicates if VAT is active.
    - **registrationDate** (object) - Registration date details.
      - **value** (string) - The registration date.
    - **partOfHierachy** (boolean) - Indicates if the company is part of a hierarchy.
    - **orgNumber** (string) - The organization number.
    - **credibility** (object) - Credibility information.
    - **businessNamesInTranslation** (array) - Business names in different translations.
    - **secondaryBusinessNames** (array) - Secondary business names.
    - **name** (object) - The name of the company.
      - **value** (string) - The company name.
    - **domicile** (object) - Domicile information.
      - **county** (string) - The county of domicile.
      - **municipality** (string) - The municipality of domicile.
    - **representatives** (array) - Company representatives.
    - **status** (object) - Company status.
      - **value** (string) - The status value.
    - **signatoryText** (string) - Signatory text.
    - **businessDescription** (string) - Description of the company's business.
    - **state** (object) - Company state details.
      - **liquidation** (object) - Liquidation details.
      - **companyReconstruction** (object) - Company reconstruction details.
      - **merger** (object) - Merger details.
        - **acquiringCompanies** (array) - List of acquiring companies.

#### Response Example
```json
{
  "items": [
    {
      "workplaces": [
        {
          "industries": [
            {
              "value": {
                "section": "N",
                "weight": 1,
                "detailedGroup": "82910"
              }
            },
            {
              "value": {
                "section": "J",
                "weight": 2,
                "detailedGroup": "63120"
              }
            }
          ],
          "numberOfEmployees": null,
          "lastModification": "2023-09-25T09:12:02.090Z",
          "registeredDate": null,
          "name": null,
          "cfarNumber": "17485046",
          "headquarter": true,
          "active": true,
          "contact": null
        }
      ],
      "company": {
        "industries": [
          {
            "value": {
              "section": "N",
              "weight": 1,
              "detailedGroup": "82910"
            }
          },
          {
            "value": {
              "section": "J",
              "weight": 2,
              "detailedGroup": "63120"
            }
          }
        ],
        "numberOfEmployees": {
          "min": 100,
          "max": 199
        },
        "lastModification": "2023-11-01T00:43:24.937Z",
        "vat": {
          "number": "SE556137511301",
          "active": true
        },
        "registrationDate": {
          "value": "1970-07-15"
        },
        "partOfHierachy": true,
        "orgNumber": "165561375113",
        "credibility": null,
        "businessNamesInTranslation": null,
        "secondaryBusinessNames": null,
        "name": {
          "value": "UC AB"
        },
        "domicile": {
          "county": "Stockholms län",
          "municipality": "Stockholm"
        },
        "representatives": null,
        "status": {
          "value": "ACTIVE"
        },
        "signatoryText": null,
        "businessDescription": "Bolaget har till föremål för sin verksamhet att bedriva \nkreditupplysningsverksamhet, att tillhandahålla tjänster och information för marknadsföring, att tillhandahålla annan affärsinformation samt att bedriva annan därmed förenlig verksamhet.",
        "state": {
          "liquidation": null,
          "companyReconstruction": null,
          "merger": {
            "acquiringCompanies": []
          }
        }
      }
    }
  ]
}
```
```

--------------------------------

### Business Insight API Pricing Structure (JSON Example)

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet details the pricing for various business insight data points. It includes list prices, discounted prices, and currency information. The structure allows for granular pricing details for specific data features.

```json
{
  "discount": "0",
  "currency": "SEK",
  "listPrice": 0,
  "details": {
    "FIND_HISTORICAL_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": null,
    "FIND_WORKPLACES": null,
    "DECISION_MAKER_BASIC": null,
    "DECISION_MAKER_EMAIL": null,
    "DECISION_MAKER_LANDLINE": null,
    "FIND_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": {
      "hits": 4,
      "listPrice": 2
    },
    "WORKPLACES": null,
    "COMPANY_INFO_EMAIL": null,
    "INFORMATION_BASIC": null,
    "SIGNATORY_CHECK": null,
    "ANNUAL_FINANCIAL_REPORT": null,
    "FIND_COMPANIES": null,
    "SIGNATORY_AND_FUNCTIONAL_ROLES": null,
    "FIND_ORGANISATIONS": null,
    "COMPANY_INFO_WEBSITE": null,
    "DECISION_MAKER_MOBILE": null,
    "ON_BOARDING": null,
    "HISTORICAL_FINANCIAL_REPORT": null,
    "HIERARCHIES": null
  },
  "discountListPrice": 8
}
```

--------------------------------

### GET /apis/rest/certificates-of-registration/{orgNumber}

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieve the certificate of registration in PDF format for a given organization number. Requires the 'cost-org' header.

```APIDOC
## GET /apis/rest/certificates-of-registration/{orgNumber}

### Description
Retrieve the certificate of registration in PDF format for a given organization number. Requires the 'cost-org' header.

### Method
GET

### Endpoint
/apis/rest/certificates-of-registration/{orgNumber}

### Parameters
#### Path Parameters
- **orgNumber** (string) - Required - The organization number for which to retrieve the certificate of registration. Must follow the pattern `^([0-9]{6}-[0-9]{4}|[0-9]{10}|[0-9]{8}-[0-9]{4}|[0-9]{12})$`.

#### Header Parameters
- **cost-org** (string) - Required - The cost organization identifier.

### Response
#### Success Response (200)
- **Binary data** (string, format: binary) - The certificate of registration in PDF format.

#### Response Example
```json
{
  "example": "PDF content of the certificate of registration"
}
```
```

--------------------------------

### Example Search Value List Structure

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet showcases the structure for a list of search values used in screening processes. Each item in the list specifies a value, its hit type, and the type of list it belongs to, such as NORDIC_PEP or various international sanctions lists.

```json
{
  "searchValueList": [
    {
      "value": "19X005XXXX777",
      "hitType": false,
      "hitId": "",
      "listType": "NORDIC_PEP"
    },
    {
      "value": "Test Tester",
      "hitType": false,
      "hitId": "",
      "listType": "INTERNATIONAL_PEP, SANCTIONS_UN, SANCTIONS_OFAC_SD, SANCTIONS_UK, SANCTIONS_OFAC_CS, SANCTIONS_EU, INTERNATIONAL_SANCTIONS, INTERNATIONAL_ENFORCEMENTS, INTERNATIONAL_SOE, BV_AF"
    }
  ],
  "fullName": "Test Tester",
  "firstName": "Test",
  "middleName": "",
  "lastName": "Tester",
  "personIdType": "PERSONAL_IDENTITY_NUMBER",
  "personIdValue": "19X005XXXX777",
  "birthDate": "1975-09-13",
  "countryCode": "SE",
  "controlTypes": "",
  "extentOfControl": "",
  "role": "BOARD_MEMBER"
}
```

--------------------------------

### Get Access Token for Production (Shell)

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This code snippet demonstrates how to obtain an access token for production use. It uses curl to send a POST request to the authentication endpoint with grant type, client ID, username, and password.

```shell
curl --location --request POST 'https://login.enento.com/am/oauth2/access_token' \
    --header 'Content-Type: application/x-www-form-urlencoded' \
    --data-urlencode 'grant_type=password' \
    --data-urlencode 'client_id=m2m_authentication_client' \
    --data-urlencode 'username=<YOUR_PROD_USERNAME>' \
    --data-urlencode 'password=<YOUR_PROD_PASSWORD>'
```

--------------------------------

### Business Entity Types

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This section details the various types of business entities recognized by the API, along with their definitions and examples.

```APIDOC
## Business Entity Types

### Description
Provides a list of recognized business entity types, their definitions, and examples.

### Method
GET

### Endpoint
/business-entities

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **entityType** (string) - The type of business entity.
- **description** (string) - A detailed description of the entity type.
- **example** (string) - An example of the entity type.

#### Response Example
```json
{
  "entityType": "LIMITED_COMPANY",
  "description": "A limited company is a type of company that is \"limited\" by shares or by guarantee. Limited by shares means that the company is legally \"owned\" by its shareholders and the liability of the shareholders is limited to the amount of investment they have made.",
  "example": "LIMITED_COMPANY"
}
```
```

--------------------------------

### Find Workplaces API

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Provides a search function to get a list of specific companies' workplaces based on company filters. The response includes the company registration number and workplace details.

```APIDOC
## Find Workplaces API

### Description
Provides search function in order to get a list of specific companies workplaces based on company filters. The response will contain a list with cfar number and post town.

### Data Package Includes

- Corporate Registration Number
- Workplaces (Name, CFAR number, Town)

### Method
POST

### Endpoint
/apis/rest/find/workplaces

### Request Body Example
```json
{
  "fields": {
    "FIND_WORKPLACES": true
  },
  "filter": {
    "company.orgNumber": {
      "in": [ "165561375113" ]
    }
  }
}
```

### Response Example (Success 200)
```json
{
  "organisationId": "165561375113",
  "workplaces": [
    {
      "name": "Head Office",
      "cfarNumber": "12345",
      "town": "Stockholm"
    },
    {
      "name": "Branch Office",
      "cfarNumber": "67890",
      "town": "Gothenburg"
    }
  ]
}
```
```

--------------------------------

### GET /websites/developerportal_enento_api-products_business-insight-5_5

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves a list of businesses with their associated workplace and industry details. This endpoint is useful for gaining insights into business operations, including their registered information and contact details.

```APIDOC
## GET /websites/developerportal_enento_api-products_business-insight-5_5

### Description
Retrieves a list of businesses with their associated workplace and industry details. This endpoint is useful for gaining insights into business operations, including their registered information and contact details.

### Method
GET

### Endpoint
/websites/developerportal_enento_api-products_business-insight-5_5

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **items** (array) - An array of business objects, each containing workplace and industry information.
  - **workplaces** (array) - An array of workplace objects associated with a business.
    - **industries** (array) - An array of industry objects.
      - **value** (object) - Contains industry details.
        - **section** (string) - The industry section code.
        - **weight** (integer) - The industry weight.
        - **detailedGroup** (string) - The detailed industry group code.
    - **numberOfEmployees** (integer) - The number of employees (nullable).
    - **lastModification** (string) - The date and time of the last modification (ISO 8601 format).
    - **registeredDate** (string) - The registered date of the business (nullable).
    - **name** (string) - The name of the workplace (nullable).
    - **cfarNumber** (string) - The CFAR number of the workplace.
    - **headquarter** (boolean) - Indicates if this is the headquarter.
    - **active** (boolean) - Indicates if the workplace is active.
    - **contact** (object) - Contact information for the workplace.
      - **county** (string) - The county of the contact.
      - **address** (object) - Address details.
        - **postal** (object) - Postal address details.
          - **country** (string) - The country of the postal address (nullable).
          - **postTown** (string) - The postal town.
          - **careOf** (string) - The care-of information (nullable).
          - **postCode** (string) - The postal code.
          - **street** (string) - The street of the postal address.
          - **advertisingBlock** (boolean) - Indicates if the postal address is an advertising block.
        - **visiting** (object) - Visiting address details.
          - **country** (string) - The country of the visiting address (nullable).
          - **postTown** (string) - The visiting postal town.
          - **postCode** (string) - The visiting postal code.
          - **street** (string) - The street of the visiting address.
      - **phone** (object) - Phone number details.
        - **number** (string) - The phone number.
        - **advertisingBlock** (boolean) - Indicates if the phone number is an advertising block.
      - **municipality** (string) - The municipality of the contact.

#### Response Example
```json
{
    "items": [
        {
            "workplaces": [
                {
                    "industries": [
                        {
                            "value": {
                                "section": "N",
                                "weight": 1,
                                "detailedGroup": "82910"
                            }
                        },
                        {
                            "value": {
                                "section": "J",
                                "weight": 2,
                                "detailedGroup": "63120"
                            }
                        }
                    ],
                    "numberOfEmployees": null,
                    "lastModification": "2023-09-25T09:12:02.090Z",
                    "registeredDate": null,
                    "name": null,
                    "cfarNumber": "17485046",
                    "headquarter": true,
                    "active": true,
                    "contact": {
                        "county": "Stockholms län",
                        "address": {
                            "postal": {
                                "country": null,
                                "postTown": "STOCKHOLM",
                                "careOf": null,
                                "postCode": "10127",
                                "street": "BOX 353",
                                "advertisingBlock": false
                            },
                            "visiting": {
                                "country": null,
                                "postTown": "STOCKHOLM",
                                "postCode": "11164",
                                "street": "Klarabergsviadukten 63"
                            }
                        },
                        "phone": {
                            "number": "086709000",
                            "advertisingBlock": false
                        },
                        "municipality": "Stockholm"
                    }
                }
            ]
        }
    ]
}
```
```

--------------------------------

### Example Person Data Structure

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet illustrates the structure for representing person data, including identification details, birth date, country code, and control-related information. It is used within the Business Insight API for detailed entity analysis.

```json
{
  "firstName": "Test",
  "middleName": "",
  "lastName": "Person",
  "personIdType": "PERSONAL_IDENTITY_NUMBER",
  "personIdValue": "19X005XXXX999",
  "birthDate": "1975-09-13",
  "countryCode": "SE",
  "controlTypes": "APPOINT_REMOVE_BOARD",
  "extentOfControl": "CONTROL_MORE_THAN_0_NO_MORE_THAN_25 - The individual controls more than 0 but less than 25% of the organisation",
  "role": "CEO, BENEFICIAL_OWNER"
}
```

--------------------------------

### Example JSON Structure for Company Data

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet illustrates the structure of company data retrieved from the Business Insight API. It includes nested objects for address, phone numbers, municipality, industries, employee numbers, and registration dates. Note the distinct 'postal' and 'visiting' address types and the detailed breakdown of industry information.

```json
{
    "address": {
        "postal": {
            "country": null,
            "postTown": "MALMÖ",
            "careOf": null,
            "postCode": "21118",
            "street": "MALMÖHUSVÄGEN 1",
            "advertisingBlock": false
        },
        "visiting": {
            "country": null,
            "postTown": "MALMÖ",
            "postCode": "21118",
            "street": "MALMÖHUSVÄGEN 1"
        }
    },
    "phone": {
        "number": "0406117303",
        "advertisingBlock": false
    },
    "municipality": "Malmö"
}
```

--------------------------------

### Onboarding Information

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves comprehensive onboarding information for a company.

```APIDOC
## Get Onboarding Information

### Description
Retrieves all relevant onboarding information for a company.

### Method
GET

### Endpoint
/companies/onboarding

### Parameters
#### Query Parameters
- **corporateRegistrationNumber** (string) - Required - The corporate registration number of the company.

### Request Example
```
/companies/onboarding?corporateRegistrationNumber=12345678
```

### Response
#### Success Response (200)
- **corporateRegistrationNumber** (string) - The corporate registration number.
- **companyName** (string) - The company name (including secondary names and translations).
- **companyStatus** (object) - The detailed company status and legal entity.
  - **detailedStatus** (string) - The detailed status of the company.
  - **legalEntity** (string) - The legal entity type.
- **workplaces** (array) - Information about the company's workplaces.
  - **cfarNumber** (string) - The CFAR number.
  - **numberOfWorkplaces** (integer) - The number of workplaces.
  - **headquarter** (boolean) - Indicates if it's a headquarters.
  - **location** (string) - The location of the workplace.
  - **phoneNumber** (string) - The phone number for the workplace.
- **partOfHierarchies** (boolean) - Indicates if the company is part of any hierarchies.
- **headquartersLocation** (object) - The headquarters location details.
  - **address** (string) - The street address.
  - **zipCode** (string) - The zip code.
  - **city** (string) - The city.
  - **county** (string) - The county.
  - **municipality** (string) - The municipality.
- **visitingLocation** (object) - The visiting location details.
  - **address** (string) - The street address.
  - **zipCode** (string) - The zip code.
  - **city** (string) - The city.
- **phoneNumber** (string) - The main phone number of the company.

#### Response Example
```json
{
  "corporateRegistrationNumber": "12345678",
  "companyName": "Example Corp (Translated Name)",
  "companyStatus": {
    "detailedStatus": "Active",
    "legalEntity": "Limited Company"
  },
  "workplaces": [
    {
      "cfarNumber": "W123",
      "numberOfWorkplaces": 1,
      "headquarter": true,
      "location": "Main Office",
      "phoneNumber": "+123456789"
    }
  ],
  "partOfHierarchies": false,
  "headquartersLocation": {
    "address": "123 Main St",
    "zipCode": "10001",
    "city": "New York",
    "county": "New York County",
    "municipality": "New York City"
  },
  "visitingLocation": {
    "address": "123 Main St",
    "zipCode": "10001",
    "city": "New York"
  },
  "phoneNumber": "+123456789"
}
```
```

--------------------------------

### Get Company Events

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves a paginated list of company events based on specified filters.

```APIDOC
## GET /companies/events

### Description
Retrieves a paginated list of company events. Allows filtering by various company attributes.

### Method
GET

### Endpoint
/companies/events

### Parameters
#### Query Parameters
- **filter** (object) - Optional - Allows filtering of results based on various company properties. See [FilterCompany](#) for details.
- **page** (integer) - Optional - The page number to retrieve. Defaults to 1.
- **size** (integer) - Optional - The number of items per page. Defaults to 20.
- **limit** (integer) - Optional - The maximum number of items to return. Defaults to 20.

### Request Example
```json
{
  "filter": {
    "company.name.value": {
      "startsWith": "Acme Corp"
    },
    "company.vat.active": {
      "eq": true
    }
  },
  "page": 1,
  "size": 10
}
```

### Response
#### Success Response (200)
- **meta** (Meta) - Metadata for the paginated response.
- **items** (array[CompanyEventDTO]) - A list of company event data transfer objects.

#### Response Example
```json
{
  "meta": {
    "current": "1",
    "previous": null,
    "next": "2"
  },
  "items": [
    {
      "event_code": "INCORPORATION",
      "date": "2023-01-15T10:00:00Z",
      "company_org_number": "1234567890"
    },
    {
      "event_code": "ADDRESS_CHANGE",
      "date": "2023-03-20T14:30:00Z",
      "company_org_number": "1234567890"
    }
  ]
}
```
```

--------------------------------

### GET /apis/rest/articles-of-association/{orgNumber}

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves the Articles of Association in PDF format for a given organization number.

```APIDOC
## GET /apis/rest/articles-of-association/{orgNumber}

### Description
Retrieves the Articles of Association in PDF format for a given organization number.

### Method
GET

### Endpoint
/apis/rest/articles-of-association/{orgNumber}

### Parameters
#### Path Parameters
- **orgNumber** (string) - Required - Organization number of the company. Must match one of the following patterns: `^([0-9]{6}-[0-9]{4}|[0-9]{10}|[0-9]{8}-[0-9]{4}|[0-9]{12})$`

#### Header Parameters
- **cost-org** (string) - Required - Identifier for the cost organization.

### Response
#### Success Response (200)
- **application/pdf** (binary) - The Articles of Association document in PDF format.

#### Response Example
(Binary PDF content)
```

--------------------------------

### Financial Period Object

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Defines the reporting period for financial statements, including the start and end dates.

```APIDOC
## Financial Period Object

### Description
Specifies the start and end dates for a financial reporting period.

### Object Structure

#### Properties
- **fromDate** (array of integers) - Required - The start date of the financial period, represented as [year, month, day].
- **toDate** (array of integers) - Required - The end date of the financial period, represented as [year, month, day].

### Example
```json
{
  "fromDate": [2020, 7, 1],
  "toDate": [2021, 6, 30]
}
```
```

--------------------------------

### Price Details Structure

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON object outlines the pricing details for a product or service, including currency, list price, discounts, and specific price breakdowns for different features.

```json
{
    "price": {
        "discount": "0",
        "currency": "SEK",
        "listPrice": 2,
        "details": {
            "FIND_HISTORICAL_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": null,
            "FIND_WORKPLACES": null,
            "DECISION_MAKER_BASIC": null,
            "DECISION_MAKER_EMAIL": null,
            "DECISION_MAKER_LANDLINE": null,
            "FIND_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": null,
            "WORKPLACES": null,
            "COMPANY_INFO_EMAIL": null,
            "INFORMATION_BASIC": null,
            "SIGNATORY_CHECK": null,
            "ANNUAL_FINANCIAL_REPORT": null,
            "FIND_COMPANIES": null,
            "SIGNATORY_AND_FUNCTIONAL_ROLES": null,
            "FIND_ORGANISATIONS": null,
            "COMPANY_INFO_WEBSITE": null,
            "DECISION_MAKER_MOBILE": null,
            "ON_BOARDING": {
                "hits": 1,
                "listPrice": 2
            },
            "HISTORICAL_FINANCIAL_REPORT": null,
            "HIERARCHIES": null
        },
        "discountListPrice": 2
    }
}
```

--------------------------------

### API Pricing Details Structure

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON snippet shows the pricing structure for a specific API call within the Business Insight product. It details the currency, list price, and discount applied. The 'details' object lists specific features or services associated with this pricing tier.

```json
{
    "price": {
        "discount": "0",
        "currency": "SEK",
        "listPrice": 6,
        "details": {
            "FIND_HISTORICAL_COMPANIES_USING_FUNCTIONAL_ROLE_REPRESENTATIVE": null,
            "FIND_WORKPLACES": null,
            "DECISION_MAKER_BASIC": null,
            "DECISION_MAKER_EMAIL": null,
            "DECISION_MAKER_LANDLINE": null
        }
    }
}
```

--------------------------------

### Company Cost Information

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves detailed cost information for a company, including discounts and currency.

```APIDOC
## GET /companies/{companyId}/costs

### Description
Retrieves detailed cost information for a specific company, including any applicable discounts and the currency of the costs.

### Method
GET

### Endpoint
`/companies/{companyId}/costs`

### Parameters
#### Path Parameters
- **companyId** (string) - Required - The unique identifier of the company.

#### Query Parameters
None

#### Request Body
None

### Request Example
None

### Response
#### Success Response (200)
- **cost** (object) - Details about the company's costs.
  - **cost.amount** (integer) - The monetary amount of the cost.
  - **cost.discount** (string) - The discount applied to the cost, if any.
  - **cost.currency** (string) - The currency in which the cost is denominated.
  - **cost.details** (object) - Additional details about the cost.

#### Response Example
```json
{
  "cost": {
    "amount": 36,
    "discount": "40 %",
    "currency": "SEK",
    "details": { ... } 
  }
}
```
```

--------------------------------

### GET /apis/rest/annual-reports/{orgNumber}/{endFinancialYear}

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves the Annual Financial Report in PDF format for a given organization number and financial year end.

```APIDOC
## GET /apis/rest/annual-reports/{orgNumber}/{endFinancialYear}

### Description
Retrieves the Annual Financial Report in PDF format for a given organization number and financial year end.

### Method
GET

### Endpoint
/apis/rest/annual-reports/{orgNumber}/{endFinancialYear}

### Parameters
#### Path Parameters
- **orgNumber** (string) - Required - Organization number of the company. Must match one of the following patterns: `^([0-9]{6}-[0-9]{4}|[0-9]{10}|[0-9]{8}-[0-9]{4}|[0-9]{12})$`
- **endFinancialYear** (string) - Required - The end date of the financial year for the report.

#### Header Parameters
- **cost-org** (string) - Required - Identifier for the cost organization.

### Response
#### Success Response (200)
- **application/pdf** (binary) - The Annual Financial Report document in PDF format.

#### Response Example
(Binary PDF content)
```

--------------------------------

### Company Pricing Details Structure

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Illustrates the pricing details for accessing specific company data points. It shows the list price and discount price for various services like 'HISTORICAL_FINANCIAL_REPORT'.

```json
{
    "price": {
        "discount": "0",
        "currency": "SEK",
        "listPrice": 18,
        "details": {
            "HISTORICAL_FINANCIAL_REPORT": {
                "hits": 6,
                "listPrice": 18
            }
        },
        "discountListPrice": 18
    }
}
```

--------------------------------

### Workplaces Information

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves detailed information about a company's workplaces.

```APIDOC
## Get Workplaces Information

### Description
Retrieves detailed information about the company's workplaces, including addresses and number of employees.

### Method
GET

### Endpoint
/companies/workplaces

### Parameters
#### Query Parameters
- **corporateRegistrationNumber** (string) - Required - The corporate registration number of the company.

### Request Example
```
/companies/workplaces?corporateRegistrationNumber=12345678
```

### Response
#### Success Response (200)
- **corporateRegistrationNumber** (string) - The corporate registration number.
- **companyName** (string) - The name of the company.
- **workplaces** (array) - Detailed information about the company's workplaces.
  - **cfarNumber** (string) - The CFAR number.
  - **numberOfWorkplaces** (integer) - The number of workplaces.
  - **headquarter** (boolean) - Indicates if it's a headquarters.
  - **location** (string) - The location of the workplace.
  - **phoneNumber** (string) - The phone number for the workplace.
- **headquartersLocation** (object) - The headquarters location details.
  - **address** (string) - The street address.
  - **zipCode** (string) - The zip code.
  - **city** (string) - The city.
  - **county** (string) - The county.
  - **municipality** (string) - The municipality.
- **visitingLocation** (object) - The visiting location details.
  - **address** (string) - The street address.
  - **zipCode** (string) - The zip code.
  - **city** (string) - The city.
- **phoneNumber** (string) - The main phone number of the company.

#### Response Example
```json
{
  "corporateRegistrationNumber": "12345678",
  "companyName": "Example Corp",
  "workplaces": [
    {
      "cfarNumber": "W123",
      "numberOfWorkplaces": 5,
      "headquarter": true,
      "location": "Main Office",
      "phoneNumber": "+123456789"
    },
    {
      "cfarNumber": "W456",
      "numberOfWorkplaces": 2,
      "headquarter": false,
      "location": "Branch Office",
      "phoneNumber": "+987654321"
    }
  ],
  "headquartersLocation": {
    "address": "123 Main St",
    "zipCode": "10001",
    "city": "New York",
    "county": "New York County",
    "municipality": "New York City"
  },
  "visitingLocation": {
    "address": "123 Main St",
    "zipCode": "10001",
    "city": "New York"
  },
  "phoneNumber": "+123456789"
}
```
```

--------------------------------

### GET /apis/rest/esg-reports/{orgNumber}

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieve ESG reports in PDF or JSON format for a given organization number. Requires the 'cost-org' header for authentication.

```APIDOC
## GET /apis/rest/esg-reports/{orgNumber}

### Description
Retrieve ESG reports in PDF or JSON format for a given organization number. Requires the 'cost-org' header for authentication.

### Method
GET

### Endpoint
/apis/rest/esg-reports/{orgNumber}

### Parameters
#### Path Parameters
- **orgNumber** (string) - Required - The organization number for which to retrieve ESG reports. Must follow the pattern `^([0-9]{6}-[0-9]{4}|[0-9]{10}|[0-9]{8}-[0-9]{4}|[0-9]{12})$`.

#### Header Parameters
- **cost-org** (string) - Required - The cost organization identifier.

### Response
#### Success Response (200)
- **Binary data** (string, format: binary) - ESG report in PDF format.
- **JSON data** (string) - ESG report data in JSON format.

#### Response Example
```json
{
  "example": "PDF or JSON content of ESG report"
}
```
```

--------------------------------

### POST /apis/rest/companies/getUpdates

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves a list of company data updates based on the provided criteria. This endpoint is used to get delta information for companies.

```APIDOC
## POST /apis/rest/companies/getUpdates

### Description
Retrieves a list of company data updates. This endpoint is used to get delta information for companies.

### Method
POST

### Endpoint
/apis/rest/companies/getUpdates

### Parameters
#### Header Parameters
- **cost-org** (string) - Required - Identifier for the cost organization.

#### Query Parameters
- **page** (integer) - Optional - The page number for paginated results. Defaults to 1.
- **limit** (integer) - Optional - The number of results per page. Defaults to 100000.

#### Request Body
- **RequestCompanyEvent** (object) - Required - The schema for requesting company events.

### Request Example
```json
{
  "example": "Request body for getUpdates"
}
```

### Response
#### Success Response (200)
- **PaginatedResponseCompanyEventDTO** (object) - The paginated response containing company events.

#### Response Example
```json
{
  "example": "Response body for getUpdates"
}
```
```

--------------------------------

### Company Website Information

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Retrieves the website URL for a given company.

```APIDOC
## Get Company Website Information

### Description
Retrieves the website URL and other related information for a company.

### Method
GET

### Endpoint
/companies/website

### Parameters
#### Query Parameters
- **corporateRegistrationNumber** (string) - Required - The corporate registration number of the company.

### Request Example
```
/companies/website?corporateRegistrationNumber=12345678
```

### Response
#### Success Response (200)
- **corporateRegistrationNumber** (string) - The corporate registration number.
- **companyName** (string) - The name of the company.
- **companyWebsiteURL** (string) - The website URL of the company.

#### Response Example
```json
{
  "corporateRegistrationNumber": "12345678",
  "companyName": "Example Corp",
  "companyWebsiteURL": "https://www.example.com"
}
```
```

--------------------------------

### POST /apis/rest/companies/compliance

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

Submit compliance data for a company. This endpoint requires a 'cost-org' header and optionally accepts 'customer-reference' and 'mockBgcData' headers. The request body must conform to the 'ComplianceRequest' schema.

```APIDOC
## POST /apis/rest/companies/compliance

### Description
Submit compliance data for a company. This endpoint requires a 'cost-org' header and optionally accepts 'customer-reference' and 'mockBgcData' headers. The request body must conform to the 'ComplianceRequest' schema.

### Method
POST

### Endpoint
/apis/rest/companies/compliance

### Parameters
#### Header Parameters
- **cost-org** (string) - Required - The cost organization identifier.
- **customer-reference** (string) - Optional - A reference identifier for the customer.
- **mockBgcData** (boolean) - Optional - Flag to indicate mock data for Business Group Compliance.

#### Request Body
- **ComplianceRequest** (object) - Required - The schema defining the compliance request payload.

### Request Example
```json
{
  "example": "ComplianceRequest JSON payload"
}
```

### Response
#### Success Response (200)
- **ComplianceResp** (object) - The schema defining the compliance response payload.

#### Response Example
```json
{
  "example": "ComplianceResp JSON payload"
}
```
```

--------------------------------

### Company Data Structure Example

Source: https://developerportal.enento.com/api-products/business-insight-5/5/specification_format=json

This JSON structure represents a company object, including its name, organization number, contact details, and other relevant information. It is used for retrieving and displaying company-specific data.

```json
{
            "workplaces": null,
            "company": {
                "industries": null,
                "numberOfEmployees": null,
                "lastModification": null,
                "vat": null,
                "registrationDate": null,
                "partOfHierachy": false,
                "orgNumber": "0123456789",
                "credibility": null,
                "businessNamesInTranslation": null,
                "secondaryBusinessNames": null,
                "name": {
                    "value": "SUPERTESTARNA AB"
                },
                "domicile": null,
                "representatives": null,
                "status": null,
                "signatoryText": null,
                "businessDescription": null,
                "state": null,
                "legalEntity": null,
                "numberOfWorkplaces": null,
                "tax": null,
                "turnover": null,
                "employer": null,
                "contact": {
                    "address": null,
                    "phone": null,
                    "headquarters": {
                        "county": null,
                        "address": {
                            "postal": {
                                "country": null,
                                "postTown": "MALMÖ",
                                "careOf": null,
                                "postCode": null,
                                "street": null,
                                "advertisingBlock": null
                            },
                            "visiting": null
                        },
                        "municipality": null
                    }
                }
            },
            "historicalFunctionalRoles": null,
            "historicalKeyFigures": null,
            "reports": null,
            "functionalRoles": null,
            "hierarchies": null,
            "annualFinancialReports": null,
            "keyFigures": null,
            "decisionMakers": null,
            "capitalStructure": null,
            "companyInfo": null,
            "historicalFinancialReports": null
        }
```