eyJ4NXQiOiJPV1l4TkRJd016ZGhPREk1WVdRNU1EZGxPREkzT1RZeU1qTXpZemN4TW1NMU0yRTFaREF5WXpGa01qQmpNV0ZrTkROa1pXVTFPRFk1T1dJMlpHRTBZZyIsImtpZCI6ImdhdGV3YXlfY2VydGlmaWNhdGVfYWxpYXMiLCJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJzdWIiOiJQRVJTT05BTFwvV1NPMl9NU19zaWduYXRvcnlAY2FyYm9uLnN1cGVyIiwiYXBwbGljYXRpb24iOnsib3duZXIiOiJQRVJTT05BTFwvV1NPMl9NU19zaWduYXRvcnkiLCJ0aWVyUXVvdGFUeXBlIjpudWxsLCJ0aWVyIjoiVW5saW1pdGVkIiwibmFtZSI6IkRlZmF1bHRBcHBsaWNhdGlvbiIsImlkIjoyNSwidXVpZCI6ImYwZDU4MTc3LWVlNzctNDNjOC1iNDM0LTBmNDQyOTBkMWU5ZiJ9LCJpc3MiOiJodHRwczpcL1wvYXBpLWltLXRlc3Quc3VuZHN2YWxsLnNlOjQ0M1wvb2F1dGgyXC90b2tlbiIsInRpZXJJbmZvIjp7IkJyb256ZSI6eyJ0aWVyUXVvdGFUeXBlIjoicmVxdWVzdENvdW50IiwiZ3JhcGhRTE1heENvbXBsZXhpdHkiOjAsImdyYXBoUUxNYXhEZXB0aCI6MCwic3RvcE9uUXVvdGFSZWFjaCI6dHJ1ZSwic3Bpa2VBcnJlc3RMaW1pdCI6MCwic3Bpa2VBcnJlc3RVbml0IjpudWxsfSwiVW5saW1pdGVkIjp7InRpZXJRdW90YVR5cGUiOiJyZXF1ZXN0Q291bnQiLCJncmFwaFFMTWF4Q29tcGxleGl0eSI6MCwiZ3JhcGhRTE1heERlcHRoIjowLCJzdG9wT25RdW90YVJlYWNoIjp0cnVlLCJzcGlrZUFycmVzdExpbWl0IjowLCJzcGlrZUFycmVzdFVuaXQiOm51bGx9fSwia2V5dHlwZSI6IlNBTkRCT1giLCJwZXJtaXR0ZWRSZWZlcmVyIjoiIiwic3Vic2NyaWJlZEFQSXMiOlt7InN1YnNjcmliZXJUZW5hbnREb21haW4iOiJjYXJib24uc3VwZXIiLCJuYW1lIjoiQnVzaW5lc3NFbmdhZ2VtZW50cyIsImNvbnRleHQiOiJcL2J1c2luZXNzZW5nYWdlbWVudHNcLzEuMCIsInB1Ymxpc2hlciI6IlBFUlNPTkFMXC9tYXIxNGhhbiIsInZlcnNpb24iOiIxLjAiLCJzdWJzY3JpcHRpb25UaWVyIjoiQnJvbnplIn0seyJzdWJzY3JpYmVyVGVuYW50RG9tYWluIjoiY2FyYm9uLnN1cGVyIiwibmFtZSI6IkNpdGl6ZW5NYXBwaW5nIiwiY29udGV4dCI6IlwvY2l0aXplbm1hcHBpbmdcLzEuMCIsInB1Ymxpc2hlciI6IlBFUlNPTkFMXC9qb2UxNGxpbiIsInZlcnNpb24iOiIxLjAiLCJzdWJzY3JpcHRpb25UaWVyIjoiVW5saW1pdGVkIn0seyJzdWJzY3JpYmVyVGVuYW50RG9tYWluIjoiY2FyYm9uLnN1cGVyIiwibmFtZSI6IkxlZ2FsRW50aXR5IiwiY29udGV4dCI6IlwvbGVnYWxlbnRpdHlcLzEuMCIsInB1Ymxpc2hlciI6IlBFUlNPTkFMXC9qb2UxNGxpbiIsInZlcnNpb24iOiIxLjAiLCJzdWJzY3JpcHRpb25UaWVyIjoiVW5saW1pdGVkIn1dLCJwZXJtaXR0ZWRJUCI6IiIsImlhdCI6MTY2MDcyMDE3NiwianRpIjoiM2Q3ZDYxZTgtMzY3YS00YTgwLWJjNDItM2M5N2Y5MjQzNjVkIn0=.rOzKm1CCSVC8PYy5Rb1hOOkDWtNgxMOrBnXUPo1g1u2k8yAoAzPHjskzbXgUdllXFNiJSnDTYg4imGnUv_4o6OF4yoCALLD31OxbmSkosYLnZ-hnVZToZ42mnouIuwsmaTTnuEZSa3GB3eL3K9k5NnjZu-hw_jvAN10cekvYp5JLMDUNI6STPMEtMCXo_jiB-UYbisgUh-2JWSBGgciE_wnakaMFUZKpamHpdHw93B415RzXR5dUJTebVKvafo8oASgO5MElYdBVBretrdmZXipaLYL5b7xObmqokx1MmqhFA_7iyvuLH9csjdYQTrZjG1vmj5LV4pGUDTXofYaC-A==

