Skip to content

API reference ​

The Assessment API exposes three endpoints over HTTPS.

Base URL ​

text
https://app.smalltalk2.me/api/integration

Authentication ​

In the B2B dashboard, go to Integration Settings and select Create API Token.

Send the organization's token as a bearer token on every request:

http
Authorization: Bearer <token>

An invalid or missing organization token returns 403 Forbidden.

Rate limiting ​

The API is limited to 200 requests per minute per client IP.

Endpoints ​

MethodEndpointDescription
GET/list_testsList assessments available to the organization.
POST/send_testCreate a candidate assessment.
GET/test_statusRetrieve status, score, report links, and optional result data.

Data format ​

The API uses JSON request and response bodies. Send Content-Type: application/json with API requests.

SmallTalk2Me documentation