Developer Documentation

Actiever API & MCP Protocol

Koppel recruitment systemen via onze open REST API of laat AI-assistenten vacatures analyseren en plaatsen via de officiële Model Context Protocol (MCP) server.

Sandbox Test API KeyLive Sandbox

Gebruik deze sleutel om direct REST API en MCP requests te authenticeren:

actiever_test_key_live_2026

1. REST API Endpoints

GET/api/v1/vacatures

Doorzoek en filter vacatures op categorie, locatie, salaris, werkvorm en perks.

curl -X GET "https://actiever.nl/api/v1/vacatures?category=IT%20%26%20Software&workType=HYBRID&minSalary=4500"
POST/api/v1/vacatures

Publiceer een nieuwe vacature. Stuur mee via header Authorization: Bearer <key>.

curl -X POST "https://actiever.nl/api/v1/vacatures" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer actiever_test_key_live_2026" \
  -d '{
    "title": "Senior Cloud Infrastructure Engineer",
    "companyName": "TechNova BV",
    "location": "Amsterdam",
    "workType": "HYBRID",
    "employmentType": "FULLTIME",
    "educationLevel": "HBO",
    "experienceLevel": "SENIOR",
    "category": "IT & Software",
    "salaryMin": 5500,
    "salaryMax": 7200,
    "hoursMin": 32,
    "hoursMax": 40,
    "perks": ["Pensioenregeling", "Laptop van de zaak", "Leaseauto / Mobiliteitsbudget"],
    "description": "Ervaren engineer gezocht voor het ontwerpen van cloud systemen...",
    "contactEmail": "[email protected]"
  }'
POST/api/v1/companies

Registreer je organisatie en ontvang direct een eerste ADMIN API-sleutel.

curl -X POST "https://actiever.nl/api/v1/companies"   -H "Content-Type: application/json"   -d '{
    "name": "Demo Recruiters BV",
    "website": "https://demo-recruiters.example.nl",
    "adminName": "Sanne Recruiter",
    "adminEmail": "[email protected]",
    "industry": "Recruitment",
    "location": "Utrecht"
  }'
POST/api/v1/companies/me (teamlid toevoegen)

Voeg extra gebruikers toe op basis van één e-mailadres per teamlid. ADMIN-sleutels kunnen teamleden toevoegen.

curl -X POST "https://actiever.nl/api/v1/companies/me"   -H "Content-Type: application/json"   -H "Authorization: Bearer actiever_test_key_live_2026"   -d '{
    "name": "Mark Recruiter",
    "email": "[email protected]",
    "role": "MEMBER"
  }'
PATCH/api/v1/companies/me

Werk je eigen bedrijfspagina bij met naam, logo, website, beschrijving, branche, teamgrootte en locatie.

curl -X PATCH "https://actiever.nl/api/v1/companies/me"   -H "Content-Type: application/json"   -H "Authorization: Bearer actiever_test_key_live_2026"   -d '{
    "website": "https://actiever.example.nl",
    "description": "Transparante tech-vacatures met eigen bedrijfspagina in eigen beheer.",
    "industry": "IT & Software",
    "size": "11-50"
  }'
POST/api/v1/companies/import

Importeer meerdere vacatures in één keer vanuit een eigen ATS/JSON-feed URL.

curl -X POST "https://actiever.nl/api/v1/companies/import"   -H "Content-Type: application/json"   -H "Authorization: Bearer actiever_test_key_live_2026"   -d '{
    "feedUrl": "https://ats.voorbeeld.nl/api/vacatures?status=open",
    "jobsPath": "data.jobs",
    "clearBeforeImport": false
  }'
GET/api/v1/companies/me

Haal bedrijfspagina-gegevens en teamleden op met jobstatistieken.

curl -X GET "https://actiever.nl/api/v1/companies/me"   -H "Authorization: Bearer actiever_test_key_live_2026"

2. Model Context Protocol (MCP) Server

Actiever ondersteunt het officiële `@modelcontextprotocol/sdk`. Koppel de server in je AI workflow via Stdio of web HTTP:

Claude Desktop Configuratie (~/Library/Application Support/Claude/claude_desktop_config.json):
{
  "mcpServers": {
    "actiever": {
      "command": "npx",
      "args": ["-y", "actiever-mcp"]
    }
  }
}
Ondersteunde MCP Tools:
search_vacancies

Filter op salaris, werkvorm, trefwoord en perks

get_vacancy_details

Haal volledige vacaturedetails en sollicitatiewijze op

post_vacancy

Publiceer vacatures namens werkgevers

get_taxonomy_options

Ontvang alle geldige taxonomieën en categorieën