---
title: "Hydrates a few already-polled starts and reports what JobDiva returned. READ ONLY - creates and updates nothing in Bilflo. The BI hires feed is a discovery record and nothing more: every row is just PLACEMENTID and CANDIDATEID. Everything a contract job needs lives in searchStart, which no code has ever called, so JobDivaStartDto is a transcription of JobDiva's Swagger rather than observed truth. This endpoint is how that gets confirmed before an assembler is built on it. GET so it is harmless to retry, but it does make one outbound searchStart call per start, so keep the limit small."
method: GET
path: "/jobdiva/v1/placements/preview"
tags: ["Placements"]
---

# Hydrates a few already-polled starts and reports what JobDiva returned. READ ONLY - creates and updates nothing in Bilflo. The BI hires feed is a discovery record and nothing more: every row is just PLACEMENTID and CANDIDATEID. Everything a contract job needs lives in searchStart, which no code has ever called, so JobDivaStartDto is a transcription of JobDiva's Swagger rather than observed truth. This endpoint is how that gets confirmed before an assembler is built on it. GET so it is harmless to retry, but it does make one outbound searchStart call per start, so keep the limit small.

`GET /jobdiva/v1/placements/preview`

## Request

- Base URL: `https://api.bilflo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bilflo.com/jobdiva/v1/placements/preview`
- Auth: API key in header `Authorization`

## Query parameters

- `companyIntegrationId` string, uuid
- `limit` integer
- `placementId` string
- `includeRaw` boolean

## Headers

- `company-id` string, required

## Response `200`

Success

## Changes

- **2026-10-22** `7b33032051fe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bilflo/apis/bilflo-api/changes/jobdiva/v1/placements/preview/get.md)

---

[API](https://skmtc.dev/bilflo/apis/bilflo-api.md) - [All operations](https://skmtc.dev/bilflo/apis/bilflo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bilflo/apis/bilflo-api/revisions/408a84d01c3f?raw)