Sikoia Companies & People API

openapi: 3.2.0
info:
  title: Sikoia Adverse Media Companies & People API
  termsOfService: https://sikoia.com/About/Terms
  version: '1.0'
servers:
- url: https://api.sikoia.com
  description: API (Production)
- url: https://oauth2.sikoia.com
  description: Authorization Server (Production)
- url: https://api-staging.sikoia.com
  description: API (Staging)
- url: https://oauth2-staging.sikoia.com
  description: Authorization Server (Staging)
security:
- authorizationHeader: []
- apiKeyHeader: []
tags:
- name: Companies & People
paths:
  /v2/cases/{case_id}/entities:
    post:
      tags:
      - Companies & People
      summary: Add entities to a case
      description: '### Adds companies and / or people to an existing case.


        This endpoint behaves the same as the Create Case endpoint when adding companies and / or people.


        When adding companies, you can retrieve company registration data by setting `registry_search` to `true`, and ensuring that `company_name`, `company_number`, and `jurisdiction_code` are not empty. If the data cannot be found, the case is created with the provided company details. If the company registration data is found, the `status`, `number_of_officers`, and `number_of_owners` are updated to reflect the registry data.


        Additionally, you can choose to add all the company''s (human) officers to the case by setting `add_directors` to `true`. Note that this flag is applicable only when `registry_search` is set to `true`.

        '
      operationId: POST_v2-cases-case_id-entities
      parameters:
      - name: case_id
        in: path
        description: Sikoia ID for the case
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.AddEntitiesToCaseRequest'
            example:
              companies:
              - company_name: Acme Limited
                company_number: '77642080'
                jurisdiction_code: GB
                registry_search: true
                add_directors: true
              persons:
              - first_name: Wilson
                last_name: Pascale
                email: wislon@acme.ltd.uk
                postal_address:
                  house_number: '123'
                  building_name: Main House
                  sub_building_name: string
                  address_line_1: Main Street
                  address_line_2: Apt.101
                  locality: Test County
                  city: Test Town
                  post_code: X9 9AA
                  country: GB
                date_of_birth: '1985-06-12'
                employer: Acme Limited
                is_officer: true
                reference_person_id: Wilson5432
      responses:
        '201':
          description: Case with New Entities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Responses.CaseResponse'
              example:
                case_id: 64cd8202-2db4-44d5-85be-79438d65eb7b
                name: Acme Ltd Loan Application
                case_type: Business
                stage: New
                datetime_created: '2023-02-10T10:59:46.0260000+00:00'
                datetime_last_modified: '2023-02-12T13:04:21.3260000+00:00'
                reference: LOAN03584
                reference_customer_id: CUST67044
                reference_customer_name: Building Society Ltd
                description: Acme Ltd looking to borrow money to fund a new fleet of delivery vehicles.
                source: API
                owner: Cecilia Adams
                ownership:
                - owner_id: 6a9f8d73-29f4-4a6a-80dc-21b8cbecff75
                  owner_type: user
                number_of_companies: '2'
                number_of_persons: '5'
                companies:
                - company_id: a035d37a-dee1-4a4e-b098-168a6a1f4603
                  company_name: Acme Limited
                  company_number: '77642080'
                  jurisdiction_code: GB
                  status: Active
                  number_of_officers: '5'
                  number_of_owners: '2'
                  media_adverse_requested: true
                  pep_sanction_requested: true
                persons:
                - person_id: 8303ce21-3120-4981-9a19-560ef110502b
                  first_name: Wilson
                  last_name: Pascale
                  name: Wilson Pascale
                  email: wislon@acme.ltd.uk
                  postal_address:
                    house_number: '123'
                    building_name: Main House
                    sub_building_name: string
                    address_line_1: Main Street
                    address_line_2: Apt. 101
                    locality: Test Country
                    city: Test Town
                    post_code: X9 9AA
                    country: GB
                    summary_line: 123, Main Street, Main House, Apt. 101, Test County, Test Town, X9 9AA, GB
                  date_of_birth: '1985-06-12'
                  employer: Acme Limited
                  is_officer: true
                  appointments: string
                  reference_person_id: Wilson5432
                  media_adverse_requested: true
                  pep_sanction_requested: true
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: InvalidRequest
                status: 400
                title: Validation Errors
                detail: Entity Id is required.
                correlation_id: 12ae3d33-4fd1-4641-8e3c-a03ad1b5c42b
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: InvalidToken
                status: 401
                title: Invalid Token
                detail: Invalid token
                correlation_id: 70657df9-f195-4800-bda3-a6c75f045e4d
        '404':
          description: Case Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: ResourceNotFound
                status: 404
                title: Resource Not Found
                detail: No resources found with id d7734fe3-71a7-4bce-a852-ca4bc24268ff.
                correlation_id: aa068a8a-47d8-4a41-8fcb-fbbbbb2b947c
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: RateLimit
                status: 429
                title: Too Many Requests
                detail: You've exceeded the maximum API request limit per minute. Please try again later.
                correlation_id: f5dc01bb-e320-4cdc-a993-56e34981453f
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: ServerError
                status: 500
                title: Internal Server Error
                detail: Something has gone wrong, please try again
                correlation_id: 10ac4d01-4dd8-4935-8cb1-953a3e4706be
    patch:
      tags:
      - Companies & People
      summary: Update entities in a case
      description: '### Updates existing companies and / or people in a case.


        All fields are optional, except for `company_id` or `person_id`; however, the request must include at least one field.


        To clear a field, simply send an empty string as the field value.

        '
      operationId: PATCH_v2-cases-case_id-entities
      parameters:
      - name: case_id
        in: path
        description: Sikoia ID for the case
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.UpdateCaseEntitiesRequest'
            example:
              companies:
              - company_id: a035d37a-dee1-4a4e-b098-168a6a1f4603
                company_name: Acme Limited
                company_number: '77642080'
                jurisdiction_code: GB
              persons:
              - person_id: 8303ce21-3120-4981-9a19-560ef110502b
                first_name: Wilson
                last_name: Pascale
                email: wislon@acme.ltd.uk
                postal_address:
                  house_number: '123'
                  building_name: Main House
                  sub_building_name: string
                  address_line_1: Main Street
                  address_line_2: Apt.101
                  locality: Test County
                  city: Test Town
                  post_code: X9 9AA
                  country: GB
                date_of_birth: '1985-06-12'
                employer: Acme Limited
                reference_person_id: Wilson5432
      responses:
        '201':
          description: Case with Updated Entities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Responses.CaseResponse'
              example:
                case_id: 64cd8202-2db4-44d5-85be-79438d65eb7b
                name: Acme Ltd Loan Application
                case_type: Business
                stage: New
                datetime_created: '2023-02-10T10:59:46.0260000+00:00'
                datetime_last_modified: '2023-02-12T13:04:21.3260000+00:00'
                reference: LOAN03584
                reference_customer_id: CUST67044
                reference_customer_name: Building Society Ltd
                description: Acme Ltd looking to borrow money to fund a new fleet of delivery vehicles.
                source: API
                owner: Cecilia Adams
                ownership:
                - owner_id: 6a9f8d73-29f4-4a6a-80dc-21b8cbecff75
                  owner_type: user
                number_of_companies: '2'
                number_of_persons: '5'
                companies:
                - company_id: a035d37a-dee1-4a4e-b098-168a6a1f4603
                  company_name: Acme Limited
                  company_number: '77642080'
                  jurisdiction_code: GB
                  status: Active
                  number_of_officers: '5'
                  number_of_owners: '2'
                  media_adverse_requested: true
                  pep_sanction_requested: true
                persons:
                - person_id: 8303ce21-3120-4981-9a19-560ef110502b
                  first_name: Wilson
                  last_name: Pascale
                  name: Wilson Pascale
                  email: wislon@acme.ltd.uk
                  postal_address:
                    house_number: '123'
                    building_name: Main House
                    sub_building_name: string
                    address_line_1: Main Street
                    address_line_2: Apt. 101
                    locality: Test Country
                    city: Test Town
                    post_code: X9 9AA
                    country: GB
                    summary_line: 123, Main Street, Main House, Apt. 101, Test County, Test Town, X9 9AA, GB
                  date_of_birth: '1985-06-12'
                  employer: Acme Limited
                  is_officer: true
                  appointments: string
                  reference_person_id: Wilson5432
                  media_adverse_requested: true
                  pep_sanction_requested: true
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: InvalidRequest
                status: 400
                title: Validation Errors
                detail: Entity Id is required.
                correlation_id: 8798afca-4df6-44dc-9633-e62cab611697
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: InvalidToken
                status: 401
                title: Invalid Token
                detail: Invalid token
                correlation_id: 6147d230-72bb-41c1-8e0e-d7bc6ca93700
        '404':
          description: Case Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: ResourceNotFound
                status: 404
                title: Resource Not Found
                detail: No resources found with id 91b32550-0b6c-415b-9451-2e0a09e13f1a.
                correlation_id: 551a5561-1c8a-4f83-88de-3726c315b932
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: RateLimit
                status: 429
                title: Too Many Requests
                detail: You've exceeded the maximum API request limit per minute. Please try again later.
                correlation_id: 47c2726c-23bf-4a8f-963f-0666604689ab
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: ServerError
                status: 500
                title: Internal Server Error
                detail: Something has gone wrong, please try again
                correlation_id: cad08426-bf63-446c-84f1-24cac1af8a70
  /v2/cases/{case_id}/entities/delete:
    post:
      tags:
      - Companies & People
      summary: Delete entities in a case
      description: '### Deletes companies and / or people from a case.


        Accepts a list of person and / or company IDs to delete from the case.


        Please note that this action cannot be undone.

        '
      operationId: POST_v2-cases-case_id-entities-delete
      parameters:
      - name: case_id
        in: path
        description: Sikoia ID for the case
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.DeleteCaseEntityRequest'
            example:
              companies: '["ddf1d8ef-2cca-41ef-89c1-00fb0c05c54f"]'
              persons: '["c28c88d6-7fb5-4c2f-a5a1-559cd2675293"]'
      responses:
        '200':
          description: Case with Deleted Entities
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Responses.CaseResponse'
              example:
                case_id: 64cd8202-2db4-44d5-85be-79438d65eb7b
                name: Acme Ltd Loan Application
                case_type: Business
                stage: New
                datetime_created: '2023-02-10T10:59:46.0260000+00:00'
                datetime_last_modified: '2023-02-12T13:04:21.3260000+00:00'
                reference: LOAN03584
                reference_customer_id: CUST67044
                reference_customer_name: Building Society Ltd
                description: Acme Ltd looking to borrow money to fund a new fleet of delivery vehicles.
                source: API
                owner: Cecilia Adams
                ownership:
                - owner_id: 6a9f8d73-29f4-4a6a-80dc-21b8cbecff75
                  owner_type: user
                number_of_companies: '2'
                number_of_persons: '5'
                companies:
                - company_id: a035d37a-dee1-4a4e-b098-168a6a1f4603
                  company_name: Acme Limited
                  company_number: '77642080'
                  jurisdiction_code: GB
                  status: Active
                  number_of_officers: '5'
                  number_of_owners: '2'
                  media_adverse_requested: true
                  pep_sanction_requested: true
                persons:
                - person_id: 8303ce21-3120-4981-9a19-560ef110502b
                  first_name: Wilson
                  last_name: Pascale
                  name: Wilson Pascale
                  email: wislon@acme.ltd.uk
                  postal_address:
                    house_number: '123'
                    building_name: Main House
                    sub_building_name: string
                    address_line_1: Main Street
                    address_line_2: Apt. 101
                    locality: Test Country
                    city: Test Town
                    post_code: X9 9AA
                    country: GB
                    summary_line: 123, Main Street, Main House, Apt. 101, Test County, Test Town, X9 9AA, GB
                  date_of_birth: '1985-06-12'
                  employer: Acme Limited
                  is_officer: true
                  appointments: string
                  reference_person_id: Wilson5432
                  media_adverse_requested: true
                  pep_sanction_requested: true
        '400':
          description: Invalid Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: InvalidRequest
                status: 400
                title: Validation Errors
                detail: Entity Id is required.
                correlation_id: 77429fb5-9be7-40d7-b689-459cd9600861
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: InvalidToken
                status: 401
                title: Invalid Token
                detail: Invalid token
                correlation_id: 5a6cb4f7-1ef9-40d4-9307-961ad146b764
        '404':
          description: Case Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: ResourceNotFound
                status: 404
                title: Resource Not Found
                detail: No resources found with id 1f84f8ca-b1d1-4fe4-9729-b56c6f47e7f4.
                correlation_id: cdb6963a-754f-4716-8aba-2c05032bd48e
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: RateLimit
                status: 429
                title: Too Many Requests
                detail: You've exceeded the maximum API request limit per minute. Please try again later.
                correlation_id: 231373e9-557b-40c2-9c3a-5bc07e654d8f
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SikoiaCore.Common.SikoiaErrorResponse'
              example:
                type: ServerError
                status: 500
                title: Internal Server Error
                detail: Something has gone wrong, please try again
                correlation_id: 2374085c-c9e0-4afa-97f0-1d428ba480a7
