---
title: "List Placements"
method: GET
path: "/api/placements"
tags: ["placements"]
---

# List Placements

`GET /api/placements`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/placements`
- Auth: HTTP bearer

List all placements

Founders see all placements
Client users see only their company's placements

## Query parameters

- `status` string, nullable: Filter by status
- `client_id` string, nullable: Filter by client

## Response `200`

Successful Response

- PlacementResponse[]
  - `id` string, required
  - `client` object, nullable
  - `candidate` object, nullable
  - `role_type` string, required
  - `monthly_rate` integer, required
  - `pricing_tier` string, nullable
  - `start_date` string, date, nullable
  - `end_date` string, date, nullable
  - `status` string, required
  - `proposal_url` string, nullable
  - `signed_date` string, date, nullable
  - `first_invoice_paid` boolean
  - `churn_reason` string, nullable
  - `nps_score` integer, nullable
  - `duration_days` integer, nullable
  - `contractor_monthly_cost` integer, nullable
  - `deel_contract_id` string, nullable
  - `payment_provider` string, nullable
  - `gross_margin_dollars` integer, nullable
  - `margin_percent` number, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)