---
title: "List fulfillments"
method: GET
path: "/v2/fulfillments"
tags: ["fulfillments"]
---

# List fulfillments

`GET /v2/fulfillments`

<aside class="access" aria-label="Endpoint access">
      <table class="access__table">
        <thead>
          <tr>
            <th class="access__table-header">Products</th>
            <th class="access__table-header">Plans</th>
          </tr>
        </thead>
        <tbody>
          <tr>
            <td class="access__table-cell access__product">
              <img class="access__logo" src="/static/logos/shipstation-api-logo.svg" alt="ShipStation API Logo" loading="lazy" decoding="async"/>
              <div class="access__sub">Formerly ShipEngine</div>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-free.md" class="access__plan">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Advanced</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-api-advanced-enterprise.md" class="access__plan">Enterprise</a>
            </td>
          </tr>
          <tr>
            <td class="access__table-cell">
              <img class="access__logo" src="/static/logos/shipstation-logo.svg" alt="ShipStation Logo" loading="lazy" decoding="async"/>
            </td>
            <td class="access__table-cell access__plans">
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Free</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-free-starter.md" class="access__plan access__plan--off">Starter</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Standard</a>
              <a href="/apis/@shipstation-v2/docs/getting-started/plans/shipstation-standard-premium.md" class="access__plan">Premium</a>
            </td>
          </tr>
        </tbody>
      </table>
      <footer class="access__footer">
        <a class="access__help" href="/apis/@shipstation-v2/docs/getting-started/products-and-plans.md">
          Learn about products and plans
          <img src="/static/icons/external-link.svg" alt="External Link Icon" style="width: 16px;" loading="lazy" decoding="async"/>
        </a>
      </footer>
    </aside>

Retrieve a list of fulfillments based on various filter criteria. You can filter by shipment details,
tracking information, dates, and more to find the specific fulfillments you need.

## Query parameters

- `ship_to_name` string
- `ship_to_country_code` string
- `shipment_number` string
- `shipment_id` string
- `fulfillment_id` string
- `batch_id` string
- `order_source_id` string
- `fulfillment_provider_code` string
- `tracking_number` string
- `ship_date_start` string, date-time
- `ship_date_end` string, date-time
- `create_date_start` string, date-time
- `create_date_end` string, date-time
- `page` integer
- `page_size` integer
- `sort_dir` 'asc' | 'desc'
- `sort_by` 'created_at' | 'modified_at' | 'shipped_at'

## Response `200`

The request was a success.

- object
  - `fulfillments` Fulfillment[]
    - `fulfillment_id` string — Unique identifier for the fulfillment
    - `shipment_id` string — The associated shipment id
    - `shipment_number` string — The shipment number (order number)
    - `user_id` string — The user id that created this fulfillment
    - `tracking_number` string — Tracking number for the shipment
    - `created_at` string, date-time — Date and time when the fulfillment was created
    - `ship_date` string, date-time — Date when the shipment was shipped
    - `voided_at` string, date-time, nullable — Date and time when the fulfillment was voided
    - `delivered_at` string, date-time, nullable — Date and time when the shipment was delivered
    - `fulfillment_carrier_friendly_name` string — Friendly name of the carrier
    - `fulfillment_provider_id` string, nullable — Fulfillment provider ID
    - `fulfillment_provider_friendly_name` string, nullable — Friendly name of the fulfillment provider
    - `fulfillment_provider_code` string, nullable — Code of the fulfillment provider
    - `fulfillment_service_code` string, nullable — Service code used for fulfillment
    - `fulfillment_fee` MonetaryValue — A monetary value, such as the price of a shipping label, the insured value of a package, or an account balance.
      - `currency` string, required — The currencies that are supported by ShipStation are the ones that specified by ISO 4217: https://www.iso.org/iso-4217-currency-codes.html
      - `amount` number, required — The monetary amount, in the specified currency.
    - `void_requested` boolean — Whether a void has been requested for this fulfillment
    - `voided` boolean — Whether this fulfillment has been voided
    - `order_source_notified` boolean — Whether the order source has been notified
    - `notification_error_message` string, nullable — Error message if notification failed
    - `ship_to` object — Shipping address information
      - `name` string — Recipient name
      - `company_name` string, nullable — Company name
      - `email` string, nullable — Email address
      - `phone` string, nullable — Phone number
      - `address_line1` string — Street address line 1
      - `address_line2` string, nullable — Street address line 2
      - `address_line3` string, nullable — Street address line 3
      - `city_locality` string — City or locality
      - `state_province` string — State or province
      - `postal_code` string — Postal or ZIP code
      - `country_code` string — ISO country code
  - `page` integer — Current page number
  - `pages` integer — Total number of pages
  - `total` integer — Total number of fulfillments
  - `links` object
    - `first` object
      - `href` string
    - `last` object
      - `href` string
    - `prev` object
      - `href` string
    - `next` object
      - `href` string

## Other responses

- `400` — The request contained errors.
- `404` — The specified resource does not exist.
- `500` — The request was successful.

---

[API](https://skmtc.net/shipstation/apis/shipstation-api-v2.md) · [All operations](https://skmtc.net/shipstation/apis/shipstation-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shipstation/shipstation-api-v2/revisions/d3d8c21cd227/schema)