A Person's correspondence log

GET

/persons/{person_id}/correspondence

const url = 'https://quikstik-core.fly.dev/persons/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/correspondence';
const options = {
  method: 'GET',
  headers: {
    'x-tenant-id': '2489E9AD-2EE2-8E00-8EC9-32D5F69181C0',
    Authorization: 'Bearer <token>'
  }
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://quikstik-core.fly.dev/persons/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/correspondence \
  --header 'Authorization: Bearer <token>' \
  --header 'x-tenant-id: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0'

Every message attached to this Person, newest first — outbound email recorded by the Postmark sweep (and later, inbound + SMS). Attachments to identities were made at ingestion (exact email match, QS-ref match, or operator confirmation) — never computed at read time. Staff-scoped.

Authorizations

bearerAuth

Parameters

Path Parameters

person_id

required

string format: uuid

Header Parameters

x-tenant-id

required

string format: uuid

Tenant identifier (UUID).

Authn/authz semantics are intentionally TBD for this contract slice; this header exists to keep the contract explicitly multi-tenant from day 0.

Responses

200

The message log: id, channel, direction, provider ref, sender, recipient, subject, obligation_ref, occurred_at_ms.

401

Missing or invalid session bearer token

application/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}

403

The session’s effect authority does not cover this operation

application/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}

503

No durable backend is wired for this operation (fail-closed)

application/json

object

reason

required

Stable, machine-readable reason code (e.g. “sold_out”, “processor_not_configured”, “rail_refused”).

string

Example

{
  "reason": "sold_out"
}