List Import Cost Estimates

GET /import_cost_estimates

Availability: Public Preview

This endpoint is currently in public preview and available only to approved accounts. Please contact Arta to request access for your organization.

Retrieve a paginated collection of import cost estimates belonging to your organization.

Headers

  • Authorization string Required

    Authorize your API calls with an Arta API token

Query parameters

  • page integer

    Page number of the results to fetch.

    Default value is 1.

  • page_size integer

    Results per page (max 50)

    Default value is 20.

Responses

  • 200 application/json

    A collection of Import Cost Estimate records

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • items array[object]
      Hide items attributes Show items attributes object
      • 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.

      • Details about the destination where it will be imported to

        Hide destination attributes Show destination attributes object
        • city string | null
        • country string

          ISO 3166-1 alpha-2 country code of the destination

        • postal_code string | null
        • region string | null

          State, province, or region of the destination.

      • end_use string | null

        The end use of the goods

        Values are for_resale or not_for_resale.

      • estimate object

        Breakdown of the estimated import costs

        Hide estimate attributes Show estimate attributes object
        • line_items array[object]

          Detailed breakdown of individual charges

          Hide line_items attributes Show line_items attributes object
          • amount string

            Amount of the charge in the estimate currency

          • Description of the charge

          • subtype string

            Subtype classification of the charge

          • type string

            Type of charge (e.g., duty, tax, fee)

        • summary object

          Summary totals of the import cost estimate

          Hide summary attributes Show summary attributes object
      • id string(uuid)

        Unique identifier for the import cost estimate

      • objects array[object]

        List of objects/items being imported

        Hide objects attributes Show objects attributes object
        • country_of_origin string | null

          ISO 3166-1 alpha-2 country code where the object originated

        • hs_code string

          Harmonized System (HS) tariff code for the object

        • quantity number | null

          Quantity of the object

        • reference string | null

          Reference identifier for the object

        • value string

          Declared value of the object

        • value_currency string | null

          Currency code (ISO 4217) used for the object's declared value

      • origin object

        Details about the origin location

        Hide origin attribute Show origin attribute object
        • country string

          ISO 3166-1 alpha-2 country code of the origin

      • reference string | null

        Reference string for identifying the estimate in your systems

      • Short automatically generated reference code for the identifying import cost estimate in Arta's system

      • status string

        Status of the import cost estimate calculation

        Values are failed or success.

      • Information about the transport method and cost

        Hide transport attributes Show transport attributes object
        • amount string

          Total transport cost

        • amount_currency string | null

          Currency code (ISO 4217) for the transport amount

        • Service level for transport (e.g., ups_expedited, fedex_international_first etc). Options are listed in the reference rate service levels metadata endpoint

    • metadata object
      Hide metadata attributes Show metadata attributes object
GET /import_cost_estimates
curl \
 --request GET 'https://api.arta.io/import_cost_estimates' \
 --header "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y"
Response examples (200)
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
{
  "items": [
    {
      "id": "30e1d8e7-f175-46c7-afee-8aa16c9d988b",
      "origin": {
        "country": "BR"
      },
      "status": "success",
      "end_use": "for_resale",
      "objects": [
        {
          "value": "10869.45",
          "hs_code": "691390",
          "quantity": 1,
          "reference": "ceramic-vase-maria-lundqvist",
          "value_currency": "USD",
          "country_of_origin": null
        }
      ],
      "currency": "USD",
      "estimate": {
        "summary": {
          "fees": "147.13",
          "taxes": "1754.97",
          "duties": "2119.53"
        },
        "line_items": [
          {
            "type": "duty",
            "amount": "706.51",
            "subtype": "item",
            "description": "duty"
          }
        ]
      },
      "reference": null,
      "shortcode": "JANANI-I5Y6SR",
      "transport": {
        "amount": "20000.00",
        "service_level": "ups_expedited",
        "amount_currency": "USD"
      },
      "destination": {
        "city": null,
        "region": "ON",
        "country": "CA",
        "postal_code": null
      }
    }
  ],
  "metadata": {
    "page": 1,
    "page_size": 20,
    "total_count": 1
  }
}