Vervoe

aid: vervoe
url: https://raw.githubusercontent.com/api-evangelist/vervoe/refs/heads/main/apis.yml
name: Vervoe
kind: company
description: Vervoe is an AI-powered skills assessment and skills-based hiring platform. Employers build their own assessment
  content or select from a public Assessment Library - assessments can include video, spreadsheets, presentations, and code
  challenges that simulate real work - then invite candidates and let Vervoe's AI grade and rank them by predicted on-the-job
  performance in "Talent Trials". The Vervoe API is a partner/integration REST API, accessed over HTTPS, that lets an external
  system (typically an ATS or internal hiring dashboard) list an employer's assessments, invite candidates to complete an
  assessment, retrieve candidate assessment reports and scores, and receive real-time report notifications through a signed
  webhook. API access is provisioned by Vervoe - partners contact sales to set up credentials. Detailed REST endpoint paths
  are not published in the public documentation, so the logical APIs below are modeled from Vervoe's documented Example Scenarios
  and webhook reference.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
- Hiring
- Recruitment
- Skills Assessment
- Talent
- HR Tech
- AI Grading
- ATS Integration
created: '2026-07-10'
modified: '2026-07-10'
specificationVersion: '0.19'
apis:
- aid: vervoe:vervoe-assessments-api
  name: Vervoe Assessments API
  tags:
  - Assessments
  - Content
  - Skills
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODk-example-scenarios
  baseURL: https://api.vervoe.com
  endpointsModeled: true
  properties:
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjQ4ODIx-introduction
    type: Documentation
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODk-example-scenarios
    type: APIReference
  description: Retrieve the assessments available to an employer - both content the employer has authored and items selected
    from Vervoe's public Assessment Library - so an external system such as an ATS can display and organize them. Per Vervoe's
    documented Example Scenario 1, an integration calls the API to "get list of assessments"; exact REST endpoint paths are
    not published, so this operation is modeled from the documented scenario.
- aid: vervoe:vervoe-candidates-api
  name: Vervoe Candidates API
  tags:
  - Candidates
  - Invitations
  - Progress
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODk-example-scenarios
  baseURL: https://api.vervoe.com
  endpointsModeled: true
  properties:
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjQ4ODIx-introduction
    type: Documentation
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODk-example-scenarios
    type: APIReference
  description: Invite a candidate (email, first name, last name) to complete a specific assessment and monitor their progress.
    Per documented Example Scenario 2, the integration issues a "POST Invite candidate to complete assessment" call and receives
    back a candidate-specific URL to access the assessment, which the employer can email or embed in a button. Exact REST
    endpoint paths are not published, so this operation is modeled from the documented scenario.
- aid: vervoe:vervoe-reports-api
  name: Vervoe Candidate Reports API
  tags:
  - Reports
  - Results
  - Scores
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODk-example-scenarios
  baseURL: https://api.vervoe.com
  endpointsModeled: true
  properties:
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjQ4ODIx-introduction
    type: Documentation
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODk-example-scenarios
    type: APIReference
  description: Retrieve a candidate's assessment results and scores so an external system can load and display them. Per documented
    Example Scenario 3, the integration issues a "GET Get candidate assessment report" call and Vervoe returns the result
    details, including AI and manual scores. Exact REST endpoint paths are not published, so this operation is modeled from
    the documented scenario.
- aid: vervoe:vervoe-report-notification-webhook
  name: Vervoe Report Notification Webhook
  tags:
  - Webhook
  - Notifications
  - Events
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
  humanURL: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODc-report-notification-web-hook
  baseURL: https://api.vervoe.com
  endpointsModeled: true
  properties:
  - url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjExMzY5ODc-report-notification-web-hook
    type: Documentation
  description: An employer can configure a reporting webhook to which Vervoe sends an Assessment Report. Fourteen documented
    events fire updates - including candidate started, candidate completed, first AI grade, AI score updated, first manual
    team score, manual score updated, hired, unhired, rejected, un-rejected, expired, screening in progress, failed screening,
    and passed screening. Payloads carry the candidateAssessmentUuid, status, timestamps, and a score object (type, score,
    scoreByFormat). Vervoe signs each delivery with an HMAC SHA-256 signature in a Vervoe-Signature header (t and hash); consumers
    must return HTTP 200 or Vervoe retries. This is a server-to-endpoint HTTP callback, not a WebSocket.
common:
- type: DomainSecurity
  url: security/vervoe-domain-security.yml
- type: LinkedIn
  url: https://www.linkedin.com/company/vervoe
- type: Website
  url: https://vervoe.com
- type: Documentation
  url: https://vervoe.stoplight.io/docs/api-docs/ZG9jOjQ4ODIx-introduction
- type: APILandingPage
  url: https://vervoe.com/api/
- type: Plans
  url: plans/vervoe-plans-pricing.yml
- type: RateLimits
  url: rate-limits/vervoe-rate-limits.yml
- type: FinOps
  url: finops/vervoe-finops.yml
- type: Blog
  url: https://vervoe.com/blog/
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com