network.bsky.jetstream.getImportStatus

bsky-lexicons.bsky.social

Documentation

Report the status of a timestamp-import job: lifecycle state, current phase, per-phase progress, and (on completion) the parse/mutation totals. With no job parameter, reports the current or most recent job. Bearer-token gated: without a configured token the endpoint always returns 401.

main query

Report the status of a timestamp-import job: lifecycle state, current phase, per-phase progress, and (on completion) the parse/mutation totals. With no job parameter, reports the current or most recent job. Bearer-token gated: without a configured token the endpoint always returns 401.

Parameters

job string Optional

Job id returned by importTimestamps. When omitted, the current or most recent job is reported.

Output

Encodingapplication/json
bucketed boolean Optional

Whether Phase A+B completed (the offset files are durable).

error string Optional

Failure detail; present only when state is failed.

finishedAt stringdatetime Optional

Present only for a terminal job.

job string Required

Job id.

phase string Optional

Current phase: parse_bucket (Phase A+B) or apply (Phase C).

Known values: parse_bucket, apply
rowsCorruptOffset integer Optional

No description available.

rowsMatchedAllVersions integer Optional

No description available.

rowsMatchedSpecific integer Optional

No description available.

rowsMutated integer Optional

No description available.

rowsRejected integer Optional

No description available.

rowsTotal integer Optional

No description available.

rowsValid integer Optional

No description available.

segmentsApplied integer Optional

Segments processed so far in Phase C.

segmentsExamined integer Optional

No description available.

segmentsPatched integer Optional

No description available.

segmentsToApply integer Optional

Segments Phase C will process (after resume-skips).

specificCidsUnmatched integer Optional

No description available.

state string Required

Lifecycle state.

Known values: running, complete, failed
submittedAt stringdatetime Optional

An RFC 3339 formatted timestamp.

Errors

JobNotFound No import job matches the supplied id, or no job has ever run when the id is omitted.
Try It

Requests are sent directly from your browser. Some servers may block requests due to CORS.

Base URL for XRPC calls (e.g., https://api.bsky.social)
Parameters
Job id returned by importTimestamps. When omitted, the current or most recent job is reported.
View raw schema 
{
  "type": "query",
  "errors": [
    {
      "name": "JobNotFound",
      "description": "No import job matches the supplied id, or no job has ever run when the id is omitted."
    }
  ],
  "output": {
    "schema": {
      "type": "object",
      "required": [
        "job",
        "state"
      ],
      "properties": {
        "job": {
          "type": "string",
          "description": "Job id."
        },
        "error": {
          "type": "string",
          "description": "Failure detail; present only when state is failed."
        },
        "phase": {
          "type": "string",
          "description": "Current phase: parse_bucket (Phase A+B) or apply (Phase C).",
          "knownValues": [
            "parse_bucket",
            "apply"
          ]
        },
        "state": {
          "type": "string",
          "description": "Lifecycle state.",
          "knownValues": [
            "running",
            "complete",
            "failed"
          ]
        },
        "bucketed": {
          "type": "boolean",
          "description": "Whether Phase A+B completed (the offset files are durable)."
        },
        "rowsTotal": {
          "type": "integer",
          "minimum": 0
        },
        "rowsValid": {
          "type": "integer",
          "minimum": 0
        },
        "finishedAt": {
          "type": "string",
          "format": "datetime",
          "description": "Present only for a terminal job."
        },
        "rowsMutated": {
          "type": "integer",
          "minimum": 0
        },
        "submittedAt": {
          "type": "string",
          "format": "datetime"
        },
        "rowsRejected": {
          "type": "integer",
          "minimum": 0
        },
        "segmentsApplied": {
          "type": "integer",
          "minimum": 0,
          "description": "Segments processed so far in Phase C."
        },
        "segmentsPatched": {
          "type": "integer",
          "minimum": 0
        },
        "segmentsToApply": {
          "type": "integer",
          "minimum": 0,
          "description": "Segments Phase C will process (after resume-skips)."
        },
        "segmentsExamined": {
          "type": "integer",
          "minimum": 0
        },
        "rowsCorruptOffset": {
          "type": "integer",
          "minimum": 0
        },
        "rowsMatchedSpecific": {
          "type": "integer",
          "minimum": 0
        },
        "specificCidsUnmatched": {
          "type": "integer",
          "minimum": 0
        },
        "rowsMatchedAllVersions": {
          "type": "integer",
          "minimum": 0
        }
      }
    },
    "encoding": "application/json"
  },
  "parameters": {
    "type": "params",
    "properties": {
      "job": {
        "type": "string",
        "description": "Job id returned by importTimestamps. When omitted, the current or most recent job is reported."
      }
    }
  },
  "description": "Report the status of a timestamp-import job: lifecycle state, current phase, per-phase progress, and (on completion) the parse/mutation totals. With no job parameter, reports the current or most recent job. Bearer-token gated: without a configured token the endpoint always returns 401."
}

Lexicon Garden

@