---
title: "GET /matches/"
method: GET
path: "/matches/"
tags: ["matches"]
---

# GET /matches/

`GET /matches/`

Retrieve all matches ordered alphabetically.

## Query parameters

- `ordering` string
- `external_id` string
- `stage__in` string
- `hired_at__gte` string
- `hired_at__lte` string
- `submitted_at__gte` string
- `submitted_at__lte` string
- `interview_at__gte` string
- `interview_at__lte` string
- `offer_at__gte` string
- `offer_at__lte` string
- `dropped_at__gte` string
- `dropped_at__lte` string
- `created_at__gte` string
- `created_at__lte` string
- `updated_at__gte` string
- `updated_at__lte` string
- `page` integer
- `page_size` integer

## Response `200`

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` object[], required
    - `id` integer
    - `external_id` string, nullable — Id of the match in the API consumer systems
    - `owner` integer — Owner of the match
    - `organization` integer — Organization that owns the job
    - `job` integer — Job the candidat is matched with
    - `candidate` integer — Candidate that has a match with a job
    - `creator` integer — User who added the candidate to the job
    - `job_pipeline_stage` object — Job pipeline stage of the match
      - `id` integer, required
      - `name` string
      - `rank` integer
      - `job_pipeline` object
        - `id` integer
        - `name` string
    - `is_active` boolean — Whether the match is still active or not
    - `custom_fields` object — Match values for custom fields defined in Manatal.
    - `hired_at` string, date-time, nullable — Date at which the candidate was hired
    - `submitted_at` string, date-time, nullable — Date at which the candidate was added to the job
    - `interview_at` string, date-time, nullable — Date at which the candidate was last interviewed
    - `offer_at` string, date-time, nullable — Date at which an offer was made to the candidate
    - `dropped_at` string, date-time, nullable — Date at which the candidate was no longer considered for the job
    - `created_at` string, date-time
    - `updated_at` string, date-time

---

[API](https://skmtc.net/manatal/apis/manatal-career-page-api.md) · [All operations](https://skmtc.net/manatal/apis/manatal-career-page-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/manatal/manatal-career-page-api/revisions/59053f2da83c/schema)