components:
  schemas:
    SikoiaSharedModels.CaseManagement.Responses.PostalAddressResponseModel:
      title: Address
      type: object
      properties:
        house_number:
          type:
          - string
          - 'null'
          description: The building or house number
          example: '123'
        building_name:
          type:
          - string
          - 'null'
          description: The building or house name
          example: Main House
        sub_building_name:
          type:
          - string
          - 'null'
          description: The name of the sub-building
        address_line_1:
          type:
          - string
          - 'null'
          description: The first line of the postal address, typically used for the street address.
          example: Main Street
        address_line_2:
          type:
          - string
          - 'null'
          description: The second line of the postal address, typically used for additional information such as apartment or suite number.
          example: Apt. 101
        locality:
          type:
          - string
          - 'null'
          description: The locality of the postal address.
          example: Test Country
        city:
          type:
          - string
          - 'null'
          description: The city of the postal address.
          example: Test Town
        post_code:
          type:
          - string
          - 'null'
          description: The post code for the address. This is sometimes also referred to as postal code, ZIP code, Postal Index Number, or Eircode.
          example: X9 9AA
        country:
          type:
          - string
          - 'null'
          description: Two letter ISO country code
          example: GB
        summary_line:
          type:
          - string
          - 'null'
          example: 123, Main Street, Main House, Apt. 101, Test County, Test Town, X9 9AA, GB
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Requests.AddEntitiesToCaseRequest:
      title: Add Entities
      type: object
      properties:
        companies:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.Models.CaseCompanyRecord'
          description: List of companies to add
        persons:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.Models.CasePersonRecord'
          description: List of people to add
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Requests.Models.PostalAddressRequestModel:
      title: Address
      type: object
      properties:
        house_number:
          type:
          - string
          - 'null'
          description: The building or house number
          example: '123'
        building_name:
          type:
          - string
          - 'null'
          description: The building or house name
          example: Main House
        sub_building_name:
          type:
          - string
          - 'null'
          description: The name of the sub-building
        address_line_1:
          type:
          - string
          - 'null'
          description: The first line of the postal address, typically used for the street address
          example: Main Street
        address_line_2:
          type:
          - string
          - 'null'
          description: The second line of the postal address, typically used for additional information such as apartment or suite number
          example: Apt.101
        locality:
          type:
          - string
          - 'null'
          description: The locality of the postal address
          example: Test County
        city:
          type:
          - string
          - 'null'
          description: The city of the postal address
          example: Test Town
        post_code:
          type:
          - string
          - 'null'
          description: The post code for the address. This is sometimes also referred to as postal code, ZIP code, Postal Index Number, or Eircode.
          example: X9 9AA
        country:
          type:
          - string
          - 'null'
          description: Two letter ISO country code
          example: GB
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Responses.PersonRecordResponseModel:
      title: Person
      type: object
      properties:
        person_id:
          type:
          - string
          - 'null'
          description: Sikoia ID for the person
          format: uuid
          readOnly: true
          example: 8303ce21-3120-4981-9a19-560ef110502b
        first_name:
          type:
          - string
          - 'null'
          description: The person's first name
          example: Wilson
        last_name:
          type:
          - string
          - 'null'
          description: The person's last name
          example: Pascale
        name:
          type:
          - string
          - 'null'
          description: The person's full name
          readOnly: true
          example: Wilson Pascale
        email:
          type:
          - string
          - 'null'
          description: The person's email address
          format: email
          example: wislon@acme.ltd.uk
        postal_address:
          $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Responses.PostalAddressResponseModel'
        date_of_birth:
          type:
          - string
          - 'null'
          description: The person's date of birth
          format: date
          example: '1985-06-12'
        employer:
          type:
          - string
          - 'null'
          description: The name of the person's employer
          example: Acme Limited
        is_officer:
          type: boolean
          description: Whether the person is an officer of their employer
          readOnly: true
        appointments:
          type:
          - string
          - 'null'
        reference_person_id:
          type:
          - string
          - 'null'
          description: Your external reference for the ID of the person/applicant in the case
          example: Wilson5432
        media_adverse_requested:
          type: boolean
          deprecated: true
        pep_sanction_requested:
          type: boolean
          deprecated: true
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Requests.DeleteCaseEntityRequest:
      title: Delete Entities
      type: object
      properties:
        companies:
          type:
          - array
          - 'null'
          items:
            type: string
          description: List of company IDs to delete
          format: uuid
          example: '["ddf1d8ef-2cca-41ef-89c1-00fb0c05c54f"]'
        persons:
          type:
          - array
          - 'null'
          items:
            type: string
          description: List of person IDs to delete
          format: uuid
          example: '["c28c88d6-7fb5-4c2f-a5a1-559cd2675293"]'
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Requests.Models.CaseCompanyRecord:
      title: Company
      required:
      - company_name
      type: object
      properties:
        company_name:
          minLength: 1
          type: string
          description: The name of the company
          example: Acme Limited
        company_number:
          type:
          - string
          - 'null'
          description: The company registration number
          example: '77642080'
        jurisdiction_code:
          pattern: ^\w{2}(_\w{2})?$
          type:
          - string
          - 'null'
          description: The jurisdiction of the company as a two letter country code (optionally, the state can be included separated by `_`)
          example: GB
        registry_search:
          type: boolean
          description: Search registries for the company details, defaults to `false`
        add_directors:
          type: boolean
          description: Add directors to the list of people on the case, `registry_search` must be `true`, defaults to `false`
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Responses.Owner:
      type: object
      properties:
        owner_id:
          type:
          - string
          - 'null'
          description: The case owner id
          example: 6a9f8d73-29f4-4a6a-80dc-21b8cbecff75
        owner_type:
          enum:
          - User
          type:
          - string
          - 'null'
          description: The type of owner. This should be set to 'user'
          example: user
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Requests.UpdateCaseEntitiesRequest:
      title: Update Entities
      type: object
      properties:
        companies:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.Models.UpdateCaseEntitiesCompanyRequestModel'
          description: List of companies to update
        persons:
          type:
          - array
          - 'null'
          items:
            $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.Models.UpdateCaseEntitiesPersonRequestModel'
          description: List of people to update
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Requests.Models.UpdateCaseEntitiesPersonRequestModel:
      title: Person
      required:
      - person_id
      type: object
      properties:
        person_id:
          type: string
          description: Sikoia ID for the person
          format: uuid
          example: 8303ce21-3120-4981-9a19-560ef110502b
        first_name:
          type:
          - string
          - 'null'
          description: The person's first name
          example: Wilson
        last_name:
          type:
          - string
          - 'null'
          description: The person's last name
          example: Pascale
        email:
          type:
          - string
          - 'null'
          description: The person's email address
          format: email
          example: wislon@acme.ltd.uk
        postal_address:
          $ref: '#/components/schemas/SikoiaSharedModels.CaseManagement.Requests.Models.PostalAddressRequestModel'
        date_of_birth:
          type:
          - string
          - 'null'
          description: The person's date of birth
          format: date
          example: '1985-06-12'
        employer:
          type:
          - string
          - 'null'
          description: The name of the person's employer
          example: Acme Limited
        reference_person_id:
          type:
          - string
          - 'null'
          description: Your external reference for the ID of the person/applicant in the case
          example: Wilson5432
      additionalProperties: false
    SikoiaSharedModels.CaseManagement.Responses.CaseResponse:
      title: Case Record
      type: object
      properties:
        case_id:
          type: string
          description: Sikoia ID for the case
          format: uuid
          readOnly: true
          example: 64cd8202-2db4-44d5-85be-79438d65eb7b
        name:
          type: string
          description: Name of the case
          example: Acme Ltd Loan Application
        case_type:
          enum:
          - Business
          - Consumer
          type: string
          description: The type of case
          example: Business
        stage:
          enum:
          - New
          - InProgressWaitingCustomer
          - InProgressNeedsReview
          - Approved
          - Rejected
          - Dormant
          type: string
          description: The stage of the case
          example: New
        datetime_created:
          type:
          - string
          - 'null'
          description: The time the case was created
          readOnly: true
          example: '2023-02-10T10:59:46.026Z'
        datetime_last_modified:
          type:
          - string
          - 'null'
          description: The time the case was last modified
          readOnly: 

# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sikoia/refs/heads/main/openapi/sikoia-companies-people-api-openapi.yml