> ## 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 share capital history for a company

> Orders the company's share capital history from Bolagsverket: the current share capital, every registered change, authorisations and debt instruments. The answer is written into the register tables (share capital, share issues, bonus issues, reductions, authorisations, convertibles), so 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 the company's complete share capital history from the company registration office: the share capital as registered today, every registered change back to the 1990s (new issues, bonus issues, reductions, conversions and exchanges), the general meeting authorisations for the board and the issued convertibles, warrants and legacy promissory notes.

Only limited companies (aktiebolag, bankaktiebolag, försäkringsaktiebolag) have share capital; other legal forms answer `404` and nothing is ordered or charged. The history is ordered once per company: the answer is written into the register tables behind `share-capital`, `share-issue`, `bonus-issue`, `capital-reductions`, `authorizations` and `convertibles-and-warrants`, so those endpoints list the whole history afterwards, for every team. A later call returns the stored answer with `recovery.alreadyRecovered` set to `true` and orders and charges nothing. The price is set per team, with a 4 SEK default, and is returned in `teamDocumentOrder.price`.

`recovery` says what the order did to the register tables: `rowsInserted` records that were new to us, `rowsMatched` records the daily register feed had already delivered (every change carries the case it was registered in, which is how they are told apart), and `isVerified` when the changes chain from the first registered capital to the share capital registered today.

Each change carries the case (`caseNumber`, `caseYear`) it was registered in, the signed `changedAmount` and the share capital `amountAfter`, the decision (`decisionDate`, `decidedBy`), and for reductions how it was made (`methods`) and why (`purposes`), with the codes and texts as registered.


## OpenAPI

