Skip to main content

API Integration Overview

This page provides a high-level overview of how external systems integrate with the BeTalent API ecosystem. The platform exposes multiple modules—such as Screen (CV analysis) and Match (candidate search & ranking)—which can be consumed independently or together through a unified authentication and communication model.

Regardless of the module or flow type, all BeTalent APIs follow the same principles:

  • Standard REST API model
  • JWT-based machine-to-machine authentication
  • Consistent request/response patterns
  • Support for both synchronous and asynchronous operations, depending on the module

Authentication Model​

BeTalent APIs use a Machine-to-Machine (M2M) authentication mechanism. External systems authenticate using pre-provisioned credentials (e.g., client ID and client secret) to obtain a JWT token.

The steps are:

  1. Retrieve a JWT access token using client credentials
  2. Send the token in every API request using:
Authorization: Bearer <ACCESS_TOKEN>

For details on obtaining and refreshing tokens, see Authentication.