openapi: 3.0.1
info:
  title: api-businessengagements
  contact: {}
  license:
    name: MIT License
    url: https://opensource.org/licenses/MIT
  version: "1.01"
servers:
- url: https://api-test.sundsvall.se/businessengagements/1.01/
tags:
- name: Business Engagements
  description: En tjänst som hämtar en persons företagsengagemang och dess information
paths:
  /engagementsinformation/{partyId}:
    get:
      tags:
      - Business Engagements
      operationId: getEngagementsgetBusinessInformation
      parameters:
      - name: partyId
        in: path
        requireddescription: trueUnique identifier for an organization number
   schema:     required: true
    type: string   schema:
          type: string
          description: Unique identifier for aan organization personnumber
          example: 6a5c3d04-412d-11ec-973a-0242ac130003fb2f0290-3820-11ed-a261-0242ac120002
        example: fb2f0290-3820-11ed-a261-0242ac120002
      - name: personalNameorganizationName
        in: query
        description: Name of the organization
        required: true
        schema:
          type: string
          description: The first and surnameName of the personorganization
      - nameresponses:
serviceName        "204":
in: query         requireddescription: trueNo Content
       schema:   content:
       type: string    '*/*':
      description: Name of the system initiating the request schema:
         example: Mina Sidor     $ref:  responses:'#/components/schemas/BusinessInformation'
         "200400":
          description: SuccessfulBad OperationRequest
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/BusinessEngagementsResponseProblem'
        "204404":
          description: NoNot ContentFound
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/BusinessEngagementsResponseProblem'
        "404200":
          description: NotSuccessful FoundOperation
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/ProblemBusinessInformation'
        "400500":
          description: BadInternal Server RequestError
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/Problem'
  /engagements/{partyId}:
    get:
"500":      tags:
    description: Internal Server- ErrorBusiness Engagements
      operationId: getEngagements
 content:     parameters:
      - '*/*'name: partyId
        in: path
   schema:     description: Unique identifier for a person
      $ref  required: '#/components/schemas/Problem'true
   /api-docs:     getschema:
      tags:    type: string
  - API       summarydescription: OpenAPIUnique identifier for a person
  operationId: getApiDocs       responsesexample: 6a5c3d04-412d-11ec-973a-0242ac130003
       "200" example: 6a5c3d04-412d-11ec-973a-0242ac130003
      -   descriptionname: OKpersonalName
          contentin: query
        description: The  application/yaml:
 first and surname of the person
        required: true
  schema:      schema:
          type: string
      x-auth-type: None   description: The first  x-throttling-tier: Unlimited
 and surname of the person
    x-wso2-mutual-ssl: Optional security:
  - ApiKeyAuthname: []serviceName
components:   schemas:     BusinessEngagementsResponsein: query
     required:   description: Name of the -system statusinitiating the request
    type: object   required: true
  properties:         engagementsschema:
          type: arraystring
          itemsdescription: Name of the system initiating the request
      $ref: '#/components/schemas/Engagement'   example: Mina Sidor
   statusDescriptions:     example: Mina Sidor
   type: object  responses:
        additionalProperties"200":
          description: Successful type:Operation
