Playground

Playground

Certification

/api/v1/vendor/certifications

A compliance or security certification held by a vendor.

listgetcreateupdatedelete

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
vendor_id*stringId of the vendor that holds this certification (e.g. 'sup_01HXABC').
type*enumsoc2_type1 | soc2_type2 | iso27001 | iso9001 | iso14001 | hipaa | pci_dss | fedramp | hitrust | gdpr | otherCertification type.
statusenumcurrent | expired | in_progress | not_applicable | revokedCertification status. Defaults to 'current'.
issued_datedate-timeISO 8601 date the certification was issued.
expiration_datedate-timeISO 8601 date the certification expires.
auditorstringAuditor or certifying body (e.g. 'Deloitte').
scopestringScope covered by the certification (e.g. 'All production services').
findingsstringSummary of audit findings.
qualified_opinionbooleanWhether the audit resulted in a qualified opinion. Defaults to false.
document_urlstringURL of the certification document.
verified_atdate-timeWhen the certification was last verified.

API

client.vendor.certifications.*
Loading manifest…