> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Report Signed Agreement

> Report the signed contract as a salted commitment

Reports the signed contract, and optionally the signing certificate, as salted commitments computed on your side with the agreement salt. Trusset never receives the file or its plain SHA-256: a body with file content or a plain hash is refused.

```
commitment = SHA-256( utf8("trusset.loan-document.v1") || salt || SHA-256(file bytes) )
```

The SDK computes it with `lending.agreements.reportSigned(marketId, ref, file)`. You may report again until the borrower accepts, for example after a copy mismatch; the same commitment sent again changes nothing (`changed: false`). If the published terms of use changed since the issue, the agreement becomes `STALE` and the borrower requests a new one.

## Who can call

The bank. This is the seam a signing-tool connector on the bank side calls.

## Path Parameters

**marketId** `string` *required*

The market's record ID on your instance.

**ref** `string` *required*

The agreement reference: `agr_` followed by 20 characters.

## Body Parameters

**documentCommitment** `string` *required*

The salted commitment of the signed contract: 32 bytes as `0x` followed by 64 hex characters.

**certificateCommitment** `string`

The salted commitment of the signing certificate, computed with the same salt.

## Response Fields

**data** `object`

**agreement** `object`

The agreement. See [Get Loan Agreement](https://docs.trusset.org/endpoints/lending/get-loan-agreement.md#response-fields) for every field.

**marketId** `string`

The market's record ID on your instance.

```json 200 Reported theme={null}
{
  "success": true,
  "data": {
    "agreement": {
      "ref": "agr_k3vx7q2mwd4h5pn6tr8a",
      "kind": "LOAN",
      "status": "SIGNED",
      "marketAddress": "0x41b9c4d5dee70a5e3682094462e5065275e728a9",
      "chainRef": {
        "network": "ETHEREUM",
        "instanceType": "DEVELOPMENT"
      },
      "borrowerWallet": "0x7c1e3a5f2b9d4e6a8c0f1b3d5e7a9c2b4d6f8e1a",
      "externalReference": "CASE-2026.11_042",
      "scheduleHash": "0x8e2c4a6f1b3d5e7a9c0f2b4d6e8a1c3f5b7d9e0a2c4f6b8d1e3a5c7f9b0d2e4a",
      "scheduleVersion": "1.0.0",
      "scheduleFrozen": true,
      "hashScheme": "SALTED_V1",
      "documentCommitment": "0x3a7f9c2e5b1d8a4f6c0e2b9d7a3f1c5e8b4d2a6f0c9e7b3d1a5f8c2e6b4d0a9f",
      "certificateCommitment": null,
      "copyVerified": null,
      "nextStep": "VERIFY_AND_ACCEPT",
      "expiresAt": "2026-12-21T16:02:11.000Z",
      "salt": "0x9f3c2a7d1e5b8c4a6f0d2e9b7c3a1f5e8d4b2c6a0e9f7d3b1c5a8e2f6d4b0c9a",
      "viewerRole": {
        "bank": true,
        "borrower": false
      }
    },
    "marketId": "cmwfk2h7x0003jw9w4q8b2n1c"
  },
  "error": null
}
```

## Error Codes

| Code | HTTP | Cause |
| - | - | - |
| `DOCUMENT_CONTENT_REFUSED` | `400` | The body carries file content. Keep the file with you and send only the salted commitment |
| `PLAIN_HASH_REFUSED` | `400` | The body carries the plain hash of a file (`contentHash`, `sha256` and similar). Send the salted commitment instead |
| `PERSONAL_DATA_REFUSED` | `400` | The body carries a personal data field such as `name` or `email`. Use wallet addresses and `externalReference` only |
| `VALIDATION_ERROR` | `400` | A field is missing, has the wrong type, or is not part of this route |
| `INVALID_COMMITMENT` | `400` | A commitment is not 32 bytes of hex, is zero, or both commitments are equal |
| `AGREEMENT_BANK_ONLY` | `403` | No verified wallet of your instance holds `DEFAULT_ADMIN_ROLE` on the market |
| `AGREEMENT_STATE` | `409` | The agreement is in a status that does not allow this. `details.status` names it; read the agreement for its next step |
| `AGREEMENT_STALE` | `409` | The terms of use changed after the issue. The agreement is now `STALE`; the borrower requests a new one |
| `TERMS_UNAVAILABLE` | `503` | The terms of use could not be read just now. Retry shortly |
| `AGREEMENT_NOT_FOUND` | `404` | No agreement with this reference on this market, or your instance is not a party to it. List the agreements to find it |
| `MARKET_NOT_FOUND` | `404` | No market with this ID on your instance |
| `CHAIN_UNAVAILABLE`, `SERVICE_UNAVAILABLE` | `503` | The market or your instance's wallets could not be read just now. Nothing was decided. Retry shortly |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.