Retrieve a specific shipping group for an order

GET 
https://useast.api.elasticpath.com/v2/orders/:orderID/shipping-groups/:shippingGroupID

Retrieve a specific shipping group for an order

Request

Path Parameters

orderID stringrequired

The ID of the order

shippingGroupID stringrequired

The ID of the shipping group

Responses

200

Shipping group details

application/json

Schema

Schema

data object

typestring

Possible values: [shipping_group]

idstring

relationstring

cart_idstring

order_idstring

shipping_typestring

tracking_referencestring

address object

first_namestringrequired

First name of the shipping recipient.

last_namestringrequired

Last name of the shipping recipient.

phone_numberstringrequired

Phone number of the shipping recipient.

company_namestringrequired

Company of the shipping recipient.

line_1stringrequired

First line of the shipping address.

line_2stringrequired

Second line of the shipping address.

citystringrequired

City of the shipping address.

postcodestringrequired

Post code of the shipping address.

countystringrequired

County of the shipping address.

countrystringrequired

Country of the shipping address.

regionstring

State, province, or region of the shipping address.

instructionsstringrequired

Delivery instructions.

delivery_estimate object

startstring<date-time>

endstring<date-time>

createdAtstring<date-time>

updatedAtstring<date-time>

relationships object

cart object

Relationship data entry

typestring

The type of related resource.

idstring<uuid>

The ID of the related resource.

order object

Relationship data entry

typestring

The type of related resource.

idstring<uuid>

The ID of the related resource.

discounts object[]

Array [

amount objectrequired

amountintegerrequired

Amount in minor currency units (e.g., cents).

currencystringrequired

ISO 4217 currency code (e.g., "USD").

includes_taxbooleanrequired

Whether the amount includes tax.

codestring

The discount code used, if applicable.

idstringrequired

Unique identifier for the discount.

promotion_sourcestring

The source or origin of the promotion, if applicable.

is_cart_discountboolean

Indicates whether the discount applies to the entire cart.

ordinalinteger

Order in which the discount was applied.

]

meta object

shipping_display_price object

total objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

base objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

tax object

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

fees object

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

discount object

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

total_display_price object

with_tax objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

without_tax objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

tax objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

discount objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

balance_owing objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

paid objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

authorized objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

without_discount objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

shipping objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

shipping_discount objectrequired

amountnumber

The raw total.

currencystring

The currency set for this amount.

formattedstring

The formatted total based on the amount and currency.

Example (auto)

{
  "data": {
    "type": "shipping_group",
    "id": "string",
    "relation": "string",
    "cart_id": "string",
    "order_id": "string",
    "shipping_type": "string",
    "tracking_reference": "string",
    "address": {
      "first_name": "string",
      "last_name": "string",
      "phone_number": "string",
      "company_name": "string",
      "line_1": "string",
      "line_2": "string",
      "city": "string",
      "postcode": "string",
      "county": "string",
      "country": "string",
      "region": "string",
      "instructions": "string"
    },
    "delivery_estimate": {
      "start": "2024-07-29T15:51:28.071Z",
      "end": "2024-07-29T15:51:28.071Z"
    },
    "createdAt": "2024-07-29T15:51:28.071Z",
    "updatedAt": "2024-07-29T15:51:28.071Z",
    "relationships": {
      "cart": {
        "type": "string",
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      },
      "order": {
        "type": "string",
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
      }
    },
    "discounts": [
      {
        "amount": {
          "amount": 0,
          "currency": "string",
          "includes_tax": true
        },
        "code": "string",
        "id": "string",
        "promotion_source": "string",
        "is_cart_discount": true,
        "ordinal": 0
      }
    ],
    "meta": {
      "shipping_display_price": {
        "total": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "base": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "tax": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "fees": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "discount": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        }
      },
      "total_display_price": {
        "with_tax": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "without_tax": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "tax": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "discount": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "balance_owing": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "paid": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "authorized": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "without_discount": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "shipping": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        },
        "shipping_discount": {
          "amount": 0,
          "currency": "string",
          "formatted": "string"
        }
      }
    }
  }
}

Example

{
  "data": {
    "id": "7cfa5b07-092e-4dbe-bbad-55a771a34117",
    "type": "shipping_group",
    "relation": "order",
    "order_id": "96b1d104-0d2e-41fd-9543-6c3c5a698959",
    "shipping_type": "standard",
    "tracking_reference": "TRACK123",
    "address": {
      "first_name": "John",
      "last_name": "Doe",
      "phone_number": "(555) 555-1234",
      "company_name": "ACME Corp",
      "line_1": "123 Main St",
      "line_2": "Suite 100",
      "city": "Portland",
      "postcode": "97201",
      "county": "Multnomah",
      "country": "US",
      "region": "Oregon",
      "instructions": "Leave at front door"
    },
    "delivery_estimate": {
      "start": "2024-01-15T00:00:00Z",
      "end": "2024-01-20T00:00:00Z"
    },
    "meta": {
      "shipping_display_price": {
        "total": {
          "amount": 1000,
          "currency": "USD",
          "formatted": "$10.00"
        },
        "base": {
          "amount": 800,
          "currency": "USD",
          "formatted": "$8.00"
        },
        "tax": {
          "amount": 200,
          "currency": "USD",
          "formatted": "$2.00"
        },
        "fees": {
          "amount": 0,
          "currency": "USD",
          "formatted": "$0.00"
        }
      }
    }
  }
}

404

Shipping group or order not found

application/json

Schema

Schema

errors object[]required
Array [
titlestringrequired
A brief summary of the error.
statusstring | integerrequired
The HTTP response code of the error.
detailstring
Optional additional detail about the error.
meta object
idstring
The resource id associated with the error
idsstring[]
item_idsstring[]
shipping_group_idstring
The shipping group id associated with the error
shipping_group_idsstring[]
cart_idstring
The cart id associated with the error
codestring
The code associated with the error.
order_idstring
The order id associated with the error.
valuestring | integer | boolean | object | array
The value associated with the error.
]

Example (auto)

{
  "errors": [
    {
      "title": "string",
      "status": "string",
      "detail": "string",
      "meta": {
        "id": "string",
        "ids": [
          "string"
        ],
        "item_ids": [
          "string"
        ],
        "shipping_group_id": "string",
        "shipping_group_ids": [
          "string"
        ],
        "cart_id": "string",
        "code": "string",
        "order_id": "string",
        "value": "string"
      }
    }
  ]
}

order_not_found

{
  "errors": [
    {
      "status": 404,
      "title": "Not Found",
      "detail": "Order not found"
    }
  ]
}

shipping_group_not_found

{
  "errors": [
    {
      "status": 404,
      "title": "Group not found",
      "detail": "Group with ID [7cfa5b07-092e-4dbe-bbad-55a771a34117] not found for order [abc123]"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://useast.api.elasticpath.com/v2/orders/:orderID/shipping-groups/:shippingGroupID");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://useast.api.elasticpath.com

Auth

Bearer Token

Parameters

orderID — pathrequired

shippingGroupID — pathrequired

ResponseClear

Click the Send API Request button above and see the response here!