Civic Transparency PTag Specification
Normative specification for privacy-preserving provenance tags (PTags) Includes JSON Schemas and OpenAPI definitions for transparency APIs.
Schemas
| Schema | Purpose | Status |
|---|---|---|
ptag.schema.json |
Per-post behavioral metadata | Draft |
ptag_series.schema.json |
Aggregated time PTagSeries API responses | Draft |
ptag_api.openapi.yaml |
REST API specification | Draft |
Implementation Flow
- Generate provenance tags when posts are created (per
ptag.schema.json). - Aggregate tags into time buckets (with k-anonymity ≥ 100).
- Expose aggregated data via REST API (per
ptag_api.openapi.yaml).
See API documentation for complete specification.
Designed for Privacy
- All responses maintain k-anonymity (k≥100).
- No individual posts or users are exposed.
- Rare categories (<5%) are grouped as "other".
- Geographic data limited to country-level or 1M+ (ISO codes).
Related Repositories
Three Generated Types:
- civic-transparency-py-ptag-types - Typed Python models auto-generated from these schemas.
- civic-transparency-go-ptag-types - Go structs from schemas (Go module).
- civic-transparency-js-ptag-types - TypeScript typings (npm, @civic-interconnect/ptag-types).
CWE-based proactive catalog including PTag mappings:
Go Ecosystem:
- civic-transparency-go-sdk - Go SDK and integrations.
Versioning
This specification follows semantic versioning. See CHANGELOG.md for version history.
License
MIT © Civic Interconnect
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file civic_transparency_ptag_spec-0.2.5.tar.gz.
File metadata
- Download URL: civic_transparency_ptag_spec-0.2.5.tar.gz
- Upload date:
- Size: 75.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6b3aa85ce57e5b2bc8be46d895be11444bc420c2b6e11dfe9e5e40c54cb88c62
|
|
| MD5 |
29630de57d30f70206fdd9e5c2c1fa6a
|
|
| BLAKE2b-256 |
89779ad622b7fb032ae20998b0a8df3ae5045e7bdb0438abc8113a4e75651b4a
|
Provenance
The following attestation bundles were made for civic_transparency_ptag_spec-0.2.5.tar.gz:
Publisher:
release.yml on civic-interconnect/civic-transparency-ptag-spec
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
civic_transparency_ptag_spec-0.2.5.tar.gz -
Subject digest:
6b3aa85ce57e5b2bc8be46d895be11444bc420c2b6e11dfe9e5e40c54cb88c62 - Sigstore transparency entry: 579394172
- Sigstore integration time:
-
Permalink:
civic-interconnect/civic-transparency-ptag-spec@8d8d98ab569449104df442be14eee5f62992b930 -
Branch / Tag:
refs/tags/v0.2.5 - Owner: https://github.com/civic-interconnect
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@8d8d98ab569449104df442be14eee5f62992b930 -
Trigger Event:
push
-
Statement type:
File details
Details for the file civic_transparency_ptag_spec-0.2.5-py3-none-any.whl.
File metadata
- Download URL: civic_transparency_ptag_spec-0.2.5-py3-none-any.whl
- Upload date:
- Size: 14.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a3d91fc75ec8e2c3098ffb5b6c8d8a65e85cd9e503a54bfb8ed49bd1e77b1067
|
|
| MD5 |
fca3afc9814147973fc1c44f1fedf0e3
|
|
| BLAKE2b-256 |
c3b1440d0eaf6c1aa4ee0a1a137bdbaf9874316a5e0f6175b6b25a66586e9b7d
|
Provenance
The following attestation bundles were made for civic_transparency_ptag_spec-0.2.5-py3-none-any.whl:
Publisher:
release.yml on civic-interconnect/civic-transparency-ptag-spec
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
civic_transparency_ptag_spec-0.2.5-py3-none-any.whl -
Subject digest:
a3d91fc75ec8e2c3098ffb5b6c8d8a65e85cd9e503a54bfb8ed49bd1e77b1067 - Sigstore transparency entry: 579394286
- Sigstore integration time:
-
Permalink:
civic-interconnect/civic-transparency-ptag-spec@8d8d98ab569449104df442be14eee5f62992b930 -
Branch / Tag:
refs/tags/v0.2.5 - Owner: https://github.com/civic-interconnect
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@8d8d98ab569449104df442be14eee5f62992b930 -
Trigger Event:
push
-
Statement type:
