verification

List my person verifications

The caller's person-level verifications (KYC packets, attestations), cross-tenant by construction because they hang off the person, not the account. Self-scoped: a filter narrows this set and can never reach another person's rows. With NO query string the response is the legacy {success, data:[...], count} shape, every row, submitted_at DESC — unchanged. With limit or offset the response is the ADR 0003 envelope {success, data:{items, total, filtered, limit, offset}}; limit=0 returns counts alone. Filters or a sort WITHOUT limit/offset return the legacy shape over the filtered, sorted rows. status/kind/issuer are comma-separated ORs; an unrecognised member matches nothing. q is a case-insensitive substring over id, issuer and decision_reason — the row only; the person is not searched because the list is already one person's. from/to bound the column named by date_field (default submitted_at): YYYY-MM-DD is an inclusive whole UTC day, RFC3339 an exact instant (to exclusive); a row with no value in that column is excluded when a bound is set and included otherwise. since/until and created_after/created_before are aliases. Nullable sort columns (decided, expires) order NULLS LAST in both directions; every sort tiebreaks on id. An unknown query KEY is 400 unknown_param.

get/verification/person

Request

  • Base URL: https://api.instruxi.dev/api/v1/enforcer
  • URL: https://api.instruxi.dev/api/v1/enforcer/verification/person
  • Auth: one of:
    • API key in header Authorization
    • API key in header X-API-Key

Query parameters

statusstring

csv of statuses, OR'd (pending, approved, rejected, withdrawn, expired); unknown members match nothing

kindstring

csv of kinds, OR'd (free-form column: identity, kyc, ...)

issuerstring

csv of issuers, OR'd (self, acme, ...)

qstring

case-insensitive substring over id, issuer, decision_reason

date_field'submitted' | 'decided' | 'expires'

which timestamp from/to bound

fromstring

date_field >= this (YYYY-MM-DD = start of that UTC day, or RFC3339)

tostring

date_field < this (YYYY-MM-DD = end of that UTC day inclusive, or RFC3339 exclusive)

sort'submitted' | 'decided' | 'created' | 'status' | 'kind' | 'expires'

sort field

sort_dir'asc' | 'desc'

sort direction

limitinteger

page size 1..200 (clamped); 0 = counts only; absent = unpaged legacy shape

offsetinteger

page offset >= 0

group_idstring uuid

only when the caller's account is a member of this group (uuid); an empty list otherwise. 404 group_not_found if the group is not visible to you

exclude_group_idstring uuid

only when the caller's account is NOT a member of this group (uuid); same 404 rule

Response

paged envelope (legacy {success,data:[],count} when limit/offset absent)

successboolean

Changes

No recorded changes to this operation across all 1 revision of this API.