# Kifly API

**Canonical:** https://apis.io/apis/kifly-ai/kifly-ai-api/  
**Provider:** Kifly — https://apis.io/providers/kifly-ai/  
**Documentation:** https://kifly.ai/docs/rest

Kifly API is one of 2 APIs that [Kifly](https://apis.io/providers/kifly-ai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 2 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 2 JSON Schemas.

Kifly API as documented publicly: 32 operations. Contract generated from the documentation by API Evangelist (2026-11-13); not the provider's own document.

## Operations (32)

| Method | Path | Summary |
|---|---|---|
| GET | `/.well-known/ucp` | UCP capability manifest |
| GET | `/api/agent/buyer/me` | get_preferences |
| GET | `/api/agent/buyer/orders` | get_orders |
| POST | `/api/agent/cart` | Create a cart |
| GET | `/api/agent/cart/{cartId}` | get_cart |
| POST | `/api/agent/cart/{cartId}/checkout` | checkout_handoff |
| DELETE | `/api/agent/cart/{id}` | Read or cancel a cart |
| POST | `/api/agent/cart/{id}/shipping-address` | Set the shipping address |
| GET | `/api/agent/docs/{slug}` | These pages as JSON |
| GET | `/api/agent/errors` | The machine‑readable version of this page, generated from the same source, is at GET /api/agent/errors — 105 codes. |
| POST | `/api/agent/feedback` | Report a problem |
| POST | `/api/agent/payment-link` | A payment link the buyer confirms |
| GET | `/api/agent/platform/limits` | Live cart limits |
| GET | `/api/agent/policies` | A seller's store policies |
| POST | `/api/agent/quick-buy` | Cart, item and address in one call |
| GET | `/api/agent/search` | GET /api/agent/search |
| GET | `/api/agent/seller` | One seller, by handle , domain or name |
| GET | `/api/agent/sellers` | List sellers |
| POST | `/api/developer/network-keys` | Create a network key for headless agents. |
| GET | `/api/mcp/openrpc.json` | MCP method contract (OpenRPC) |
| POST | `/api/ucp/rest/catalog/search` | POST /api/ucp/rest/catalog/search |
| POST | `/carts` | Create a cart |
| PUT | `/carts/{id}` | Read a cart, or replace its line items |
| POST | `/carts/{id}/cancel` | Cancel a cart |
| POST | `/catalog/lookup` | Products or variants by id, up to 20 |
| POST | `/catalog/product` | One product, with its options |
| POST | `/catalog/search` | Search the catalog |
| POST | `/checkout-sessions` | Create a checkout |
| PUT | `/checkout-sessions/{id}` | Read a checkout, or update its items and shipping address |
| POST | `/checkout-sessions/{id}/cancel` | Cancel a checkout |
| POST | `/checkout-sessions/{id}/complete` | Hand the checkout to the buyer |
| GET | `/orders/{id}` | The order, once the buyer has paid |

## Machine-readable artifacts (3)

- **OpenAPI** — https://artifacts.apis.io/kifly-ai/openapi/_ae-authored/kifly-ai-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/kifly-ai/json-schema/kifly-ai-get-api-agent-errors-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/kifly-ai/json-schema/kifly-ai-post-api-ucp-rest-catalog-search-request-schema.json

## Other Kifly APIs (1)

- [Kifly REST API](https://apis.io/apis/kifly-ai/rest/)

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/kifly-ai` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kifly-ai/kifly-ai-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kifly-ai/.
