# Customer labeling

Report customer account restrictions and suspensions to improve Radar fraud and abuse signals.

Customer labeling lets you report when you restrict or suspend a customer’s account. Stripe uses these outcome signals to improve Radar fraud and abuse signals.

When you submit a label, Stripe creates an Account Activity. Report an activity each time you restrict or suspend a customer.

Customer labeling is available in private preview. Request access before you report Account Activities.

### Request access to the customer labeling private preview.

Enter your email to request access.

```bash
curl https://docs.stripe.com/preview/register \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Referer: https://docs.stripe.com/radar/customer-labeling" \
  -d '{"email": "EMAIL", "preview": "radar_customer_labeling_preview"}'
```

| Label | Use when | Supported account details |
| --- | --- | --- |
| `account_restricted` | You limit a customer’s access but keep their account active. | A `Customer` ID or v2 `Account` ID |
| `account_suspended` | You disable a customer’s access to their account. | A `Customer` ID |

For `account_restricted`, provide the `Customer` ID associated with the customer in your Stripe integration, or provide their v2 `Account` ID. For `account_suspended`, provide a `Customer` ID.

## Report a restricted customer

Create an `account_restricted` activity when you limit a customer’s access. Set `reason` to `abuse` when the restriction is in response to abusive behavior.

```curl
curl -X POST https://api.stripe.com/v2/signals/account_activity \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "account_details": {
        "customer": "cus_****"
    },
    "type": "account_restricted",
    "account_restricted": {
        "reason": "abuse"
    }
  }'
```

## Report a suspended customer

Create an `account_suspended` activity when you disable a customer’s access to their account.

```curl
curl -X POST https://api.stripe.com/v2/signals/account_activity \
  -H "Authorization: Bearer <<YOUR_SECRET_KEY>>" \
  -H "Stripe-Version: 2026-08-26.preview" \
  --json '{
    "account_details": {
        "customer": "cus_****"
    },
    "type": "account_suspended",
    "account_suspended": {
        "reason": "abuse"
    }
  }'
```

## Choose a reason

Both labels support the following reasons:

| Reason | Use when |
| --- | --- |
| `abuse` | You restricted or suspended the customer for abusive behavior. |
| `other` | You restricted or suspended the customer for another reason. |

By default, the activity’s `occurred_at` timestamp is the time you create it. If the restriction or suspension happened earlier, provide its timestamp in `occurred_at`.

## Next steps

- [Learn about customer abuse prevention](https://docs.stripe.com/radar/customer-abuse-prevention.md)