Escrow

Escrow job queries

get

Query parameters

clientstringOptional

Filter by client address

providerstringOptional

Filter by provider address

evaluatorstringOptional

Filter by evaluator address

statusstringOptional

Filter by job status (Funded, Submitted, Completed, Refunded)

certsbooleanOptional

Include related certificates

Responses

200

Escrow jobs found. When certs=true, each item includes a certificates array; otherwise each item is a flat job object.

application/json

Schema for GET /v1/escrow-jobs?certs=true response.

400

Bad request

application/json

get

/v1/escrow-jobs

HTTPcURLJavaScriptPython

GET /v1/escrow-jobs HTTP/1.1
Accept: */*

{
  "data": [
    {
      "certificates": [
        {
          "envelope": {
            "signature": {
              "Signature": "text"
            },
            "transaction": {
              "Release20260319": {
                "archival": true,
                "claim": {
                  "TokenTransfer": {
                    "amount": "text",
                    "recipient": "text",
                    "token_id": "text",
                    "user_data": "text"
                  }
                },
                "fee_token": null,
                "network_id": "text",
                "nonce": 1,
                "sender": "text",
                "timestamp_nanos": 1
              }
            }
          },
          "signatures": [
            []
          ]
        }
      ],
      "job": {
        "client": "text",
        "config_id": "text",
        "deliverable": null,
        "description": "text",
        "evaluator": "text",
        "evaluator_fee": "text",
        "job_id": "text",
        "provider": "text",
        "provider_fee": "text",
        "status": "text",
        "token_id": "text"
      }
    }
  ],
  "meta": {
    "timestamp": "text"
  }
}

get

Path parameters

job_idstringRequired

Hex-encoded escrow job ID

Query parameters

certsbooleanOptional

Include related certificates

Responses

200

Escrow job found. When certs=true, data includes a certificates array; otherwise data is a flat job object.

application/json

Schema for GET /v1/escrow-jobs/{job_id}?certs=true response.

400

Bad request

application/json

404

Job not found

application/json

get

/v1/escrow-jobs/{job_id}

HTTPcURLJavaScriptPython

GET /v1/escrow-jobs/{job_id} HTTP/1.1
Accept: */*

{
  "data": {
    "certificates": [
      {
        "envelope": {
          "signature": {
            "Signature": "text"
          },
          "transaction": {
            "Release20260319": {
              "archival": true,
              "claim": {
                "TokenTransfer": {
                  "amount": "text",
                  "recipient": "text",
                  "token_id": "text",
                  "user_data": "text"
                }
              },
              "fee_token": null,
              "network_id": "text",
              "nonce": 1,
              "sender": "text",
              "timestamp_nanos": 1
            }
          }
        },
        "signatures": [
          []
        ]
      }
    ],
    "job": {
      "client": "text",
      "config_id": "text",
      "deliverable": null,
      "description": "text",
      "evaluator": "text",
      "evaluator_fee": "text",
      "job_id": "text",
      "provider": "text",
      "provider_fee": "text",
      "status": "text",
      "token_id": "text"
    }
  },
  "meta": {
    "timestamp": "text"
  }
}