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

# Create Match Insights

> Creates a new match recommendation and returns a unique match ID along with match insights data.

Creates a new match recommendation and returns a unique match ID along with match insights data.


## OpenAPI

````yaml POST /match-insights
openapi: 3.1.0
info:
  title: INOP
  description: >-
    INOP API provides a powerful suite of endpoints designed to streamline and
    enhance the candidate screening process using AI-driven insights.
  license:
    name: MIT
    identifier: ''
  version: 1.0.0
servers:
  - url: https://public.api.inop.ai/v1/
security:
  - bearerAuth: []
paths:
  /match-insights:
    post:
      description: >-
        Creates a new match recommendation and returns a unique match ID along
        with match insights data.
      requestBody:
        description: Candidate to generate recommendation insights
        content:
          application/json:
            schema:
              type: object
              properties:
                job_description:
                  type: string
                  default: Full Stack Engineer with expertise in React and Node.js...
                candidate:
                  type: object
                  default:
                    first_name: Jane
                    last_name: Smith
                    description: >-
                      Jane Smith, Extensive experience as Java and Groovy
                      Developer in Middleware, REST APIs, Web Services and Web
                      Application development specialising in open source
                      platforms with the focus on server-side technologies and
                      enterprise level application development.
                    linkedin_profile: https://linkedin.com/in/janesmith
                    email: jame.smith@example.com
                    phone: '+1234567890'
                    resume_link: Base64EncodedResumeData
        required: true
      responses:
        '200':
          description: job titles response
          content:
            application/json:
              schema:
                properties:
                  success:
                    type: boolean
                    default: true
                  messages:
                    type: string
                    default: Retrieved matched insights successfully
                  data:
                    type: object
                    default:
                      match_id: f9efa5fa-e61d-4ac1-9db8-2778e0d41462
                      match_score: 0.531764372587204
                      job_id: 3576c31b-3657-552a-f9efa5fae61d
                      job_title: Software Developer
                      job_located_at: New York, NY, USA
                      candidate_name: Jane Smith
                      recommendation_insights:
                        layer_one_score: 0.814778745174408
                        analysed_education:
                          attributes_matched: 3/3
                          matched_attributes:
                            - web development
                            - project management
                            - sustainability
                          unmatched_attributes: []
                          layer_two_score: 1
                        context_summary:
                          matched_summary: >-
                            The candidate demonstrates strong proficiency in
                            Python and experience with SQL and web development,
                            which aligns well with the job requirements. They
                            also have a broad range of software engineering
                            skills that could be beneficial for the role.
                            However, the candidate's profile doesn't explicitly
                            mention some specific technologies required by the
                            job post, such as Django, Flask, and Docker.
                          skills_bucket: >-
                            The candidate possesses strong Python skills and
                            experience in SQL and web development, which
                            partially aligns with the job requirements. However,
                            they lack explicit mention of some specific
                            technologies like Django, Flask, and Docker that are
                            required for the position.
                          traits_interest_bucket: >-
                            The candidate demonstrates traits such as focus,
                            efficiency, and responsibility, which are valuable
                            for a developer role. However, the specific trait of
                            'outrageousness' mentioned in the job post is not
                            evident in the candidate's profile, which could
                            affect cultural fit.
                          education_bucket: >-
                            The candidate's educational background is not
                            explicitly detailed in the provided information,
                            making it difficult to assess alignment with any
                            educational requirements of the job post.
                          experience_bucket: >-
                            The candidate has extensive software engineering
                            experience, including roles as a Senior Software
                            Engineer and experience with Python and web
                            development. This experience partially aligns with
                            the job requirements, but there are gaps in specific
                            technologies and frameworks mentioned in the job
                            post.
                          culture_compatibility_bucket: >-
                            The candidate's values and traits suggest a
                            potential alignment with the company's culture,
                            particularly in areas of teamwork, efficiency, and
                            responsibility. However, the specific trait of
                            'outrageousness' mentioned in the job post is not
                            evident in the candidate's profile, which may impact
                            cultural fit. More information would be needed to
                            fully assess cultural compatibility.
                          values_bucket: >-
                            The candidate's values of quality, capability, and
                            teamwork align well with the job's requirements for
                            a skilled developer who can work in a team
                            environment. However, the specific trait of
                            'outrageousness' mentioned in the job post is not
                            evident in the candidate's profile.
                          culture_compatibility_label: Potential Alignment
                          requirement_gaps:
                            - >-
                              Specific experience with Django and Flask
                              frameworks
                            - Explicit mention of Git version control system
                            - Experience with Docker containerization
                            - >-
                              Test-Driven Development and CI/CD pipeline
                              experience
                            - Outrageousness as a personality trait
                            - >-
                              Location mismatch (candidate in Seattle, job in
                              New York/Remote)
                        context_snippets:
                          summary: >-
                            The candidate Erik VanderWerf appears to be a good
                            fit for the Python developer role at INOP based on
                            his extensive experience and skills that align with
                            the job requirements.
                          source_snippets:
                            - snippet: python developer
                              confidence_score: 0.95
                            - snippet: >-
                                Required skills are Python, Django, Flask, Sql,
                                Restful Apis, Git, Oop, Data Structures,
                                Algorithms, Linux, Web Development, Test-Driven
                                Development, Ci/Cd, Docker Problem-Solving,
                                Communication, Teamwork, Time Management,
                                Adaptability, Attention To Detail, Creativity,
                                Critical Thinking, Flexibility, Emotional
                                Intelligence, Leadership Project Management,
                                Agile Methodologies, Devops, Cloud Computing,
                                Ux/Ui Design.
                              confidence_score: 0.9
                            - snippet: The location preference for the job is REMOTE.
                              confidence_score: 0.7
                            - snippet: >-
                                Candidates with interests in Sports will be a
                                great culture fit for the role as well.
                              confidence_score: 0.5
                          overall_confidence_score: 0.85
                        analysed_experience:
                          attributes_matched: 0/4
                          matched_attributes: []
                          unmatched_attributes:
                            - startup
                            - technology services
                            - python developer
                            - software & services
                          layer_two_score: 0
                        analysed_skills:
                          attributes_matched: 7/24
                          matched_attributes:
                            - communication
                            - sql
                            - linux
                            - teamwork
                            - python (programming language)
                            - project management
                            - leadership
                          unmatched_attributes:
                            - safety culture
                            - devops
                            - professional networking
                            - critical thinking
                            - employee benefits
                            - management skills
                            - decision making
                            - creativity
                            - emotional intelligence
                            - problem solving
                            - adaptability
                            - cloud computing
                            - algorithms
                            - data structures
                            - web development
                            - time management
                            - agile
                          layer_two_score: 0.2916666666666667
                        analysed_interests:
                          attributes_matched: 2/15
                          matched_attributes:
                            - teamwork
                            - communication
                          unmatched_attributes:
                            - safety
                            - impactful
                            - home
                            - enjoyment
                            - sense of purpose
                            - creativity
                            - esg
                            - emotional intelligence
                            - adaptability
                            - leadership
                            - outrageousness
                            - sports
                            - results-oriented
                          layer_two_score: 0.13333333333333333
                        posted_date: 15-04-2025
                        skills_breakdown:
                          soft:
                            - teamwork
                            - software projects
                            - team leadership
                            - communication
                            - interfaces
                            - leadership
                          technical:
                            - solidworks
                            - testing
                            - back-end web development
                            - embedded software
                            - unit testing
                            - java
                            - python
                            - react native
                            - react.js
                            - api development
                            - html
                            - embedded systems
                            - sql
                            - program management
                            - javascript
                            - technical design
                            - public speaking
                            - c++
                            - typescript
                            - mobile application development
                            - c
                            - linux
                            - embedded linux
                            - android sdk
                            - android development
                          transferable:
                            - customer service
                            - object-oriented programming (oop)
                            - project management
                            - code review
                        interests:
                          - contract
                          - public speaking
                          - drones
                          - architecture
                          - robotics
                          - design
                          - languages
                        traits:
                          - practical
                          - active
                          - original
                          - friendly
                          - simple
                          - responsible
                          - private
                          - articulate
                          - focused
                          - modern
                          - flexible
                          - knowledge
                          - efficient
                          - dynamic
                          - intuitive
                          - success performance
                          - development ownership
                          - communication
                          - responsibility
                          - leadership
                          - clients focused
                          - global experience
                          - sustainability expertise
                          - consistency
                          - utility support
                          - quality control
                          - present results
                          - environmental friendly
                          - capability
                          - passion
                          - teamwork
                        culture_fit:
                          score: 0.6666666666666666
                          label: Potential Alignment
                          chart_data:
                            - type: Learning Culture
                              company: 4
                              candidate: 0
                            - type: Authority Culture
                              company: 0
                              candidate: 3
                            - type: Results Culture
                              company: 4
                              candidate: 3
                            - type: Enjoyment Culture
                              company: 2
                              candidate: 0
                            - type: Safety Culture
                              company: 1
                              candidate: 1
                            - type: Caring Culture
                              company: 5
                              candidate: 2
                            - type: Order Culture
                              company: 0
                              candidate: 1
                            - type: Purpose Culture
                              company: 5
                              candidate: 1
        '400':
          description: unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````