# Get customer details with subscriptions

Retrieves comprehensive customer information including their subscription contracts. This endpoint provides customer profile data along with a paginated list of their active and historical subscriptions.

Key Features:
- Customer profile information (name, email, phone, addresses)
- Complete subscription history with pagination
- Payment method details
- Customer account state and metadata
- Order history related to subscriptions
- Customer tags and notes

Subscription Data Included:
- All subscription contracts (active, paused, cancelled)
- Contract details with line items
- Billing and delivery policies
- Next billing dates and amounts
- Applied discounts

Pagination:
- Subscription contracts are paginated
- Default page size varies by Shopify plan
- Use cursor for subsequent pages
- Cursor-based pagination ensures consistency

Use Cases:
- Customer service representatives viewing customer details
- Integration with CRM systems
- Customer analytics and reporting
- Subscription management interfaces
- Billing reconciliation

Important Notes:
- Customer ID is numeric (without gid:// prefix)
- Returns null if customer not found
- Includes both active and inactive subscriptions
- Payment methods may be masked for security

Authentication: Requires valid X-API-Key header

Endpoint: GET /api/external/v2/subscription-customers/{id}
Version: 0.0.1

## Path parameters:

  - `id` (integer, required)
    Customer ID to retrieve. Provide the numeric ID without the gid:// prefix
    Example: 987654321

## Header parameters:

  - `X-API-Key` (string, required)
    API Key for authentication
    Example: "sk_live_1234567890abcdef"

## Query parameters:

  - `cursor` (string)
    Pagination cursor for subscription contracts. Use the cursor from previous response's pageInfo.endCursor to get the next page
    Example: "eyJsYXN0X2lkIjoxMjM0NTY3ODksImxhc3RfdmFsdWUiOiIyMDI0LTAxLTE1IDEwOjAwOjAwIn0="

  - `api_key` (string)
    API Key (Deprecated - Use X-API-Key header instead)

## Response 200 fields (application/json):

  - `get__typename` (string)

  - `id` (string)

  - `displayName` (string)

  - `firstName` (string)

  - `lastName` (string)

  - `email` (string)

  - `phone` (string)


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 500 fields