# Retrieve a Shipment

**GET /shipments/{shipment_id}**

Retrieve an existing Shipment record


## Servers
- https://api.arta.io: https://api.arta.io ()



## Parameters
### Headers
- **Authorization** (string)
  Authorize your API calls with an Arta API token

### Path parameters
- **shipment_id** (string)
  shipment_id parameter



## Responses
### 200
Successful Shipment get response
#### Headers
- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call

#### Body: application/json (object)
- **created_at** (string(date-time))
  A NaiveDatetime-formatted timestamp describing when the resource was created with microsecond precision
- **destination** (object)

- **eei_form_status** (string | null)
  The status of an associated electronic export information document required for customs clearance. Returns null if the shipment does not have an associated EEI Form
- **eei_form_url** (string | null)
  The URL for an associated electronic export information form required for customs clearance. Returns null if the shipment does not have an associated EEI Form
- **emissions** (string | null)
  The estimated CO2 emissions for the shipment
- **emissions_unit** (string | null)
  The unit of measurement for emissions for this shipment. Typically measured in "kg_co2e" or "kilograms of carbon dioxide equivalent"
- **exceptions** (array[object])
  Shipment exceptions provide context about holds, delays, and other circumstances that may interrupt a shipment's fulfillment
- **hosted_session_id** (integer | null)
  The ID of the HostedSession through which this shipment was created
- **id** (string(uuid))
  The id of the shipment in UUID format
- **insurance_policy** (object | null)

- **internal_reference** (string | null)
  This field can be used to pass through any character data that you may want returned unaltered for your own later usage
- **log_request_id** (string | null)
  A string identifying the API request that created the shipment. This `log_request_id` may be used to find the Log associated with the source API request
- **object_count** (integer(int64))
  The count of objects included in the shipment
- **origin** (object)

- **package_count** (integer(int64))
  The count of packages included in the shipment
- **packages** (array[object])

- **payment_process** (string)
  The primary method by which payment to Arta will be handled for any shipment booked through this hosted session
- **public_reference** (string | null)
  A client defined name for the resource. The value provided for the public_reference field may appear in notification emails and public web pages
- **quote_type** (string)
  The ID of the quote type associated with this shipment
- **schedule** (object)
  The schedule for the shipment
- **services** (array[object])
  A list of services included in the shipment
- **shipping_notes** (string | null)
  Any additional unstructured notes to Arta about the shipment
- **shortcode** (string)
  A brief identifier for this shipment
- **status** (string)
  The status for this shipment
- **tags** (array[object])
  A list of tags associated with the shipment
- **total** (string)

- **total_currency** (string)
  ISO 4217 three-letter alphabetic currency code. Options are defined in the Currencies metadata endpoint
- **tracking** (array[object])
  A list of tracking details for the packages in a shipment
- **updated_at** (string(date-time))
  A NaiveDatetime-formatted timestamp describing when the resource was last updated with microsecond precision
- **url** (string)
  The track URL for this shipment on the Arta web platform

### 404
Not Found
#### Headers
- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call

#### Body: application/json (object)
- **errors** (object)



[Powered by Bump.sh](https://bump.sh)