How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Elastic Path Imports API

You can import stock positions for up to 50,000 products in a single operation via an import. This is useful for synchronosing external systems with Elastic Path.The API uses a [**JSONL**](https://jsonlines.org/) file, with one line per product. For each product one specifies the total stock in each location. For example```{"data":{"type":"stock","id":"b36ba644-6fdc-49b3-9ebb-410ed34908a8","attributes":{"locations":{"vancouver":{"total":20}}}}}{"data":{"type":"stock","id":"2e5a4c7b-6f88-4aad-a3c2-4d8b29bc32a4","attributes":{"locations":{"vancouver":{"total":54},"denver":{"total":1},"boston":{"total":20},"portland":{"total":100}}}}}```### Characteristics of Inventories ImportThe Inventories Import API has the following characteristics:- The Inventories Import API reads the entire file and then updates the inventory.- Inventories imports are asynchronous and are processed one at a time. You can continue to send import requests, but these are queued. - If a product in an import does not already exist in the inventories database it will be created.

Elastic Path Imports API is one of 100 APIs that Elastic Path publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Imports. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 8 operations across 6 paths, and defines 31 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 4 base URLs: https://euwest.api.elasticpath.com/v2, https://useast.api.elasticpath.com/v2, https://euwest.api.elasticpath.com, https://useast.api.elasticpath.com.

8 operations 6 paths 31 schemas 6 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://useast.api.elasticpath.com
Authentication
HTTP Bearer, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Elastic Path Imports API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP bearer tokens (BearerToken).

Paths & Operations 8

Across 6 paths, the API surfaces 8 operations — 6 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Imports 8

You can import stock positions for up to 50,000 products in a single operation via an import. This is useful for synchronosing external systems with Elastic Path. The API uses a […

POST
/inventories/imports
Import a dataset
CreateImport body → 201400500
GET
/inventories/imports
List import jobs
ListImportJobs 3 params → 200500
GET
/inventories/imports/{import_uuid}
Get import
GetImport 3 params → 200400404500
GET
/inventories/imports/{import_uuid}/errors
Get import errors
GetImportErrors 3 params → 200404500
POST
/v2/subscriptions/imports
Import a dataset
CreateImport 1 param body → 201400409500
GET
/v2/subscriptions/imports
List import jobs
ListImportJobs 3 params → 200500
GET
/v2/subscriptions/imports/{import_uuid}
Get import
GetImport 3 params → 200400404500
GET
/v2/subscriptions/imports/{import_uuid}/errors
Get import errors
GetImportErrors 3 params → 200404500

Schemas 31

The contract defines 31 schemas that model the data the API accepts and returns. The most detailed are SubscriptionImportErrorMeta (6 properties), InventoriesImportErrorMeta (5 properties), Import (4 properties), Error_2 (4 properties). Each schema is shown below with its type and property counts.

JobTimestamps
InventoriesImportErrorType
string
LinkURI
stringnull
ImportAttributes
object
2 properties 1 required
Link
ImportMeta
object
2 properties 2 required
LinkObject
object
3 properties
ImportRecords
object
You can track the number of records imported to ensure the completeness, accuracy and integrity of the import. Uploaded shows the number of records ready to be…
2 properties 2 required
InventoriesImportError
object
3 properties 3 required
Error
object
4 properties 2 required
ExternalRef
string
A unique attribute that you could use to contain information from another company system, for example. The maximum length is 2048 characters.
Import
object
4 properties 4 required
UUID
string
The unique identifier.
Timestamps
object
2 properties 1 required
ErrorResponse
object
1 property 1 required
Links
object
InventoriesImportType
string
InventoriesImportErrorMeta
object
5 properties 4 required
SubscriptionImportError
object
3 properties 3 required
ImportAttributes_2
object
2 properties 1 required
ImportMeta_2
object
3 properties 3 required
SubscriptionImportType
string
OwnerMeta
string
The owner of a resource, either store or organization.
SubscriptionImportErrorType
string
ImportRecords_2
object
You can track the number of records imported to ensure the completeness, accuracy and integrity of the import. Uploaded shows the number of records ready to be…
2 properties 2 required
Error_2
object
4 properties 2 required
Import_2
object
4 properties 3 required
UUID_2
string
The unique identifier.
SubscriptionImportErrorMeta
object
6 properties 5 required
Timestamps_2
object
2 properties 2 required
ErrorResponse_2
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

elastic-path-imports-api-openapi.yml Raw ↑

Other APIs Elastic Path publishes across the network.

Elastic Path GraphQL API
Elastic Path Account Addresses API
Elastic Path Account Authentication Settings API
Elastic Path Account Cart Associations API
Elastic Path Account Management Authentication API
Elastic Path Account Members API
Elastic Path Account Membership API
Elastic Path Account Membership Settings API
Elastic Path Account Tags API
Elastic Path Accounts API
Elastic Path Administrator Latest Releases Catalog API API
Elastic Path Application Keys API
Where this information came from

This is an independent, third-party profile of Elastic Path Imports API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.