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

# Order the name history for a company

> Orders every earlier name of the company with its registration date from Bolagsverket and stores the names with the company, where they show under naming for everyone afterwards. The history is ordered once per company; a later call returns the stored answer without ordering or charging. Priced per team with a 4 SEK default.

Pro+ tier

Orders every earlier name of the company, each with the date the company registration office registered it, and stores the names with the company. Afterwards `GET /companies/{id}/naming` lists the whole name history, for every team, with the earlier names dated when they were registered.

The history is ordered once per company. A later call, from any team, returns the stored answer with `recovery.alreadyRecovered` set to `true`, orders nothing and charges nothing; `teamDocumentOrder` is then `null`. Companies that are not registered at the office answer `404` and nothing is ordered or charged. The price is set per team, with a 4 SEK default, and is returned in `teamDocumentOrder.price`.

`nameHistory` carries the company header (`companyRegistrationDate`, `legalForm`, `pendingCases`), `currentName` and `earlierNames`, newest first, each with `registeredDate`. `recovery` says what was stored: `rowsInserted` names that were new to us, `rowsMatched` names we already had, and `isVerified` when the oldest name dates from the company's registration and the current name agrees with ours.


## OpenAPI

````yaml post /bolagsverket/name-history/{id}
openapi: 3.1.1
info:
  title: TIC Lens API
  description: "The TIC Lens API provides programmatic access to company, person, property, vehicle, and order data.\r\n\r\n## Authentication\r\n\r\nAll requests require an API key passed via the `x-api-key` header:\r\n\r\n```bash\r\ncurl -H \"x-api-key: YOUR_API_KEY\" https://lens-api.tic.io/companies/123\r\n```\r\n\r\nAPI keys are managed through the TIC Lens web application under **Settings → API Keys**.\r\n\r\n## Base URL\r\n\r\n| Environment | URL |\r\n|-------------|-----|\r\n| Production  | `https://lens-api.tic.io` |\r\n\r\n## Feature Access\r\n\r\nEndpoints are gated by your subscription plan. If your plan does not include a feature, the endpoint will return `403 Forbidden`.\r\n\r\n## Rate Limits\r\n\r\nRate limits are applied per API key. If you exceed the limit, requests will return `429 Too Many Requests`.\r\n\r\n## Response Format\r\n\r\nAll responses are JSON. Null values are omitted from responses.\r\n"
  version: v1
servers:
  - url: https://lens-api.tic.io
security:
  - ApiKey: []
tags:
  - name: Addresses
  - name: Bolagsverket
  - name: Brf
  - name: Companies
  - name: CompanyReports
  - name: Documents
  - name: FlightImages
  - name: Free
  - name: Orders
  - name: OrdersExports
  - name: PaymentControl
  - name: PaymentControlImport
  - name: Persons
  - name: Properties
  - name: PublicSearch
  - name: Screening
  - name: SearchAutocomplete
  - name: Sentinel
  - name: ServingPermits
  - name: Team
  - name: Teams
  - name: Vehicles
  - name: WatchList
paths:
  /bolagsverket/name-history/{id}:
    post:
      tags:
        - Bolagsverket
      summary: Order the name history for a company
      description: >-
        Orders every earlier name of the company with its registration date from
        Bolagsverket and stores the names with the company, where they show
        under naming for everyone afterwards. The history is ordered once per
        company; a later call returns the stored answer without ordering or
        charging. Priced per team with a 4 SEK default.
      operationId: BolagsverketNameHistory
      parameters:
        - name: id
          in: path
          description: Internal company ID
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: Name history from Bolagsverket and what was stored
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_NameHistoryResponse_Dto
        '404':
          description: Company not found or not registered at Bolagsverket
        '502':
          description: Upstream Bolagsverket service error
