---
title: "Get matching session results"
method: POST
path: "/v1/matching-session"
tags: ["matching-session"]
---

# Get matching session results

`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

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)

## Request body

- MatchingSessionRequest: Request body for fetching matching session results.
  - `session_id` string, required: Matching session ID (returned from /match-candidates when items > page_size)
  - `page` integer: Page number (1-indexed). Default is 1.
  - `include_analysis` boolean: Include detailed analysis in response
  - `lang` string, nullable: Target language code for analysis translation (e.g., 'fr', 'es'). Uses session's original language if not specified.

## Response `200`

Page results retrieved successfully

- unknown

## Other responses

- `400`: Invalid page number
- `401`: Authentication required
- `404`: Session not found or expired
- `422`: Validation Error
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/getyourjob/apis/matchingagent-api.md) · [All operations](https://skmtc.dev/getyourjob/apis/matchingagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getyourjob/apis/matchingagent-api/revisions/3a2d9ceb7c84?raw)