> For the complete documentation index, see [llms.txt](https://docs.trustlesswork.com/trustless-work/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest.md).

# API REST

- [Introduction](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/introduction.md): Base URLs, the build-sign-submit loop, and the conventions every endpoint follows.
- [Single Release Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy.md): One escrow, one settlement — the full amount releases at once when the work is approved.
- [Deploy](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/initialize-escrow.md): Deploy the escrow contract and define the escrow properties.
- [Fund Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/fund-escrow.md): Deposit funds into a deployed escrow, locking them until the agreed conditions are met.
- [Approve Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/change-milestone-flag.md): Approve one or many milestones in a single transaction, signed by an approver.
- [Change Milestone Status](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/change-milestone-status.md): Update a milestone's status and attach evidence, signed by a service provider.
- [Release Funds](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/release-funds.md): Release the escrow funds to the receiver, signed by a release signer.
- [Withdraw Remaining Funds](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/withdraw-remaining-funds.md): Recover funds left in the escrow after settlement or resolution.
- [Dispute Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/change-dispute-flag.md): Open a dispute on the escrow, freezing release until the dispute resolver rules.
- [Resolve Dispute](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/resolving-disputes.md): Resolve an open dispute and distribute the funds, signed by a dispute resolver.
- [Update Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/update-escrow-properties.md): Replace the on-chain escrow properties, signed by the escrow admin.
- [Manage Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/manage-milestones.md): Add new milestones and/or edit existing milestone descriptions in one transaction, signed by the escrow admin.
- [Approve and Release Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/approve-and-release-milestones.md): Approve milestones and release the escrow in a single atomic transaction.
- [Extend TTL](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/extend-ttl.md): Extend the escrow contract storage TTL before it expires, signed by the escrow admin.
- [Get Escrow Balances](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/get-escrow-balances.md): Read token balances of up to 20 escrows directly from the chain.
- [Get Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy/get-escrow.md): Read an escrow state directly from the contract (authoritative).
- [Multi Release Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1.md): One escrow, many payouts — each milestone carries its own amount and settles independently.
- [Deploy](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/initialize-escrow.md): Deploy the multi-release escrow contract and define its milestone payouts.
- [Fund Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/fund-escrow.md): Deposit funds into a deployed multi-release escrow, locking them until each milestone settles.
- [Approve Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/change-milestone-flag.md): Approve one or more milestones in a single batch transaction, signed by an approver.
- [Change Milestone Status](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/change-milestone-status.md): Update the status (and optionally evidence) of one or more milestones, signed by a service provider.
- [Release Milestone Funds](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/release-funds.md): Release the funds of one or more approved milestones, signed by a release signer.
- [Withdraw Remaining Funds](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/withdraw-remaining-funds.md): Sweep the leftover balance once every milestone has been settled.
- [Dispute Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/change-dispute-flag.md): Put one or more milestones in dispute, freezing their release until resolution.
- [Resolve Dispute](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/resolving-disputes.md): Resolve the active milestone disputes and distribute their funds, signed by a dispute resolver.
- [Update Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/update-escrow-properties.md): Replace the escrow-level properties, signed by the escrow admin. Per-milestone state is preserved.
- [Manage Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/manage-milestones.md): Add new milestones and/or edit existing milestone descriptions and amounts, signed by the escrow admin.
- [Approve and Release Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/approve-and-release-milestones.md): Approve milestones and release their funds in a single atomic transaction.
- [Extend TTL](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/extend-ttl.md): Extend the escrow contract storage TTL before it expires, signed by the escrow admin.
- [Get Escrow Balances](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/get-escrow-balances.md): Read token balances of up to 20 escrows directly from the chain.
- [Get Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/deploy-1/get-escrow.md): Read an escrow state directly from the contract (authoritative).
- [Stellar](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/stellar.md): These endpoints provide a way to receive tokens through Trustline and send any transactions to the Stellar Blockchain.
- [Send Transaction](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/stellar/send-transaction.md): Most Trustless Work endpoints return an unsigned transaction in XDR format. This endpoint is used to sign such unsigned transactions and send them to the Stellar network.
- [Escrows](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows.md): The read endpoints: list, detail, events, milestones, financial and GraphQL.
- [List Escrows](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/list-escrows.md): List escrows with filters and keyset pagination via GET /escrows.
- [Get Escrow](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/get-escrow.md): Read one escrow in full: state, participants, timeline and deposits.
- [Get Escrow Events](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/get-escrow-events.md): Page an escrow event timeline.
- [Get Escrow Milestones](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/get-escrow-milestones.md): Read the milestones of one escrow or a batch.
- [Get Escrows Financial](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/get-multiple-escrow-balance.md): Balances, deposits, releases and fees for up to 50 escrows via GET /escrows/financial.
- [Get Escrows Details](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/get-escrow-by-contract-ids.md): Batch-read the full state of up to 50 escrows via GET /escrows/details.
- [GraphQL](https://docs.trustlesswork.com/trustless-work/v2-en/api-rest/escrows/graphql.md): Read the same escrow data with field selection over a single POST endpoint.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.trustlesswork.com/trustless-work/v2-en/api-rest.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.