components:
  schemas:
    Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_NameHistoryResponse_Dto:
      type: object
      properties:
        teamDocumentOrder:
          $ref: '#/components/schemas/Ormeo_Library_Dtos_TeamDocumentOrder_Dto'
        nameHistory:
          $ref: >-
            #/components/schemas/Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_NameHistory_Dto
        recovery:
          $ref: >-
            #/components/schemas/Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_RegisterHistoryRecovery_Dto
      additionalProperties: false
    Ormeo_Library_Dtos_TeamDocumentOrder_Dto:
      type: object
      properties:
        teamDocumentOrderId:
          type: integer
          format: int32
        teamId:
          type: integer
          format: int32
        teamName:
          type:
            - 'null'
            - string
        documentOrderGuid:
          type: string
          format: uuid
        documentTitle:
          type:
            - 'null'
            - string
        documentOrderType:
          $ref: '#/components/schemas/Ormeo_Library_Entities_TeamDocumentOrderType'
        documentOrderDate:
          type: string
          format: date-time
        orderedByUserId:
          type:
            - 'null'
            - integer
          format: int32
        orderedByUserEmail:
          type:
            - 'null'
            - string
        orderedByUserDisplayName:
          type:
            - 'null'
            - string
        price:
          type:
            - 'null'
            - number
          format: double
        lastUpdatedAtUtc:
          type: string
          format: date-time
        externalId:
          type:
            - 'null'
            - integer
          format: int32
        externalOrigin:
          $ref: '#/components/schemas/Ormeo_Library_Entities_ExternalOrigin'
        externalId2:
          type:
            - 'null'
            - string
        salesOrderRows:
          type:
            - 'null'
            - array
          items:
            type: integer
            format: int32
        content:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_TeamDocumentOrderContent_Dto
      additionalProperties: false
    Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_NameHistory_Dto:
      type: object
      properties:
        companyName:
          type:
            - 'null'
            - string
        registrationNumber:
          type:
            - 'null'
            - string
        companyRegistrationDate:
          type:
            - 'null'
            - string
          format: date-time
        legalFormCode:
          type:
            - 'null'
            - string
        legalForm:
          type:
            - 'null'
            - string
        pendingCases:
          type: integer
          format: int32
        currentName:
          $ref: >-
            #/components/schemas/Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_HistoricName_Dto
        earlierNames:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_HistoricName_Dto
      additionalProperties: false
    Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_RegisterHistoryRecovery_Dto:
      type: object
      properties:
        recoveredAtUtc:
          type:
            - 'null'
            - string
          format: date-time
        alreadyRecovered:
          type: boolean
        rowsInserted:
          type: integer
          format: int32
        rowsMatched:
          type: integer
          format: int32
        isVerified:
          type:
            - 'null'
            - boolean
        verificationNote:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Entities_TeamDocumentOrderType:
      enum:
        - companyDocument
        - lantmaterietFastighet
        - companyRegistrationLetterSwedish
        - companyRegistrationLetterEnglish
        - externalSearchActaPublica
        - externalSearchTrapets
        - personCreditCheckMail
        - companyMinutes
        - companyArticlesOfAssociation
        - companyFinancialPlan
        - companyStatutes
        - companyAnnualReportArchived
        - personCreditCheckKivra
        - bolagsverketCaseDetails
        - bolagsverketFullCaseList
        - lantmaterietOwnershipHistory
        - export
        - companyReportGoingConcern
        - companyReportAnnualReportAudit
        - propertyReport
        - personCreditCheckSms
        - bolagsverketShareCapitalChanges
        - bolagsverketNameHistory
      type: string
    Ormeo_Library_Entities_ExternalOrigin:
      enum:
        - table_Bolagsverket_Notification
        - table_Stage_CompanyPersonHistory
        - table_PRV_Trademark
        - table_System_SwedishCity
        - table_FI_Company
        - table_FI_CompanyPermit
        - table_ICA_Store
        - table_Srf_Company
        - table_FAR_Member
        - table_Bolagsverket_Document
        - table_Bolagsverket_Case
        - table_SalesOrderRow
        - table_SalesOrder
        - table_System_UserValidation
        - table_System_User
        - table_User
        - table_TeamInvitation
        - table_Sweden_CourtDocument
        - table_PRV_TrademarkImage
        - table_Bolagsverket_Order
        - table_SCB_JE
        - table_SCB_AE
        - table_Bolagsverket_BeneficialOwnerNotification
        - table_TeamWatchListTrigger
        - table_SCB_Foretagsnamn
        - table_SCB_ExpImp
        - table_SCB_AstNummer
        - table_SCB_Konskvot
        - table_Company
        - table_Larmtjanst_Object
        - table_Transportstyrelsen_Person
        - table_Forsakringskassan_Claim
        - table_FI_BorsInformationReport
        - table_Skatteverket_FA_INK
        - table_Skatteverket_FA_MOMS_AG
        - table_Skatteverket_KA_PLIGG
        - table_Skatteverket_SKT_AG
        - table_Skatteverket_SKT_INK
        - table_Skatteverket_SKT_MOMS
        - table_Skatteverket_TF_ANST
        - table_SPAR_NotificationRecord
        - table_SPAR_NotificationRecordReference
        - table_Lantmateriet_InskrivningPerson
        - table_CompanyCase
        - table_Bolagsverket_BeneficialOwner
        - table_Bolagsverket_AnnualReport
        - table_SPAR_NotificationRecordRelationship
        - table_Skatteverket_Basinformation
        - table_PersonRelationship
        - table_CompanyImport
        - table_SeaweedFSFile
        - table_Sweden_CompanyAnnualReport
        - table_CompanyFinancialReport
        - table_CompanyAddress
        - table_CompanyStatus
        - table_CompanyPerson
        - table_CompanyRegistration
        - table_CompanyIntelligence
        - table_CompanyFinancialDocument
        - table_CompanyNaming
        - table_CompanyPurpose
        - table_CompanyShareCapital
        - table_CompanyRegisteredOffice
        - table_KFM_OrderToPayCase
        - table_PersonAddress
        - table_PersonName
        - table_CompanyWorkplaceAddress
        - table_Lantmateriet_InskrivningAgandeForandring
        - table_Lantmateriet_InskrivningInteckning
        - file_Bolagsverket
        - table_KFM_DebtorSummaryEntityDebt
        - table_CompanyWorkplaceCompany
        - table_CompanyDocument
        - table_FileImport
        - table_CompanyFinancialReportRegistration
        - table_Folkhalsomyndigheten_ServingPermit
        - table_CompanyFinancialReportFile
        - table_TeamCompanyDocument
        - table_Bolagsverket_RepresentativeHistory
        - table_CompanyPersonTemp
        - table_Lansstyrelsen_Decision
        - table_Kammarkollegiet_Sanktionsavgift
        - table_CompanyFinancialReportSummary
        - table_Lantmateriet_InskrivningAnteckning
        - table_Property
        - table_SwishRequest
        - external_Lantmateriet_RegisterenhetObjektIdentitet
        - table_SwishRefundResponse
        - table_LEI_Order
        - table_Bankgirot_Bankgironumber
        - table_Person
        - external_Navet
        - table_Transportstyrelsen_VehicleSummaryEvent
        - external_Bolagsverket_Case
        - table_Ria_AgentLocation
        - table_PropertyAnnualReportFile
        - table_CompanyRegisterHistory
      type: string
    Ormeo_Library_Dtos_TeamDocumentOrderContent_Dto:
      type: object
      properties:
        teamDocumentOrderContentId:
          type: integer
          format: int32
        teamDocumentOrderId:
          type: integer
          format: int32
        teamDocumentContentType:
          $ref: '#/components/schemas/Ormeo_Library_Entities_TeamDocumentContentType'
      additionalProperties: false
    Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_HistoricName_Dto:
      type: object
      properties:
        name:
          type:
            - 'null'
            - string
        registeredDate:
          type:
            - 'null'
            - string
          format: date-time
      additionalProperties: false
    Ormeo_Library_Entities_TeamDocumentContentType:
      enum:
        - pdf
        - json
        - xml
        - zip
      type: string
  securitySchemes:
    ApiKey:
      type: apiKey
      name: x-api-key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.