canonical: https://jentic.com/apis/walmart.com/item-api

# Walmart Item API

Please make sure you use the correct version of the APIs for your use case. To find out the appropriate version, go to the API Docs drop down on the menu. The API exposes 6 endpoints.

## For AI agents

Programmatically upload an item feed, get status of an item feed. Covers 6 operations.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Upload an item feed
- Get status of an item feed
- Integrate Item API into automated workflows
- Query and filter Item API records by parameters
- Monitor Item API operational status and events

## Use cases

### Developer Tools Operations

Use the Item API to perform developer tools operations programmatically. The API provides 6 endpoints covering core functionality including upload an item feed, get status of an item feed, get status of an item within a feed.

Example prompt: Call POST /v2/feeds to upload an item feed

### Automated Version 2 Management

Automate version 2 operations by combining multiple Item API endpoints. Agents can get status of an item feed and then get status of an item within a feed in a single workflow.

Example prompt: Call GET /v2/feeds to get status of an item feed, then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Item API endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle none tokens manually.

Example prompt: Search Jentic for 'upload an item feed', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /v2/feeds | Upload an item feed |
| GET | /v2/feeds | Get status of an item feed |
| GET | /v2/feeds/{feedId} | Get status of an item within a feed |
| POST | /v3/feeds | Upload an item feed |
| GET | /v3/feeds | Get status of an item feed |
| GET | /v3/feeds/{feedId} | Get status of an item within a feed |

## Key resources

- **Version 2** — Operations related to Version 2
- **Version 3** — Operations related to Version 3

## Why Jentic

- **Setup:** Wiring the Walmart Item API by hand means pointing at the developer.walmart.com item proxy host, handling both the v2 and v3 feed routes, and authenticating each request yourself. Through Jentic you install once, import the Item API from the API Directory, store your Walmart credential once, and your agent calls it.
- **Permission scoping:** The Item API puts the feed id in the URL path (/v3/feeds/{feedId}), so a rule can pin your agent to one feed. You choose the operations it may call, so you can allow submitting a feed and checking its status while other operations are not included unless you add them.
- **Credential handling:** Your Walmart credential is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'upload an item feed' or 'check feed status', and Jentic returns the matching Item API operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the Item API use?

The Item API uses no authentication. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I upload an item feed with the Item API?

Yes. Use the POST /v2/feeds endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Item API?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I upload an item feed through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'upload an item feed'. Jentic returns the matching Item API operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Item API have?

The Item API exposes 6 endpoints covering version 2, version 3 operations.

### Can I limit what my agent is allowed to do with the Walmart Item API?

Yes. Jentic One is self-hosted, so your own rules decide which Item API operations and credentials the agent may use. You can allow it to submit a feed with POST /v2/feeds or /v3/feeds and check status with GET /v2/feeds or /v3/feeds while leaving every other operation out unless you add it. Because the feed id sits in the URL path at /v3/feeds/{feedId}, you can also pin the agent to a single feed rather than all of them.