Export a Session's event ledger

Exports the Session’s complete event ledger as one self-describing document: format, schema_version, wire_version, provenance ids, the frozen end_seq, every persisted envelope in order, and an unavailable array accounting for positions that were erased, expired, or never written under zero data retention. Each new unavailable position carries a content-free replay fact and a complete structural-replay marker; legacy positions written before those facts are marked incomplete. Folding readable envelopes and complete facts in sequence reproduces the Session’s non-sensitive structural projection without reconstructing erased content. The body is streamed incrementally, so a large history never has to be held in memory; for incremental sync, page the events endpoint with a cursor instead.

Checkfu support posture: alpha; hosted. Required evidence journey: session-turn. Deployment-specific readiness and the latest proven release are available from GET /v1/support/capabilities.

GET /v1/sessions/{id}/export

Export a Session's event ledger

cURL

curl --request GET \
  --url https://api.checkfu.com/v1/sessions/{id}/export \
  --header 'Authorization: Bearer <token>' \
  --header 'checkfu-version: <checkfu-version>'

200

{
  "format": "checkfu.session-export",
  "schema_version": 1,
  "wire_version": "<string>",
  "session_id": "<string>",
  "workspace_id": "<string>",
  "exported_at": "<string>",
  "end_seq": 1,
  "events": [
    {
      "id": "<string>",
      "seq": 1,
      "schema_version": 1,
      "created_at": "<string>",
      "type": "user.message",
      "payload": {
        "content": "<string>",
        "authored_by": "<string>",
        "caused_by": {
          "kind": "api",
          "request_id": "<string>"
        },
        "attachments": [
          "<string>"
        ],
        "prompt_integrity": {
          "analyzer_version": "unicode-17.0.0-uts39-r32-checkfu-1",
          "disposition": "accepted_normalization",
          "original_digest": "<string>",
          "findings": [
            {
              "kind": "mixed_script_confusable",
              "utf16_offset": 1,
              "code_point": "<string>",
              "replacement": "<string>",
              "answer_id": "<string>",
              "value_index": 1
            }
          ]
        },
        "connected_runtime": "<string>",
        "run_delivery": "next_run",
        "host_context": {
          "source": "<string>",
          "data": {}
        },
        "surface_scope_id": "<string>"
      },
      "attested": true
    }
  ],
  "unavailable": [
    {
      "seq": 1,
      "content_class": "message",
      "reason": "shredded",
      "structural_replay": "complete",
      "replay_fact": {
        "version": 1,
        "seq": 1,
        "kind": "state_neutral"
      },
      "prompt_integrity": {
        "analyzer_version": "unicode-17.0.0-uts39-r32-checkfu-1",
        "disposition": "accepted_normalization"
      }
    }
  ]
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version · enum<string> · required

Available options: 2026-08-24

Path Parameters

id · string · required

Pattern: ^sess_[0-9a-f]{32}$

Response

200

application/json

Success

format · enum<string> · required

Available options: checkfu.session-export

schema_version · enum<number> · required

Available options: 1

wire_version · string · required

session_id · string · required

Pattern: ^sess_[0-9a-f]{32}$

workspace_id · string · required

Pattern: ^wrkspc_[0-9a-f]{32}$

exported_at · string · required

end_seq · integer · required

Required range: x >= 0

events · object[] · required

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Option 24

Option 25

Option 26

Option 27

Option 28

Option 29

Option 30

Option 31

Option 32

Option 33

Option 34

Option 35

Option 36

Option 37

Option 38

Option 39

Option 40

Option 41

Option 42

Option 43

Option 44

Option 45

Option 46

Option 47

Option 48

Option 49

Option 50

Option 51

Option 52

Option 53

Option 54

Option 55

Option 56

Option 57

Option 58

Option 59

Option 60

Option 61

Option 62

Option 63

Option 64

Option 65

Option 66

Option 67

Option 68

Option 69

Option 70

Option 71

Option 72

Option 73

Option 74

Option 75

Option 76

Option 77

Option 78

Option 79

Option 80

Option 81

Option 82

Option 83

Option 84

Option 85

Option 86

Option 87

Option 88

Option 89

Option 90

Option 91

Option 92

Option 93

Option 94

Option 95

Option 96

Option 97

Option 98

Option 99

Option 100

Option 101

Option 102

Option 103

Option 104

Option 105

Option 106

Option 107

Option 108

Option 109

Option 110

Option 111

Option 112

Option 113

Option 114

Option 115

Option 116

Option 117

Option 118

Option 119

Option 120

Option 121

Option 122

Option 123

Option 124

Option 125

Option 126

Option 127

Option 128

Option 129

Option 130

Show child attributes

unavailable · object[] · required

Show child attributes