---
title: "Read a hire by id"
method: GET
path: "/v1/pay/hire/{id}"
tags: ["Voidly Pay"]
---

# Read a hire by id

`GET /v1/pay/hire/{id}`

Hire state, capability, price pinned at hire time, delivery deadline and timestamps. REDACTED BY DEFAULT: requester_did, provider_did, input_json, input, output_json, output, task_id, escrow_id and receipt_id are omitted for callers who have not proved they are a party — input_json is the task text itself, and task_id/escrow_id/receipt_id link the row to the escrow and receipt. Send x-voidly-proof signed by EITHER party to receive them. Every response carries view: full | redacted, and a redacted one carries a redaction object naming the omitted fields.

## Path parameters

- `id` string, required

## Headers

- `x-voidly-proof` string

## Response `200`

Hire

## Other responses

- `404` — hire_not_found

---

[API](https://skmtc.net/voidly/apis/voidly-api.md) · [All operations](https://skmtc.net/voidly/apis/voidly-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voidly/voidly-api/versions/decbe6fd40a8/schema)