---
title: "List historical Stripe customer aliases"
method: GET
path: "/admin/billing/stripe/customer-aliases"
tags: ["Billing"]
---

# List historical Stripe customer aliases

`GET /admin/billing/stripe/customer-aliases`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/admin/billing/stripe/customer-aliases`
- Auth: API key in header `x-api-key`

Lists historical Stripe customer-to-user aliases (admin only), filtered by `user_id` or `status` (`active` or `revoked`). `limit` is 1 to 500, default 100. Each alias has the Stripe customer id, `user_id`, `status`, `source`, `reason` and audit fields. Only `active` aliases are used, and only when no canonical link exists.

## Query parameters

- `user_id` string
- `status` 'active' | 'revoked'
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

Stripe customer aliases

- BillingStripeCustomerAliasesResponseDoc
  - `code` integer
  - `data` BillingStripeCustomerAliasDoc[]
    - `created_at` string
    - `created_by` string
    - `reason` string
    - `revoked_at` string
    - `revoked_by` string
    - `source` string
    - `status` string
    - `stripe_customer_id` string
    - `updated_at` string
    - `updated_by` string
    - `user_id` string
  - `msg` string

## Other responses

- `400`: Invalid query
- `401`: Authentication required
- `403`: Admin plan required
- `500`: Internal server error

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)