Storage

Deal status for a stored file

Requires scope files:read. Returns the deal, the KEP vested to the provider so far, and any open possession challenge.

GET/api/v1/files/{dealId}Try it

iNote

Requires a key with the files:read scope, sent as Authorization: Bearer <api-key>. Keys missing the scope are rejected with 403 — see Authentication.

Path parameters

Name	In	Type	Description
dealIdrequired	path	integer

Errors

Code	Meaning
401	Invalid or missing API key.
403	The API key lacks the required scope for this operation.
404	Deal not found.

cURL

curl https://gateway.kepto.xyz/api/v1/files/<dealId> \
  -H "Authorization: Bearer <api-key>"

200 · application/json

{
  "dealId": 0,
  "client": "string",
  "provider": "string",
  "merkleRoot": "string",
  "sizeBytes": 0,
  "leafCount": 0,
  "status": "None",
  "createdAt": 0,
  "startTime": 0,
  "endTime": 0,
  "durationSeconds": 0,
  "totalPriceKep": "string",
  "collateralKep": "string",
  "paidOutKep": "string",
  "faultCount": 0,
  "vestedKep": "string",
  "openChallenge": {
    "challenger": "string",
    "commitBlock": 0,
    "challengedLeaf": 0,
    "deadline": 0,
    "bondKep": "string"
  }
}