````yaml post /bolagsverket/share-capital-changes/{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/share-capital-changes/{id}:
    post:
      tags:
        - Bolagsverket
      summary: Order the share capital history for a company
      description: >-
        Orders the company's share capital history from Bolagsverket: the
        current share capital, every registered change, authorisations and debt
        instruments. The answer is written into the register tables (share
        capital, share issues, bonus issues, reductions, authorisations,
        convertibles), so 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: BolagsverketShareCapitalChanges
      parameters:
        - name: id
          in: path
          description: Internal company ID
          required: true
          schema:
            type: integer
            format: int32
      responses:
        '200':
          description: Share capital history from Bolagsverket
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_ShareCapitalChangesResponse_Dto
        '404':
          description: >-
            Company not found, not a limited company, or not registered at
            Bolagsverket
        '502':
          description: Upstream Bolagsverket service error
components:
  schemas:
    Ormeo_Web_Lens_Models_Bolagsverket_Bolagsverket_ShareCapitalChangesResponse_Dto:
      type: object
      properties:
        teamDocumentOrder:
          $ref: '#/components/schemas/Ormeo_Library_Dtos_TeamDocumentOrder_Dto'
        shareCapitalChanges:
          $ref: >-
            #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareCapitalChanges_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_Library_Dtos_Bolagsverket_ShareCapitalChanges_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
        shareCapital:
          $ref: >-
            #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareCapitalCurrent_Dto
        changes:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareCapitalChange_Dto
        authorizations:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareCapitalAuthorization_Dto
        debtInstruments:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_DebtInstrument_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_Library_Dtos_Bolagsverket_ShareCapitalCurrent_Dto:
      type: object
      properties:
        amount:
          type:
            - 'null'
            - number
          format: double
        currency:
          type:
            - 'null'
            - string
        lowerLimitAmount:
          type:
            - 'null'
            - number
          format: double
        higherLimitAmount:
          type:
            - 'null'
            - number
          format: double
        nominalValue:
          type:
            - 'null'
            - number
          format: double
        numberOfShares:
          type:
            - 'null'
            - integer
          format: int64
        numberOfSharesLowerLimit:
          type:
            - 'null'
            - integer
          format: int64
        numberOfSharesHigherLimit:
          type:
            - 'null'
            - integer
          format: int64
        shareClasses:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareClass_Dto
        hasFullyPaidIssue:
          type:
            - 'null'
            - boolean
        hasExecutedReduction:
          type:
            - 'null'
            - boolean
        note:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_ShareCapitalChange_Dto:
      type: object
      properties:
        caseNumber:
          type:
            - 'null'
            - integer
          format: int32
        caseYear:
          type:
            - 'null'
            - integer
          format: int32
        sequenceNumber:
          type:
            - 'null'
            - integer
          format: int64
        registrationDate:
          type:
            - 'null'
            - string
          format: date-time
        changeType:
          type:
            - 'null'
            - string
        typeCode:
          type:
            - 'null'
            - string
        typeText:
          type:
            - 'null'
            - string
        isBeforeConversion:
          type: boolean
        changedAmount:
          type:
            - 'null'
            - number
          format: double
        amountAfter:
          type:
            - 'null'
            - number
          format: double
        currency:
          type:
            - 'null'
            - string
        amount:
          type:
            - 'null'
            - number
          format: double
        maxAmount:
          type:
            - 'null'
            - number
          format: double
        minAmount:
          type:
            - 'null'
            - number
          format: double
        reductionAmount:
          type:
            - 'null'
            - number
          format: double
        paidIncludingPremium:
          type:
            - 'null'
            - number
          format: double
        paidAmount:
          type:
            - 'null'
            - number
          format: double
        nominalValue:
          type:
            - 'null'
            - number
          format: double
        numberOfShares:
          type:
            - 'null'
            - integer
          format: int64
        paidNumberOfShares:
          type:
            - 'null'
            - integer
          format: int64
        partPaymentShares:
          type:
            - 'null'
            - integer
          format: int64
        partPaymentAmount:
          type:
            - 'null'
            - number
          format: double
        isFullyPaid:
          type:
            - 'null'
            - boolean
        decisionDate:
          type:
            - 'null'
            - string
          format: date-time
        decidedByCode:
          type:
            - 'null'
            - string
        decidedBy:
          type:
            - 'null'
            - string
        authorizationDate:
          type:
            - 'null'
            - string
          format: date-time
        authorizationBeforeGeneralMeetingYear:
          type:
            - 'null'
            - integer
          format: int32
        authorizationBeforeDate:
          type:
            - 'null'
            - string
          format: date-time
        paymentMethods:
          type:
            - 'null'
            - array
          items:
            type: string
        methods:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/Ormeo_Library_Dtos_Bolagsverket_CodeText_Dto'
        purposes:
          type:
            - 'null'
            - array
          items:
            $ref: '#/components/schemas/Ormeo_Library_Dtos_Bolagsverket_CodeText_Dto'
        reductionPending:
          type:
            - 'null'
            - boolean
        isLapsed:
          type:
            - 'null'
            - boolean
        lapsedDecisionDate:
          type:
            - 'null'
            - string
          format: date-time
        lapsedDecidedByCode:
          type:
            - 'null'
            - string
        lapsedDecidedBy:
          type:
            - 'null'
            - string
        permitDate:
          type:
            - 'null'
            - string
          format: date-time
        permitByCode:
          type:
            - 'null'
            - string
        permitBy:
          type:
            - 'null'
            - string
        shareClasses:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareClass_Dto
        issuingCaseNumber:
          type:
            - 'null'
            - integer
          format: int32
        issuingCaseYear:
          type:
            - 'null'
            - integer
          format: int32
        note:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_ShareCapitalAuthorization_Dto:
      type: object
      properties:
        caseNumber:
          type:
            - 'null'
            - integer
          format: int32
        caseYear:
          type:
            - 'null'
            - integer
          format: int32
        sequenceNumber:
          type:
            - 'null'
            - integer
          format: int64
        registrationDate:
          type:
            - 'null'
            - string
          format: date-time
        items:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareCapitalAuthorizationItem_Dto
        note:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_DebtInstrument_Dto:
      type: object
      properties:
        caseNumber:
          type:
            - 'null'
            - integer
          format: int32
        caseYear:
          type:
            - 'null'
            - integer
          format: int32
        sequenceNumber:
          type:
            - 'null'
            - integer
          format: int64
        type:
          type:
            - 'null'
            - string
        registrationDate:
          type:
            - 'null'
            - string
          format: date-time
        decisionDate:
          type:
            - 'null'
            - string
          format: date-time
        decidedBy:
          type:
            - 'null'
            - string
        decidedAmount:
          type:
            - 'null'
            - number
          format: double
        maxAmount:
          type:
            - 'null'
            - number
          format: double
        minAmount:
          type:
            - 'null'
            - number
          format: double
        subscribedAmount:
          type:
            - 'null'
            - number
          format: double
        capitalIncreaseMaxAmount:
          type:
            - 'null'
            - number
          format: double
        currency:
          type:
            - 'null'
            - string
        changeType:
          type:
            - 'null'
            - string
        authorization:
          $ref: >-
            #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_DebtInstrumentAuthorization_Dto
        options:
          $ref: >-
            #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_DebtInstrumentOptions_Dto
        convertibles:
          $ref: >-
            #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_DebtInstrumentConvertibles_Dto
        shareClasses:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareClass_Dto
        note:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Entities_TeamDocumentContentType:
      enum:
        - pdf
        - json
        - xml
        - zip
      type: string
    Ormeo_Library_Dtos_Bolagsverket_ShareClass_Dto:
      type: object
      properties:
        name:
          type:
            - 'null'
            - string
        numberOfShares:
          type:
            - 'null'
            - number
          format: double
        lowestNumberOfShares:
          type:
            - 'null'
            - integer
          format: int64
        highestNumberOfShares:
          type:
            - 'null'
            - integer
          format: int64
        votingValue:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_CodeText_Dto:
      type: object
      properties:
        code:
          type:
            - 'null'
            - string
        text:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_ShareCapitalAuthorizationItem_Dto:
      type: object
      properties:
        type:
          type:
            - 'null'
            - string
        decisionDate:
          type:
            - 'null'
            - string
          format: date-time
        beforeGeneralMeetingYear:
          type:
            - 'null'
            - integer
          format: int32
        beforeDate:
          type:
            - 'null'
            - string
          format: date-time
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_DebtInstrumentAuthorization_Dto:
      type: object
      properties:
        decisionDate:
          type:
            - 'null'
            - string
          format: date-time
        beforeGeneralMeetingYear:
          type:
            - 'null'
            - integer
          format: int32
        beforeDate:
          type:
            - 'null'
            - string
          format: date-time
        covers:
          type:
            - 'null'
            - array
          items:
            type: string
        shareClasses:
          type:
            - 'null'
            - array
          items:
            $ref: >-
              #/components/schemas/Ormeo_Library_Dtos_Bolagsverket_ShareClass_Dto
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_DebtInstrumentOptions_Dto:
      type: object
      properties:
        amount:
          type:
            - 'null'
            - number
          format: double
        subscriptionFrom:
          type:
            - 'null'
            - string
          format: date-time
        subscriptionTo:
          type:
            - 'null'
            - string
          format: date-time
        count:
          type:
            - 'null'
            - integer
          format: int64
        lowestCount:
          type:
            - 'null'
            - integer
          format: int64
        highestCount:
          type:
            - 'null'
            - integer
          format: int64
        withoutLoan:
          type:
            - 'null'
            - boolean
        withLoan:
          type:
            - 'null'
            - boolean
        periodFrom:
          type:
            - 'null'
            - string
          format: date-time
        periodTo:
          type:
            - 'null'
            - string
          format: date-time
        historicPeriod1:
          type:
            - 'null'
            - string
        historicPeriod2:
          type:
            - 'null'
            - string
      additionalProperties: false
    Ormeo_Library_Dtos_Bolagsverket_DebtInstrumentConvertibles_Dto:
      type: object
      properties:
        amount:
          type:
            - 'null'
            - number
          format: double
        exchangeFrom:
          type:
            - 'null'
            - string
          format: date-time
        exchangeTo:
          type:
            - 'null'
            - string
          format: date-time
        historicPeriod1:
          type:
            - 'null'
            - string
        historicPeriod2:
          type:
            - 'null'
            - string
      additionalProperties: false
  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.