# Get Carrier Services

Retrieve available shipping services for a specific carrier based on the patient's location.

This endpoint returns pricing information for each available service, including whether free shipping applies.

Endpoint: GET /api/external/carriers/{carrierId}/services
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `carrierId` (string, required)
    The carrier ID (e.g., "se-3818360" for FedEx)
    Example: "se-3818360"

## Query parameters:

  - `patientId` (string, required)
    The patient's UUID to determine shipping location and eligibility
    Example: "01aabf3a-51cd-4180-be17-8ac9446e9ace"

## Response 200 fields (application/json):

  - `success` (boolean)
    Example: true

  - `data` (array)
    List of available shipping services

  - `data.id` (string)
    Unique identifier for the service
    Example: "fedex_ground"

  - `data.name` (string)
    Display name of the service
    Example: "FedEx Ground®"

  - `data.totalCost` (number)
    Cost to charge (0 if free shipping applies)

  - `data.originalCost` (number)
    Original cost before any discounts
    Example: 32.44

  - `isFreeShipment` (boolean)
    Whether free shipping applies for this patient
    Example: true

  - `freeShipmentType` (string,null)
    Type of free shipment (e.g., "clinic_specific") or null if not free
    Example: "clinic_specific"

  - `patientState` (string)
    The patient's state used for shipping calculation
    Example: "Alabama"

## Response 400 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}

## Response 401 fields (application/json):

  - `success` (boolean)

  - `error` (object)

  - `error.message` (string)
    Human-readable error message
    Example: "Validation error"

  - `error.details` (object)
    Additional error details
    Example: {}