Get Escrow Milestones

Read the milestones of one escrow or a batch.

Headers

Name	Value
Content-Type	application/json
x-api-key	<token>

Open API

GET /escrows/{contractId}/milestones

Reads one escrow's milestones only — a lighter call than fetching the whole escrow.

Name	Type	In	Description
contractId	string	path	On-chain escrow address (C…)

GET /escrows/milestones

The batch version: milestones for several escrows at once.

Name	Type	In	Description
contractIds	string[]	query	1–50 addresses. Repeat the param

What this Endpoint returns?

The milestone list of each escrow, including status and the approvals { target, approvalCount, approvedBy } progress used to render approval state.

The batch endpoint is not paginated — the request itself is bounded at 50 ids. Unknown ids are silently absent rather than an error, so check what came back.

Use Example:

import axios from "axios";

const http = axios.create({
  baseURL: "https://beta.api.trustlesswork.com",
  timeout: 10000,
  headers: {
    "Content-Type": "application/json",
    "x-api-key": your_api_key,
  },
});

export const useExample = async (contractId: string) => {
  // One escrow
  const one = await http.get(`/escrows/${contractId}/milestones`);

  // Several at once
  const params = new URLSearchParams();
  ["CXYZ...", "CABC..."].forEach(id => params.append("contractIds", id));
  const many = await http.get(`/escrows/milestones?${params.toString()}`);

  return { one: one.data, many: many.data };
}

These reads come from the read-model, which is eventually consistent. Right after submitting a transaction a 404 usually means "not projected yet", not "does not exist" — poll briefly instead of treating it as an error.