string          content:
  description: "In case fetching one or more engagement failed, this will\ '*/*':
              \schema:
show why it failed. There may be more than one description if several\    $ref: '#/components/schemas/BusinessEngagementsResponse'
         \ engagements failed.""204":
          description: No example: TimeoutContent
          descriptioncontent:
"In case fetching one or more engagement failed, this will\    '*/*':
          \ show why it failed. There may be more than one description if several\    schema:
                $ref: '#/components/schemas/BusinessEngagementsResponse'
      \ engagements failed."400":
          exampledescription: TimeoutBad Request
          statuscontent:
            type'*/*':
 string             descriptionschema:
If fetching all engagements went "OK" or "NOK". A "NOK" may      $ref: '#/components/schemas/Problem'
     still return engagements but"404":
indicates that the information is incomplete.     description: Not Found
   example: OK      content:
    enum:        '*/*':
  - OK           -schema:
NOK     Engagement:       type: object   $ref: '#/components/schemas/Problem'
  properties:         organizationName"500":
          typedescription: stringInternal Server Error
        description: Name ofcontent:
the organization           example'*/*':
Styrbjörns båtar         organizationNumber:    schema:
      type: string           description$ref: "Organization number, may also be personal number in case of\'#/components/schemas/Problem'
  /api-docs:
    get:
      tags:
      \- enskildAPI
firma"      summary: OpenAPI
   example:  "2021005448" operationId: getApiDocs
      organizationIdresponses:
          type"200":
string           description: UniqueOK
id for the organization (UUID)      content:
    example: bab17d8b-af38-4531-967c-083f15ca1571       descriptionapplication/yaml:
Represents a persons business engagement.     Problem:       typeschema:
object       properties:         instancetype: string
         x-auth-type: stringNone
        x-throttling-tier: Unlimited
 format: uri    x-wso2-mutual-ssl: Optional
components:
  typeschemas:
    Problem:
      type: stringobject
          formatproperties:
uri         parametersinstance:
          type: objectstring
          additionalPropertiesformat:    uri
        type:
object          statustype: string
         $ref format: '#/components/schemas/StatusType'uri
        titleparameters:
          type: stringobject
          detailadditionalProperties:
            type: stringobject
    StatusType:    title:
  type: object       propertiestype: string
       statusCode detail:
          type: integerstring
        status:
 format: int32         reasonPhrase:$ref: '#/components/schemas/StatusType'
    StatusType:
      type: stringobject
      securitySchemesproperties:
       ApiKeyAuth reasonPhrase:
          type: apiKeystring
        instatusCode:
 header         nametype: apikey

