---
title: Essentras credentials for AI agents
description: Which credential an agent needs for each Essentras action. Short answer: none to search, quote and check; an optional API key for an account's own prices and wallet-paid orders.
url: https://essentras.com/auth.md
updated: 2026-10-19
---

# Credentials

Searching, quoting and the free checkers need no account, API key or OAuth grant. In that mode the only credential in the flow is the buyer's payment, and the buyer enters it on essentras.com, never through you.

An account holder can also give an integration an API key (created at https://essentras.com/account/api). With `Authorization: Bearer ess_live_...` the same REST and MCP endpoints return that account's own prices (including reseller price books) and can place orders paid from the account's prepaid wallet. Full reference: https://essentras.com/developers.

| What you do | Credential | Notes |
|---|---|---|
| Search outlets, read an outlet, read the product feed | none | `GET https://essentras.com/api/agent/v1/outlets`, `/outlets/{id}`, `/feed` |
| Price a basket and get `checkout_url` | none | `POST https://essentras.com/api/agent/v1/quote`; a quote reserves nothing |
| Run a free checker | none | `POST https://essentras.com/api/agent/v1/check/{name}`; inputs are fixed choices, never personal data |
| Connect over MCP | none | `https://essentras.com/api/mcp`, Streamable HTTP, stateless |
| Pay for an order (anonymous) | the buyer's own payment method | Only on the checkout page the buyer opens from `checkout_url`. Never ask the user for card details. |
| Your account's prices, wallet, orders | API key (optional) | `GET /api/agent/v1/me`, `/wallet`, `/orders`; scopes catalog:read, wallet:read, orders:read, orders:write |
| Place an order paid from the wallet | API key with orders:write | `POST /api/agent/v1/orders` with an `Idempotency-Key` header; MCP `create_order` needs `expected_total_usd` and `idempotency_key` |
| Track an order after payment | API key with orders:read, or the buyer's sign-in on essentras.com | `GET /api/agent/v1/orders/{id}` returns status and live links |

Higher limits for a partner integration: sales@essentras.com.

Back to the briefing: https://essentras.com/agents.md
