VCV interview API
The interview API from VCV — 3 operation(s) for interview.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/vcv-interview-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: VCV chatbot Interview API
description: open api
version: v3
servers:
- url: https://my.vcv.ai
- url: https://my.vcv.ru
- url: '{hostname}'
variables:
hostname:
default: http://localhost:8080
security:
- bearerAuth: []
tags:
- name: interview
paths:
/api/v3/public/interviews/{token}:
get:
tags:
- interview
description: Get public interview
parameters:
- $ref: '#/components/parameters/token'
- name: with[]
in: query
description: Relations to retrieve
required: false
schema:
type: array
items:
type: string
enum:
- candidate
- publicResponse
- publicVacancy
- publicVacancy.language
- publicVacancy.publicCompany
- publicVacancy.publicCompany.language
- stage
- candidate.name
- candidate.phone
responses:
'200':
description: Interview
content:
application/json:
schema:
$ref: '#/components/schemas/PublicInterview'
patch:
tags:
- interview
description: Update public interview response state and save first UTM payload
parameters:
- $ref: '#/components/parameters/token'
requestBody:
required: false
content:
application/json:
schema:
type: object
properties:
utm_source:
type: string
maxLength: 512
utm_medium:
type: string
maxLength: 512
utm_campaign:
type: string
maxLength: 512
utm_content:
type: string
maxLength: 512
utm_term:
type: string
maxLength: 512
responses:
'200':
description: Public interview response updated
content:
application/json:
schema:
type: object
properties:
response_id:
type: integer
agreed_at:
type: string
format: date-time
/api/v3/public/interviews/{token}/agreed:
post:
tags:
- interview
description: Mark public interview response as agreed
parameters:
- $ref: '#/components/parameters/token'
responses:
'200':
description: Response agreement updated
content:
application/json:
schema:
type: object
properties:
response_id:
type: integer
agreed_at:
type: string
format: date-time
/api/v3/responses/{id}/finish:
post:
description: Finish interview immediately
tags:
- interview
parameters:
- $ref: '#/components/parameters/id'
responses:
'200':
description: Finished response
content:
application/json:
schema:
allOf:
- $ref: '#/components/schemas/Response'
- type: object
properties:
_embedded:
type: object
properties:
interview:
allOf:
- $ref: '#/components/schemas/Interview'
- type: object
properties:
_embedded:
type: object
properties:
stage:
allOf:
- $ref: '#/components/schemas/InterviewStage'
components:
schemas:
Candidate:
properties:
id:
type: integer
date_created:
type: string
format: date-time
email:
type: string
bithdate:
type: string
gender:
type: string
type: object
CandidatePhone:
properties:
candidate_id:
type: integer
id:
type: integer
number:
type: string
type:
- object
- 'null'
CandidateName:
properties:
candidate_id:
type: integer
first_name:
type: string
last_name:
type: string
second_name:
type:
- string
- 'null'
type: object
PublicInterview:
properties:
id:
type: integer
date_create:
type: string
format: date-time
token:
type: string
interview_stage_id:
type: integer
candidate_id:
type: integer
candidate:
allOf:
- $ref: '#/components/schemas/Candidate'
- type: object
properties:
name:
$ref: '#/components/schemas/CandidateName'
phone:
$ref: '#/components/schemas/CandidatePhone'
_embedded:
type: object
properties:
publicVacancy:
$ref: '#/PublicVacancy'
publicResponse:
$ref: '#/PublicResponse'
stage:
$ref: '#/components/schemas/InterviewStage'
type: object
Response:
properties:
id:
type: integer
vacancy_id:
type: integer
candidate_id:
type: integer
response_status_id:
type: integer
response_source_id:
type: integer
interview_id:
type: integer
external_id:
type: string
is_hidden_by_candidate:
type: boolean
created_at:
type: string
format: date-time
agreed_at:
type:
- string
- 'null'
format: date-time
date_sent:
type:
- string
- 'null'
format: date-time
resume_url:
type:
- string
- 'null'
second_resume_url:
type:
- string
- 'null'
social_source:
type:
- string
- 'null'
utm_source:
type:
- string
- 'null'
utm_medium:
type:
- string
- 'null'
utm_campaign:
type:
- string
- 'null'
utm_content:
type:
- string
- 'null'
utm_term:
type:
- string
- 'null'
is_paid:
type:
- boolean
- 'null'
type: object
Interview:
properties:
id:
type: integer
date_create:
type: string
format: date-time
token:
type: string
interview_stage_id:
type: integer
candidate_id:
type: integer
type: object
InterviewStage:
properties:
id:
type: integer
key:
type: string
title:
type: string
type: object
parameters:
id:
name: id
in: path
description: entity id
required: true
schema:
type: integer
token:
name: token
in: path
description: token
required: true
schema:
type: string
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: token