canonical: https://jentic.com/apis/adadiamonds.com/adadiamonds # Ada Diamonds Agent API The Ada Diamonds Agent API gives AI agents structured access to Ada Diamonds' live catalog of loose lab-grown diamonds, engagement ring settings, and fine jewelry, together with its published guides and showroom details. Catalog and content reads need no credential, while checkout, consultation booking, and customer-specific data require authorization. It supports batched reads, full catalog exports, and agent-commerce checkout sessions that charge and place an order. ## For AI agents Search Ada Diamonds' catalog of lab-grown diamonds, ring settings, and jewelry, read its guides, and run agent-commerce checkout sessions. ## Scope Does not handle diamond grading, shipping logistics, or post-sale support tickets. Use for browsing the Ada Diamonds catalog and completing checkout only. ## Capabilities - Search available loose lab-grown diamonds and read one by id - Search engagement ring settings and fine jewelry listings - Read published guides and showroom locations - Run several catalog reads in one batched request - Start and download a full catalog export job - Create and complete an agent-commerce checkout session ## Use cases ### Agent Shopping Assistant A shopper asks an agent to find an engagement ring within a budget. The Ada Diamonds API searches loose diamonds, ring settings, and jewelry, and reads one item by id, so the agent can assemble a setting-plus-stone recommendation and answer questions from the published guides, all from anonymous catalog reads. Example prompt: Search loose lab-grown diamonds and ring settings within a budget and return a setting-plus-stone recommendation ### Guided Agent Checkout Once a shopper picks an item, the agent needs to complete the purchase. The Ada Diamonds API creates an agent-commerce checkout session, updates it, and completes it to charge and place the order, so an authorized agent can take a selection all the way through to a placed order. Example prompt: Create a checkout session for a selected ring, update it with shipping details, and complete it to place the order ### Catalog Export and Sync A partner wants Ada Diamonds' full inventory loaded into its own system. The API starts a full catalog export as an async job and lets the caller download the finished export, so an agent can run a scheduled export and keep an external catalog mirror in sync. Example prompt: Start a full catalog export job, poll its status, and download the finished export ### Consultation Booking A high-consideration purchase often needs a human jeweler. The Ada Diamonds API requests a jeweler consultation and lists showroom locations and remote options, so an agent can hand a shopper off to a consultation and tell them where and how it can happen. Example prompt: Request a jeweler consultation for a shopper and return the available showroom and remote options ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/api/v1/diamonds` | Search available loose lab-grown diamonds | | GET | `/api/v1/engagement-rings` | Search engagement ring settings | | GET | `/api/v1/jewelry` | Search fine jewelry | | GET | `/api/v1/knowledge-base` | List published guides and articles | | POST | `/api/v1/batch` | Run several read requests in one call | | POST | `/api/v1/exports` | Start a full catalog export job | | POST | `/api/acp/checkout_sessions` | Create an agent-commerce checkout session | ## Key resources - **Catalog** — Search diamonds, ring settings, and jewelry and read items by id - **Content** — Read published guides and showroom locations - **Checkout** — Create, update, complete, and cancel agent-commerce checkout sessions - **Appointments** — Request jeweler consultations - **Onboarding** — Issue self-serve API keys and register agents ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 60 / 100 - **Maturity:** AI-Aware - **Dimensions:** - Foundational Compliance: 48 / 100 - Developer Experience & Jentic Compatibility: 67 / 100 - AI-Readiness & Agent Experience: 46 / 100 - Agent Usability: 94 / 100 - Security: 65 / 100 - AI Discoverability: 77 / 100 - **View full report:** https://jentic.com/apis/adadiamonds.com/adadiamonds/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the Ada Diamonds API by hand means choosing among API key, OAuth, and bearer auth and knowing which reads are anonymous. Through Jentic you install once, import it from the API Directory, store the credential once, and your agent calls it. - **Permission scoping:** You choose which Ada Diamonds operations your agent may call, so it can search the catalog and read content while the checkout, consultation, and export operations stay out of the set unless you add them. - **Credential handling:** Your Ada Diamonds 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 'search for lab-grown diamonds' or 'start a checkout session', and Jentic returns the matching Ada Diamonds operation with its input schema so the agent calls the right endpoint without browsing the reference docs. ## Related APIs - **Shopify API** — Shopify powers general online stores; Ada Diamonds is a purpose-built diamond and jewelry catalog with agent-commerce checkout. - **BigCommerce Catalog API** — BigCommerce manages a configurable product catalog; Ada Diamonds exposes a curated diamond and jewelry catalog read by agents. - **Stripe API** — Stripe processes the payment; Ada Diamonds handles the catalog and the checkout session that places the order. ## FAQ ### What authentication does the Ada Diamonds Agent API use? The Ada Diamonds Agent API accepts an API key header, an OAuth 2.0 token with authorization-code or client-credentials flows, and a bearer token for its agent-commerce checkout, per its OpenAPI spec. Catalog and content reads are open and need no credential; credentials raise rate limits and reach customer-specific operations. Through Jentic the credential is stored encrypted by your own Jentic One instance and injected at call time. ### Can I search the Ada Diamonds catalog without a credential? Yes. The catalog and content reads for loose diamonds, ring settings, jewelry, guides, and showrooms are open, so an agent can search and read them anonymously. A credential is only needed for checkout, consultations, exports, and customer-specific data. ### What are the rate limits for the Ada Diamonds Agent API? The OpenAPI spec notes that credentials raise rate limits but does not state fixed numbers. Check the Ada Diamonds documentation at https://www.adadiamonds.com for the current limits on anonymous and keyed access. ### How do I run a checkout through Jentic? Import the Ada Diamonds Agent API from the Jentic directory and give your agent an intent such as 'start a checkout session for a ring'. Jentic returns the checkout operation with its input schema, your agent creates, updates, and completes the session, and your stored credential is injected at execution time. To run it on your own infrastructure, install Jentic One from its GitHub repo. ### Can I limit what my agent is allowed to do with the Ada Diamonds Agent API? Yes. Write a rule that allows only the catalog and content read operations, so your agent can search diamonds and read guides but cannot start a checkout, book a consultation, or run an export, and every call it makes is logged. ### Is there an Ada Diamonds MCP server? You don't need an MCP server to give your agent the Ada Diamonds Agent API. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent calls it, so no extra server's tool definitions sit in the agent's context.