# Get subscription order fulfillment details

Retrieves fulfillment information for the most recent order generated by a subscription contract. Shows shipping status, tracking numbers, and delivery progress.

Key Features:
- Latest Order: Returns fulfillment data for the most recent subscription order
- Tracking Info: Includes tracking numbers, URLs, and shipping carriers
- Fulfillment Status: Shows whether items are unfulfilled, fulfilled, or partially fulfilled
- Multi-Fulfillment: Handles orders split across multiple shipments

Returned Fulfillment Data:
- Order Info: Order name/number, creation date, financial status
- Fulfillment Status: FULFILLED, PARTIAL, UNFULFILLED, etc.
- Fulfillments List: Array of all fulfillments for the order
- Tracking Numbers: Tracking codes for each fulfillment
- Tracking URLs: Direct links to carrier tracking pages
- Shipping Carrier: Carrier name (USPS, FedEx, UPS, etc.)
- Fulfillment Date: When each shipment was fulfilled
- Line Items: Which products/variants are in each shipment
- Delivery Address: Where the order is being shipped

Common Use Cases:
- Order Tracking: Show customers where their subscription delivery is
- Customer Portal: Display "Track Your Order" links
- Shipping Updates: Check fulfillment status for recent orders
- Support: Help customers track delayed or missing shipments
- Notifications: Trigger custom shipping notifications
- Analytics: Track fulfillment performance metrics

Response Structure:
Returns an Order object containing:
- Basic order information
- Array of fulfillments with tracking details
- Line items per fulfillment
- Shipping and delivery information

Note: This returns data for the MOST RECENT order only. For historical fulfillment data, use order history endpoints.

Parameters:
- contractId (required, path): The subscription contract ID

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

Endpoint: GET /api/external/v2/subscription-contract-details/subscription-fulfillments/{contractId}
Version: 0.0.1

## Path parameters:

  - `contractId` (integer, required)
    Subscription contract ID
    Example: 12345

## Query parameters:

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

## Header parameters:

  - `X-API-Key` (string)

## Response 200 fields (application/json):

  - `get__typename` (string)

  - `id` (string)

  - `fulfillmentOrders` (object)

  - `fulfillmentOrders.nodes` (array)

  - `fulfillmentOrders.pageInfo` (object)

  - `fulfillmentOrders.pageInfo.hasPreviousPage` (boolean)

  - `fulfillmentOrders.pageInfo.hasNextPage` (boolean)

  - `fulfillmentOrders.pageInfo.startCursor` (string)

  - `fulfillmentOrders.pageInfo.endCursor` (string)

## Response 400 fields (*/*):

  - `get__typename` (string)

  - `id` (string)

  - `fulfillmentOrders` (object)

  - `fulfillmentOrders.nodes` (array)

  - `fulfillmentOrders.pageInfo` (object)

  - `fulfillmentOrders.pageInfo.hasPreviousPage` (boolean)

  - `fulfillmentOrders.pageInfo.hasNextPage` (boolean)

  - `fulfillmentOrders.pageInfo.startCursor` (string)

  - `fulfillmentOrders.pageInfo.endCursor` (string)

## Response 401 fields (*/*):

  - `get__typename` (string)

  - `id` (string)

  - `fulfillmentOrders` (object)

  - `fulfillmentOrders.nodes` (array)

  - `fulfillmentOrders.pageInfo` (object)

  - `fulfillmentOrders.pageInfo.hasPreviousPage` (boolean)

  - `fulfillmentOrders.pageInfo.hasNextPage` (boolean)

  - `fulfillmentOrders.pageInfo.startCursor` (string)

  - `fulfillmentOrders.pageInfo.endCursor` (string)

## Response 404 fields (*/*):

  - `get__typename` (string)

  - `id` (string)

  - `fulfillmentOrders` (object)

  - `fulfillmentOrders.nodes` (array)

  - `fulfillmentOrders.pageInfo` (object)

  - `fulfillmentOrders.pageInfo.hasPreviousPage` (boolean)

  - `fulfillmentOrders.pageInfo.hasNextPage` (boolean)

  - `fulfillmentOrders.pageInfo.startCursor` (string)

  - `fulfillmentOrders.pageInfo.endCursor` (string)

## Response 500 fields (*/*):

  - `get__typename` (string)

  - `id` (string)

  - `fulfillmentOrders` (object)

  - `fulfillmentOrders.nodes` (array)

  - `fulfillmentOrders.pageInfo` (object)

  - `fulfillmentOrders.pageInfo.hasPreviousPage` (boolean)

  - `fulfillmentOrders.pageInfo.hasNextPage` (boolean)

  - `fulfillmentOrders.pageInfo.startCursor` (string)

  - `fulfillmentOrders.pageInfo.endCursor` (string)