Skip to content
NEW Join the LexGO Talent Pool. Learn more → Join the LexGO Talent Pool →
Post a job
Post a job

Public jobs API

Unauthenticated read API for live Belgian and Luxembourg legal jobs, function names, and upcoming scheduled events. v1 is additive-only; breaking changes need a new version. See versioning and deprecation.

Send candidates to click_url (the LexGO page with tracking). url is the untagged canonical page; job and event ids accept either. There is no apply-via-agent. Search is compact (no body). GET /api/v1/jobs/{id} / MCP get_job return a sanitized plaintext description. Raw HTML, emails, phones, and ATS URLs are stripped. Permitted use is in the Terms and conditions.

REST

Live vacancies, function names, taxonomies, and upcoming scheduled events. No API key.

  • GET /api/v1/jobsSearch live vacancies. q takes one to three keywords: every word has to match a title, employer, practice area, function, city or region, and generic words such as jobs or legal are ignored.
  • GET /api/v1/jobs/{id}Sanitized description and structured facets. Integer, id-slug, or an allowlisted lexgo.be/lu job URL. Call this before recommending.
  • GET /api/v1/functionsFunction names
  • GET /api/v1/taxonomiesFunction, discipline, region, and work-environment ids plus experience / contract / arrangement enums. Use these ids as search filters.
  • GET /api/v1/eventsUpcoming scheduled events
  • GET /api/v1/events/{id}One upcoming event

Limits and availability

  • 60 requests / minute / IP and 600 / minute globally on the REST and MCP paths. Responses send IETF RateLimit and RateLimit-Policy headers. JSON 429 is RFC 9457 application/problem+json with Retry-After.
  • REST GET sends Cache-Control: private, no-cache and an ETag on job list and show. If-None-Match may return 304. MCP POST stays Cache-Control: private, no-store.
  • A kill switch returns JSON 503 unavailable and does not query the database.
  • Unknown /api paths return the same problem+json 404. Errors include a machine-readable code.
  • Job search returns 20 results on REST and 10 on MCP unless limit says otherwise.
  • To improve search, each MCP tool call and each REST job list or show call is kept for 90 days: the date, the tool, q without contact details, the filters, the number of results and the general type of client. No IP address, no exact time. Calls recognised as Claude by their user agent keep no q and no filters. See the privacy statement.

MCP

  • POST /mcpJSON only. The same jobs, functions, taxonomies, and events as REST. Call get_job before recommending a vacancy. GET /mcp is 405; there is no SSE.

MCP discovery: /.well-known/mcp and /.well-known/mcp/server-card.json. A compatibility copy lives at /mcp-server-card.json.

Don't miss anything

Get the latest legal jobs, events and news every week.