Get Escrows Details

Batch-read the full state of up to 50 escrows via GET /escrows/details.

This endpoint replaces GET /helper/get-escrow-by-contract-ids. The old path no longer exists.

Headers

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

Open API

GET /escrows/details

Returns the full state and deposits of up to 50 escrows in one request. No event timeline — use GET /escrows/{contractId}/events for that.

Query parameters

Name	Type	Description
contractIds	string[] (1–50)	Contract addresses (C…) to fetch. Repeat the parameter once per id.

Unknown ids are silently absent from the response rather than raising an error. Always check which ids came back before assuming an escrow exists.

What this Endpoint returns?

An array of escrow objects, each containing the current state, the camelCase snapshot, the resolved asset, and the recorded deposits. Every amount is a decimal string.

Because the request itself is bounded at 50 ids, this endpoint is not paginated.

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 () => {
  const contractIds = [
    "CCR6HLU3LQMXOESNA6TOS2RZKGEBWQG3EN5FMZNC43RVXZWTTDCZ...",
    "CCA7WTCVCQ5JPKNIFSHPSJLJ3FJ3GKPNEVAIHP6T..."
  ];

  const params = new URLSearchParams();
  contractIds.forEach(id => params.append("contractIds", id));

  const response = await http.get(`/escrows/details?${params.toString()}`);
  return response.data;
}

The old endpoint took a validateOnChain flag to re-check data against the chain. There is no equivalent here: escrow state is recorded from on-chain events automatically, so there is nothing to reconcile. When you need chain-authoritative truth, read the chain.