Reference
Glossary
| Term | Definition |
|---|---|
| DROP | Delete Request and Opt-out Platform — the platform created by CalPrivacy for consumers to submit deletion and opt-out requests and for data brokers to retrieve and respond to them |
| Delete Act | California law requiring data brokers to process consumer deletion requests through DROP (see Civil Code section 1798.99.80 et seq.) |
| CPPA / CalPrivacy | The California Privacy Protection Agency — the state agency responsible for DROP |
| API key | The credential sent in the X-API-KEY header to authenticate API requests |
| Data broker ID | The unique identifier assigned to your organization, used in file naming |
| Consumer deletion list | A list containing one or more hashed consumer identifiers that consumers provided as part of a deletion request |
| Work item | A single consumer deletion request record identified by its ID in a CSV file |
| NDZ | Name + Date of Birth + ZIP — a composite-hash list type |
| MAID | Mobile Advertising Identifier |
| VIN | Vehicle Identification Number |
| CTVID | Connected TV Identifier — covers smart TVs, streaming players, and gaming consoles |
| NameVIN | Name + VIN — a composite-hash list type |
| New upload | Submission of new status responses |
| Amend upload | Correction or update to previously submitted status responses |
| Composite hash | A multi-step hash where individual fields are hashed first, concatenated, then hashed again (used by NDZ and NameVIN) |
Status code reference
| Code | Label | Meaning |
|---|---|---|
| 2 | Exempted | Match found and personal information is exempt |
| 3 | Deleted | Match found and non-exempt personal information was deleted |
| 4 | Opted out | Multiple consumers are linked to the same identifier and all were opted out of sale or sharing |
| 5 | Not found | No match found after completing the matching process |
Reference codes 0 and 1 are unused.
For more information on the legal requirements based on match outcomes, see California Civil Code section 1798.99.80 et seq. and CCR, title 11, section 7600 et seq.
File naming pattern
<YYYYMMDD>_<DataBrokerId>_<DataType>[_<OptionalSuffix>].csv
Documentation map
| Document | Audience | Contents |
|---|---|---|
| Getting Started | All | Account setup, authentication, API key generation, quick start |
| Integration Workflow | All | The download-process-upload cycle, validation, retries |
| Working With the Data | Technical | List types, file schemas, standardization rules, hashing examples |
| API Operations | Technical | Endpoints, request examples, error handling, rate limits |
| Reference | All | Glossary, status codes, documentation map, and support information |
| OpenAPI Specification (YAML) | Developers | Machine-readable API definition for OpenAPI-compatible tools |
Contact and support
Use the Data Broker Portal for account setup, credentials, and to contact us.
When reporting an issue, include:
- Timestamp (Pacific Time)
- Endpoint and HTTP status code
- File name involved
- Upload response payload or error message
| Version | Date | Notes |
|---|---|---|
| 1.1.0 | June 2026 | Initial release |