# Crossdeck API

**Canonical:** https://apis.io/apis/cross-deck-com/cross-deck-com-api/  
**Provider:** Crossdeck — https://apis.io/providers/cross-deck-com/  
**Base URL:** https://api.cross-deck.com  
**Documentation:** https://cross-deck.com/docs/reporting-api

Crossdeck API is published by [Crossdeck](https://apis.io/providers/cross-deck-com/) on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Crossdeck API as documented publicly: 33 operations. Contract generated from the documentation by API Evangelist (2026-11-04); not the provider's own document.

## Operations (33)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/acquisition` | Signups by first-touch source — your biggest acquisition channel — from the maintained acquisitionRollups ledger. |
| GET | `/v1/buckets` | Read-cost: the per-user-vs-overhead split + reads by operation. |
| GET | `/v1/config` | GET /v1/config |
| GET | `/v1/crossmatch` | The moat in one call. One customer, every layer Crossdeck owns, stitched by identity. |
| GET | `/v1/customers` | The customer census — the canonical "how many paying customers" answer, so an AI never improvises it. |
| GET | `/v1/customers/ranked` | Identity tier. The moat leaderboard — your customer book pivoted by an owned axis (who costs the most reads, who pays the most). |
| GET | `/v1/entitlements` | Entitlement detail lives in GET /v1/entitlements. |
| GET | `/v1/entitlements/verify` | The stamp of approval that entitlements are correctly installed. |
| GET | `/v1/errors` | One issue, stitched to the identities it touched — the moat, in the errors layer. |
| GET | `/v1/errors/affected` | The moat at row level — the answer the aggregate /v1/errors only counts: who this error hit and what they pay. |
| POST | `/v1/events` | POST /v1/events |
| GET | `/v1/healthz` | Public health probe for uptime monitors. |
| POST | `/v1/identify` | Links an anonymous device ID to your own user ID — the first call after a successful login. |
| POST | `/v1/identity/alias` | Legacy alias for the identify handler that links an anonymous device ID to your own user ID. |
| POST | `/v1/identity/forget` | GDPR / CCPA right-to-be-forgotten: marks the customer record, writes an audit-journal entry, and queues deletion for the retention worker (30-day SLA). |
| POST | `/v1/migration/users` | POST /v1/migration/users |
| POST | `/v1/purchases` | Legacy alias for POST /v1/purchases/sync that forwards a rail‑signed purchase so entitlements provision before the platform webhook lands. |
| POST | `/v1/purchases/sync` | Forward a rail-signed purchase so entitlements provision before the platform webhook lands. |
| POST | `/v1/releases/sourcemaps` | Batch upload used by @cross-deck/cli ; storage only — stack-trace resolution happens lazily at read time. |
| GET | `/v1/reporting/breakdown` | Per-host top pages or top referrers breakdown. |
| GET | `/v1/reporting/events` | Event-level segment intelligence : how many people fired an event, and the counts grouped by any property your events carry. |
| GET | `/v1/reporting/metrics` | Per- host analytics — for apps with many subdomains, each user sees only their own ( wes.example.com ). |
| GET | `/v1/reporting/people` | The people who came through a host you own — newest-active first. |
| GET | `/v1/reporting/people/{id}/journey` | One person's reverse-chronological event timeline — and this is where the full richness of your custom events surfaces. |
| POST | `/v1/resolve` | The one call: tells your app where the current visitor sits on the trust ladder, what profile fields it may render, what they can access, and what to do next. |
| GET | `/v1/revenue` | Project-wide revenue, from the maintained MRR ledger. |
| GET | `/v1/revenue/averages` | ARPU and average lifetime value per paying customer , from the maintained MRR snapshot + revenue totals-ledger (two point-reads, no scan). |
| GET | `/v1/sdk/heartbeat` | SDK install verification — fired once per boot. |
| GET | `/v1/sdk/versions` | Version metadata only. |
| GET | `/v1/server/audit/{eventid}` | Fetch a single audit‑log entry by its event ID. |
| GET | `/v1/server/customers/{customerid}/entitlements` | Read any customer's active entitlements server‑side. |
| POST | `/v1/server/customers/{customerid}/grant` | Manually grant an entitlement. |
| POST | `/v1/server/customers/{customerid}/revoke` | Revoke a manually‑granted entitlement. |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/cross-deck-com/openapi/_ae-authored/cross-deck-com-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/cross-deck-com/json-schema/cross-deck-com-post-v1-migration-users-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cross-deck-com/json-schema/cross-deck-com-post-v1-migration-users-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/cross-deck-com/json-schema/cross-deck-com-post-v1-identity-alias-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/cross-deck-com/json-schema/cross-deck-com-get-v1-config-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/cross-deck-com/json-schema/cross-deck-com-get-v1-entitlements-verify-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/cross-deck-com/json-schema/cross-deck-com-post-v1-server-customers-customerid-grant-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/cross-deck-com/apis.yml

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cross-deck-com/cross-deck-com-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cross-deck-com/.