John Doe
      description: Address model
    BusinessInformation:
      type: object
      properties:
        legalForm:
          $ref: '#/components/schemas/LegalForm'
        address:
          $ref: '#/components/schemas/Address'
        emailAddress:
          type: string
          description: The companys contact email
          example: somecompany@noreply.com
        phoneNumber:
          type: string
          description: The companys contact phone number
          example: 070-1234567
        municipality:
          $ref: '#/components/schemas/Municipality'
        county:
          $ref: '#/components/schemas/County'
        fiscalYear:
          $ref: '#/components/schemas/FiscalYear'
        companyForm:
          $ref: '#/components/schemas/CompanyForm'
        companyRegistrationTime:
          type: string
          description: When the company was registered
          format: date
          example: 2022-01-01
        liquidationInformation:
          $ref: '#/components/schemas/LiquidationInformation'
        deregistrationDate:
          type: string
          description: When and if the company was deregistered
          format: date
          example: 2022-09-01
        companyLocation:
          $ref: '#/components/schemas/Address'
        businessSignatory:
          type: string
          description: Who may sign for the company
          example: Firman tecknas av styrelsen
        companyDescription:
          type: string
          description: Information regarding the companys operations
          example: Psykologisk forskning på bin samt därmed förenlig verksamhet.
        sharesInformation:
          $ref: '#/components/schemas/SharesInformation'
        errorInformation:
          $ref: '#/components/schemas/ErrorInformation'
      description: Business information model
    CompanyForm:
      type: object
      properties:
        companyFormCode:
          type: string
          description: Company form
          example: AB
        companyFormDescription:
          type: string
          description: Company form description
          example: Aktiebolag
      description: Company form information model
    County:
      type: object
      properties:
        countyName:
          type: string
          description: County
          example: Västernorrland
        countyCode:
          type: string
          description: County code
          example: "22"
      description: County information model
    ErrorInformation:
      type: object
      properties:
        hasErrors:
          type: boolean
          description: Indicates if there was an error while fetching data and that
            one or more parameters could not be fetched
          example: true
        errorDescriptions:
          type: object
          additionalProperties:
            type: string
            description: Map with error code (from bolagsverket) as key and the error
              description as value
            example: "9071006, Ej behörig - ej firmatecknare."
          description: Map with error code (from bolagsverket) as key and the error
            description as value
          example: "9071006, Ej behörig - ej firmatecknare."
      description: Error information model
    FiscalYear:
      type: object
      properties:
        fromDay:
          type: integer
          description: Fiscal year start day
          format: int32
          example: 1
        fromMonth:
          type: integer
          description: Fiscal year start month
          format: int32
          example: 1
        toDay:
          type: integer
          description: Fiscal year end day
          format: int32
          example: 31
        toMonth:
          type: integer
          description: Fiscal year end month
          format: int32
          example: 12
      description: Fiscal year information model
    LegalForm:
      type: object
      properties:
        legalFormDescription:
          type: string
          description: Legal form
          example: Övriga aktiebolag
        legalFormCode:
          type: string
          description: Legal form code
          example: "49"
      description: Legal form information model
    LiquidationInformation:
      type: object
      properties:
        liquidationReasons:
          type: array
          items:
            $ref: '#/components/schemas/LiquidationReason'
        cancelledLiquidation:
          $ref: '#/components/schemas/LiquidationReason'
      description: Liquidation information model
    LiquidationReason:
      type: object
      properties:
        liquidationCode:
          type: string
          description: Liquidation code
          example: "21"
        liquidationDescription:
          type: string
          description: Liquidation description
          example: Konkurs avslutad
        liquidationDate:
          type: string
          description: Liquidation date
          format: date
          example: 2022-09-01
        liquidationType:
          type: string
          description: Type of liquidation
          example: Konkurs
      description: Reason for liquidation or cancellation of liquidation
    Municipality:
      type: object
      properties:
        municipalityName:
          type: string
          description: Municipality
          example: Sundsvalls Kommun
        municipalityCode:
          type: string
          description: Municipality code
          example: "2281"
      description: Municipality information model
    ShareType:
      type: object
      properties:
        label:
          type: string
          description: Label of the shares
          example: B
        numberOfShares:
          type: integer
          description: Number of shares of this class
          example: 25000
        voteValue:
          type: string
          description: The vote value for one share
          example: 1/10
      description: Share information model
    SharesInformation:
      type: object
      properties:
        shareTypes:
          type: array
          items:
            $ref: '#/components/schemas/ShareType'
        numberOfShares:
          type: integer
          description: Number of total shares
          example: 100000
        shareCapital:
          type: number
          description: Shares value
          example: 120000.0
        shareCurrency:
          type: string
          description: Shares value currency
          example: sek
      description: Shares information model
    BusinessEngagementsResponse:
      required:
      - status
      type: object
      properties:
        engagements:
          type: array
          items:
            $ref: '#/components/schemas/Engagement'
        statusDescriptions:
          type: object
          additionalProperties:
            type: string
            description: "In case fetching one or more engagement failed, this will\
              \ show why it failed. There may be more than one description if several\
              \ engagements failed."
            example: Timeout
          description: "In case fetching one or more engagement failed, this will\
            \ show why it failed. There may be more than one description if several\
            \ engagements failed."
          example: Timeout
        status:
          type: string
          description: If fetching all engagements went "OK" or "NOK". A "NOK" may
            still return engagements but indicates that the information is incomplete.
          example: OK
          enum:
          - OK
          - NOK
    Engagement:
      type: object
      properties:
        organizationName:
          type: string
          description: Name of the organization
          example: Styrbjörns båtar
        organizationNumber:
          type: string
          description: "Organization number, may also be personal number in case of\
            \ enskild firma"
          example: "2021005448"
        organizationId:
          type: string
          description: Unique id for the organization (UUID)
          example: bab17d8b-af38-4531-967c-083f15ca1571
      description: Represents a persons business engagement.
  securitySchemes: {}