matching-session

Get matching session results

Retrieve deeply analyzed results for a specific page of a matching session.

**Request body:**
- `session_id`: The matching session ID (returned from /match-candidates or /match-offers)
- `page`: Page number (1-indexed, default 1)
- `include_analysis`: Include detailed analysis (default true)
- `lang`: Translation language code (optional)

**Response type:**
- For match-candidates sessions: Returns `MatchingSessionPageResponse` with `CandidateMatchResponse` items
- For match-offers sessions: Returns `MatchOffersSessionPageResponse` with `OfferMatchResponse` items

**Cache behavior:**
- If the page has been analyzed before, returns cached results instantly
- If not cached, runs Layer 2 deep analysis on the page's items (page_size items)
- Results are then cached for future requests

**Performance:**
- Cached page: ~50ms
- New page: ~8-12 seconds (depends on bulk extraction needs)
post/v1/matching-session

Request

  • Base URL: https://api.getyourjob.pro (the document declares no server; this is the origin it was published from)
  • URL: https://api.getyourjob.pro/v1/matching-session
  • Auth: none declared

Request body

session_idstring required

Matching session ID (returned from /match-candidates when items > page_size)

pageinteger

Page number (1-indexed). Default is 1.

include_analysisboolean

Include detailed analysis in response

langstring nullable

Target language code for analysis translation (e.g., 'fr', 'es'). Uses session's original language if not specified.

Example request

{
  "include_analysis": true,
  "lang": "fr",
  "page": 2,
  "session_id": "ms-a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Response

Page results retrieved successfully

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.