Storage

Poll a hosted upload job (step 3 of the upload flow)

Requires scope files:read. Returns the admission record for a job created by POST /api/v1/files. Only the owning account can read a job.

GET/api/v1/jobs/{jobId}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.

iNote

Part of the three-step upload flow: quote the upload with POST /api/v1/files/quote, store the bytes against the quote with POST /api/v1/files, then poll GET /api/v1/jobs/{jobId} until the job completes.

Path parameters

Name	In	Type	Description
jobIdrequired	path	string

Errors

Code	Meaning
401	Invalid or missing API key.
403	The API key lacks the required scope for this operation.
404	Unknown job, or the job belongs to another account.

cURL

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

200 · application/json

{
  "jobId": "string",
  "accountId": "string",
  "idempotencyKey": "string",
  "inputDigest": "string",
  "envelopeBytes": 0,
  "physicalBytes": 0,
  "dealCount": 0,
  "kepWei": "string",
  "budgetClass": "customer",
  "watchtowerBondWei": "string",
  "nativeWei": "string",
  "utcDay": "2026-08-07",
  "state": "Reserved",
  "transactionHashes": [
    "string"
  ]
}