Skip to content

List Connected Order Sources

This endpoint returns all connected order sources using the ShipEngine API.

API Endpoint

GET /v-beta/order_sources

Example Request

GET /v-beta/order_sources HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__

Example Response

{
  "order_sources": [
    {
      "order_source_id": "__YOUR_ORDER_SOURCE_ID_HERE__",
      "order_source_nickname": "My Shopify account",
      "order_source_code": "shopify",
      "order_source_friendly_name": "Shopify",
      "refresh_info": {
        "status": "preparing_update",
        "last_refresh_attempt": null,
        "refresh_date": "2018-02-10T20:55:46.673Z"
      },
      "active": true
    }
  ]
}

Response Fields

The response contains an array of order sources with the following properties:

FieldTypeDescription
order_source_idstringUnique identifier for the order source
order_source_nicknamestringCustom name for the order source
order_source_codestringPlatform code (e.g., "shopify")
order_source_friendly_namestringDisplay name of the platform
refresh_infoobjectSync status information
activebooleanWhether the connection is active

Refresh Info Object

FieldTypeDescription
statusstringCurrent refresh status
last_refresh_attemptdate stringTimestamp of last sync attempt
refresh_datedate stringNext scheduled refresh date