Kifly API

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

GitHub OpenAPI

Operations 32

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/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 #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kifly-ai:kifly-ai-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kifly-ai-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Kifly API
  version: '2026-11-13'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-13: 32 operation(s) read from 9 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Kifly has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 2
    documentation: 30
    pages-with-code: 1
    pages-read: 9
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-13'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://kifly.ai/docs/rest
  - https://kifly.ai/docs/errors
  - https://kifly.ai/docs/overview
  - https://kifly.ai/docs/mcp
  - https://kifly.ai/docs/playbook
  - https://kifly.ai/docs/commerce-agents
  - https://kifly.ai/docs/payment-rails
  - https://kifly.ai/docs/limits
  - https://kifly.ai/docs
paths:
  /.well-known/ucp:
    get:
      operationId: get_well_known_ucp
      tags:
      - API
      summary: UCP capability manifest
      x-source: https://kifly.ai/docs/rest
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/buyer/me:
    get:
      operationId: get_api_agent_buyer_me
      tags:
      - Api
      summary: get_preferences
      x-source: https://kifly.ai/docs/commerce-agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/buyer/orders:
    get:
      operationId: get_api_agent_buyer_orders
      tags:
      - Api
      summary: get_orders
      x-source: https://kifly.ai/docs/commerce-agents
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/cart:
    post:
      operationId: post_api_agent_cart
      tags:
      - Api
      summary: Create a cart
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/cart/{cartId}:
    get:
      operationId: get_api_agent_cart_cartId
      tags:
      - Api
      summary: get_cart
      x-source: https://kifly.ai/docs/commerce-agents
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/cart/{cartId}/checkout:
    post:
      operationId: post_api_agent_cart_cartId_checkout
      tags:
      - Api
      summary: checkout_handoff
      x-source: https://kifly.ai/docs/commerce-agents
      parameters:
      - name: cartId
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/cart/{id}:
    delete:
      operationId: delete_api_agent_cart_id
      tags:
      - Api
      summary: Read or cancel a cart
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/cart/{id}/shipping-address:
    post:
      operationId: post_api_agent_cart_id_shipping_address
      tags:
      - Api
      summary: Set the shipping address
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/docs/{slug}:
    get:
      operationId: get_api_agent_docs_slug
      tags:
      - Api
      summary: These pages as JSON
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: slug
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/errors:
    get:
      operationId: get_api_agent_errors
      tags:
      - Api
      summary: The machine‑readable version of this page, generated from the same source, is at GET /api/agent/errors — 105 codes.
      x-source: https://kifly.ai/docs/errors
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiAgentErrorsResponse'
      x-evidence:
        kind: documentation
  /api/agent/feedback:
    post:
      operationId: post_api_agent_feedback
      tags:
      - Api
      summary: Report a problem
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/payment-link:
    post:
      operationId: post_api_agent_payment_link
      tags:
      - Api
      summary: A payment link the buyer confirms
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/platform/limits:
    get:
      operationId: get_api_agent_platform_limits
      tags:
      - Api
      summary: Live cart limits
      x-source: https://kifly.ai/docs/rest
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/policies:
    get:
      operationId: get_api_agent_policies
      tags:
      - Api
      summary: A seller's store policies
      x-source: https://kifly.ai/docs/rest
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/quick-buy:
    post:
      operationId: post_api_agent_quick_buy
      tags:
      - Api
      summary: Cart, item and address in one call
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/search:
    get:
      operationId: get_api_agent_search
      tags:
      - Api
      summary: GET /api/agent/search
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sS 'https://kifly.ai/api/agent/search?q=hat&limit=3'  -H 'UCP-Agent: profile=\"https://your-agent.example/.well-known/ucp\"\
          '\n Copy \n Open endpoints \n These accept UCP-Agent or a credential. \n Method Path What it does GET /api/agent/search Search or browse\
          \ the catalog GET /api/agent/sellers List sellers GET /api/agent/seller One seller, by handle , domain or name GET /api/agent/policies\
          \ A selle"
  /api/agent/seller:
    get:
      operationId: get_api_agent_seller
      tags:
      - Api
      summary: One seller, by handle , domain or name
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: handle
        in: query
        required: false
        schema:
          type: string
        description: seller handle
      - name: domain
        in: query
        required: false
        schema:
          type: string
        description: seller domain
      - name: name
        in: query
        required: false
        schema:
          type: string
        description: seller name
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/agent/sellers:
    get:
      operationId: get_api_agent_sellers
      tags:
      - Api
      summary: List sellers
      x-source: https://kifly.ai/docs/rest
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/developer/network-keys:
    post:
      operationId: post_api_developer_network_keys
      tags:
      - Api
      summary: Create a network key for headless agents.
      x-source: https://kifly.ai/docs/mcp
      parameters:
      - name: Authorization
        in: header
        required: true
        schema:
          type: string
        description: Bearer token using a network key (kfn_live_).
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/mcp/openrpc.json:
    get:
      operationId: get_api_mcp_openrpc_json
      tags:
      - Api
      summary: MCP method contract (OpenRPC)
      x-source: https://kifly.ai/docs/rest
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/ucp/rest/catalog/search:
    post:
      operationId: post_api_ucp_rest_catalog_search
      tags:
      - Api
      summary: POST /api/ucp/rest/catalog/search
      x-source: https://kifly.ai/docs/rest
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiUcpRestCatalogSearchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -sS -X POST 'https://kifly.ai/api/ucp/rest/catalog/search'  -H 'UCP-Agent: profile=\"https://your-agent.example/.well-known/ucp\"\
          '  -H 'Content-Type: application/json'  -d '{\"query\":\"linen shirt\"}'\n Copy \n Identify with UCP-Agent , as above. Your profile\
          \ must declare each capability you call, at the version in Kifly's profile ( 2026-08-25 ). \n Writes (every PUT , and every POST except\
          \ the three"
  /carts:
    post:
      operationId: post_carts
      tags:
      - Carts
      summary: Create a cart
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /carts/{id}:
    put:
      operationId: put_carts_id
      tags:
      - Carts
      summary: Read a cart, or replace its line items
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /carts/{id}/cancel:
    post:
      operationId: post_carts_id_cancel
      tags:
      - Carts
      summary: Cancel a cart
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /catalog/lookup:
    post:
      operationId: post_catalog_lookup
      tags:
      - Catalog
      summary: Products or variants by id, up to 20
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /catalog/product:
    post:
      operationId: post_catalog_product
      tags:
      - Catalog
      summary: One product, with its options
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /catalog/search:
    post:
      operationId: post_catalog_search
      tags:
      - Catalog
      summary: Search the catalog
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /checkout-sessions:
    post:
      operationId: post_checkout_sessions
      tags:
      - Checkout Sessions
      summary: Create a checkout
      x-source: https://kifly.ai/docs/rest
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /checkout-sessions/{id}:
    put:
      operationId: put_checkout_sessions_id
      tags:
      - Checkout Sessions
      summary: Read a checkout, or update its items and shipping address
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /checkout-sessions/{id}/cancel:
    post:
      operationId: post_checkout_sessions_id_cancel
      tags:
      - Checkout Sessions
      summary: Cancel a checkout
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /checkout-sessions/{id}/complete:
    post:
      operationId: post_checkout_sessions_id_complete
      tags:
      - Checkout Sessions
      summary: Hand the checkout to the buyer
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /orders/{id}:
    get:
      operationId: get_orders_id
      tags:
      - Orders
      summary: The order, once the buyer has paid
      x-source: https://kifly.ai/docs/rest
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    GetApiAgentErrorsResponse:
      type: object
      properties:
        error:
          type: string
          description: Error identifier (always present).
        code:
          type: string
          description: Machine‑readable error code (always present).
        fix:
          type: string
          description: Suggested fix action (always present).
        retryable:
          type: boolean
          description: Whether the call can be retried (always present).
        docs:
          type: string
          description: URL to documentation for this error (always present).
        request_id:
          type: string
          description: Identifier for the request (always present).
        message:
          type: string
          description: Human‑readable message (present where they add something).
        next_step:
          type: string
          description: Suggested next step (present where they add something).
        required_scope:
          type: string
          description: Scope required for the call (present where they add something).
        retry_after_seconds:
          type: integer
          description: Seconds to wait before retrying (present where they add something).
        details:
          type: object
          description: Additional structured details (present where they add something).
    PostApiUcpRestCatalogSearchRequest:
      type: object
      properties:
        query:
          type: string
  securitySchemes:
    Seller_API_key:
      type: http
      scheme: bearer
      x-source: https://kifly.ai/docs/mcp
    Network_key:
      type: http
      scheme: bearer
      x-source: https://kifly.ai/docs/mcp
tags:
- name: API
- name: Api
- name: Carts
- name: Catalog
- name: Checkout Sessions
- name: Orders
security:
- Seller_API_key: []
- Network_key: []