Skip to content

Evidence Packets

REST-first workflow for agents that assemble evidence from verified records.

An evidence packet is a machine-readable artifact an agent can assemble from PacSpace records. It helps a vendor, customer, middleware, or support workflow review a question in the vendor's own channel by checking shared evidence.

PacSpace does not host the question lifecycle or accept outcomes.

Agent Workflow

  1. Fetch the customer live record.
  2. Fetch the relevant period or compare two periods.
  3. Export the evidence bundle when full context is needed.
  4. Attach the evidence packet to the vendor's support workflow.
  5. Let the vendor, customer, or middleware decide the next step outside PacSpace.

REST Resources

ResourcePurpose
/api/v1/middleware/customers/:customerId/liveCurrent Shared Record state
/api/v1/middleware/customers/:customerId/period/:checkpointIdClosed period detail
/api/v1/middleware/customers/:customerId/compareDifference between two periods/checkpoints
/api/v1/middleware/customers/:customerId/exportEvidence bundle
/api/v1/middleware/customers/:customerId/close-packageFinance-ready package

Packet Contents

A packet should include:

  • customerId
  • checkpointId or period scope
  • Verification reference (record root)
  • verificationReference
  • Selected record manifest
  • Unit labels and recorded values needed for checking
  • Actor type and actor reference
  • Evidence timestamps

Neutrality Rules

Agents should say "matches the verified record" instead of making a final judgment. They should route questions through the vendor's own support channel instead of implying PacSpace accepted or resolved the result.

See also: