---
title: "Upcoming and past changes to our subprocessors, with their effective dates."
method: GET
path: "/v1/public/subprocessors"
tags: ["pricing"]
---

# Upcoming and past changes to our subprocessors, with their effective dates.

`GET /v1/public/subprocessors`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/public/subprocessors`
- Auth: none required

Cacheable for an hour. We email every account holder before adding or changing a subprocessor, and give at least 30 days' notice (`noticeDays`). `upcoming` holds announced changes that have not taken effect, soonest first; `history` holds the rest, newest first. Drafts are never listed. The current list itself is on the subprocessors page.

## Response `200`

OK

- SubprocessorsResponse
  - `upcoming` object[], required
    - `id` string, required
    - `kind` 'add' | 'remove' | 'change', required
    - `name` string, required
    - `purpose` string, required
    - `dataCategories` string, required
    - `location` string, required
    - `transferMechanism` string, required
    - `link` string, nullable, required
    - `status` 'announced' | 'effective' | 'withdrawn', required
    - `announcedAt` string, required
    - `effectiveAt` string, required
    - `withdrawnAt` string, nullable, required
  - `history` object[], required
    - `id` string, required
    - `kind` 'add' | 'remove' | 'change', required
    - `name` string, required
    - `purpose` string, required
    - `dataCategories` string, required
    - `location` string, required
    - `transferMechanism` string, required
    - `link` string, nullable, required
    - `status` 'announced' | 'effective' | 'withdrawn', required
    - `announcedAt` string, required
    - `effectiveAt` string, required
    - `withdrawnAt` string, nullable, required
  - `noticeDays` integer, required
  - `updatedAt` string, required

## Other responses

- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)