Headers

• Authorization string Required

  Authorize your API calls with an Arta API token

Responses

• 200 application/json

  response

  Hide headers attributes Show headers attributes

  • content-type string
  • x-arta-request-id string

    A unique identifier for the Arta API call

  Hide response attributes Show response attributes object

  • created_at string

    A NaiveDatetime-formatted timestamp describing when the resource was created with microsecond precision

  • destination object
    Hide destination attributes Show destination attributes object

    • access_restrictions array[string] Deprecated

      Id of location restriction type

    • address_line_1 string

      First line of address

    • address_line_2 string | null

      Second line of address

    • address_line_3 string | null

      Third line of address

    • city string

      City

    • country string Required

      The ISO 3166-1 alpha-2 country code of the current or last known location if available

      Minimum length is 2, maximum length is 2.

    • postal_code string

      The postal code

    • region string

      Political region name, for US states and Canada provinces, use 2 letter abbreviations

    • title string

      The title or name of the location

    • contacts array[object]

      A list of contacts at the location

      Hide contacts attributes Show contacts attributes object

      • name string Required
      • email_address string
      • phone_number string
  • 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

    Values are null, pending, cleared, approved, rejected, or submitted.

  • 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 amount of projected emissions for this 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

    Hide exceptions attributes Show exceptions attributes object

    • created_at string

      A NaiveDatetime-formatted timestamp describing when the exception was created with microsecond precision

    • exception_type_label string | null

      An additional label providing context about the exception type (optional)

    • package_id integer | null

      The package associated with this exception (optional)

    • id string
    • resolution string | null

      A brief description of the method by which this exception was resolved

    • status string

      The current status for this exception

      Values are new, in_progress, or resolved.

    • type string

      The type of exception

    • updated_at string

      A NaiveDatetime-formatted timestamp describing when the exception was last updated with microsecond precision

  • hosted_session_id integer | null

    The ID of the HostedSession through which this shipment was created

  • id string
  • insurance_policy object | null
    Hide insurance_policy attributes Show insurance_policy attributes object | null

    • amount string
    • amount_currency string

      The currency of the insurance amount. Formatted as ISO 4217 three-letter alphabetic currency code

      Minimum length is 3, maximum length is 3. Format should match the following pattern: ^[A-Z]{3}$. Default value is USD.

    • id string
    • insured_value string
    • insured_value_currency string

      The currency of the insurance amount. Formatted as ISO 4217 three-letter alphabetic currency code

      Minimum length is 3, maximum length is 3. Format should match the following pattern: ^[A-Z]{3}$. Default value is USD.

  • 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

    Maximum length is 255.

  • 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 number

    The count of objects included in the shipment

  • origin object
    Hide origin attributes Show origin attributes object

    • access_restrictions array[string] Deprecated

      Id of location restriction type

    • address_line_1 string

      First line of address

    • address_line_2 string | null

      Second line of address

    • address_line_3 string | null

      Third line of address

    • city string

      City

    • country string Required

      The ISO 3166-1 alpha-2 country code of the current or last known location if available

      Minimum length is 2, maximum length is 2.

    • postal_code string

      The postal code

    • region string

      Political region name, for US states and Canada provinces, use 2 letter abbreviations

    • title string

      The title or name of the location

    • contacts array[object]

      A list of contacts at the location

      Hide contacts attributes Show contacts attributes object

      • name string Required
      • email_address string
      • phone_number string
  • package_count number

    The count of packages included in the shipment

  • packages array[object]
    Hide packages attributes Show packages attributes object

    • depth string
    • eta string | null

      The expected delivery date for this package in the MM/DD/YYYY format

    • handle_with_care boolean
    • height string
    • id integer

      The ID of the package

    • is_sufficiently_packed boolean
    • objects array[object]
      Hide objects attributes Show objects attributes object

      • current_packing array[string]

        A list of packing subtype IDs describing how the item is currently packed

      • depth string

        The depth of the object

      • details object
        Hide details attributes Show details attributes object

        • creation_date string | null

          The creation timing for the object

        • creator string

          The creator of the object

        • is_fragile boolean

          Set this flag to true is the item is fragile. This may effect packing and handling costs

          Default value is false.

        • is_cites boolean

          Set to true if the object is governed by the Convention on International Trade in Endangered Species of Wild Fauna and Flora

          Default value is false.

        • materials array[string]

          A list of ids the types of materials used

        • title string

          The object title

      • height string

        The height of the object

      • id integer

        The system-generated ID for this object

      • images array[string(uri)]

        A list image urls of the object

      • 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

        Maximum length is 255.

      • public_reference string | null

        A client defined name for the object. The value provided for public_reference may be presented in notification emails and on shipment detail pages

        Maximum length is 255.

      • subtype string

        The object sub-type id

        Format should match the following pattern: ^[0-9a-z_]{1,56}$.

      • type string

        The object type id

        Format should match the following pattern: ^[0-9a-z_]{1,56}$.

      • unit_of_measurement string

        Values are in or cm.

      • value string

        Format should match the following pattern: ^(0|([1-9]+[0-9]*))(\.[0-9]{1,2})?$.

      • value_currency string

        ISO 4217 three-letter alphabetic currency code. Options are defined in the Currencies metadata endpoint

        Minimum length is 3, maximum length is 3. Format should match the following pattern: ^[A-Z]{3}$. Default value is USD.

      • weight string | null

        The weight of the object

      • weight_unit string

        Values are lb or kg.

      • width string

        The width of the object

    • packing_materials array[string]

      The id of a material.

    • status string | null

      The current delivery status for this package

      Values are pending, transit, out_for_delivery, delivered, unknown, notfound, undelivered, exception, or expired.

    • unit_of_measurement string
    • weight string
    • weight_unit string
    • width string
  • payment_process string

    The primary method by which payment to Arta will be handled for this shipment

    Values are checkout or invoicing.

  • 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

    Maximum length is 255.

  • quote_type string

    The ID of the quote type associated with this shipment

    Values are parcel, premium, select, self_ship, or track.

  • schedule object
    Hide schedule attributes Show schedule attributes object

    • delivery_end string | null
    • delivery_start string | null
    • delivery_window_modifier string

      A qualifying word indicating how delivery_start and delivery_end together shape the delivery window. When present, values may be "after," "by," "on," or "between"

    • pickup_end string | null
    • pickup_start string | null
    • pickup_window_modifier string

      A qualifying word indicating how pickup_start and pickup_end together shape the pickup window. When present, values may be "after," "by," "on," or "between"

  • services array[object]
    Hide services attributes Show services attributes object

    • amount string
    • amount_currency string
    • included_services array
    • is_requested boolean
    • is_required boolean
    • name string
    • sub_subtype string
    • subtype string
    • type string
  • 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

    Maximum length is 255. Values are pending, confirmed, collected, in_transit, or completed.

  • total string

    Format should match the following pattern: ^(0|([1-9]+[0-9]*))(\.[0-9]{1,2})?$.

  • total_currency string

    The currency of the total. Formatted as ISO 4217 three-letter alphabetic currency code

    Minimum length is 3, maximum length is 3. Format should match the following pattern: ^[A-Z]{3}$. Default value is USD.

  • tracking array[object]

    A list of tracking details for the packages in a shipment

    Hide tracking attributes Show tracking attributes object

    • carrier_name string

      The name of the carrier providing transport services for a specific package

    • label_url string | null

      A URL at which parcel package shipping labels may be downladed and printed

    • package_id integer

      The ID associated with the tracking detail's corresponding package

    • tracking_number string

      The carrier-providing tracking number for this package

    • url string

      A carrier-provided URL for fetching delivery events related to this package's transport

  • updated_at string

    A NaiveDatetime-formatted timestamp describing when the resource was last updated with microsecond precision

  • url string(uri)

    The track URL for this shipment on the Arta web platform

• 404 application/json

  Resource Not Found

  Hide headers attributes Show headers attributes

  • content-type string
  • x-arta-request-id string

    A unique identifier for the Arta API call

  Hide response attribute Show response attribute object

  • errors object
    Hide errors attribute Show errors attribute object

    • detail string
• 422 application/json

  Unprocessable Entity (WebDAV)