CreditClawCreditClawDocs
    View as Markdown

    Skills

    The Skills endpoints let your bot discover procurement skills — structured vendor profiles that describe how to purchase from specific merchants. Use these endpoints to search for vendors by category, checkout method, or capability, and retrieve detailed skill files for integration.

    List / Search Skills

    Search and filter available procurement skills.

    MethodGET
    Path/api/v1/bot/skills
    AuthBearer token (Authorization: Bearer cck_live_...)

    Query Parameters

    ParameterTypeDescription
    searchstringFilter vendors by name or slug (case-insensitive)
    categorystringFilter by category: retail, office, hardware, electronics, industrial, specialty
    checkoutstringComma-separated checkout methods: native_api, acp, x402, crossmint_world, self_hosted_card, browser_automation
    capabilitystringComma-separated required capabilities (all must match): price_lookup, stock_check, programmatic_checkout, business_invoicing, bulk_pricing, tax_exemption, account_creation, order_tracking, returns, po_numbers
    maturitystringComma-separated maturity levels: verified, beta, community, draft

    Response

    {
  "vendors": [
    {
      "slug": "amazon",
      "name": "Amazon",
      "category": "retail",
      "url": "https://amazon.com",
      "checkout_methods": ["crossmint_world", "self_hosted_card"],
      "capabilities": ["price_lookup", "stock_check", "order_tracking"],
      "maturity": "verified",
      "agent_friendliness": 85,
      "guest_checkout": true,
      "bulk_pricing": false,
      "free_shipping_above": 35,
      "skill_url": "https://creditclaw.com/api/v1/bot/skills/amazon",
      "catalog_url": "https://creditclaw.com/skills/amazon",
      "version": "1.0.0",
      "last_verified": "2025-01-15",
      "success_rate": 0.94
    }
  ],
  "total": 1,
  "categories": ["retail", "office", "hardware", "electronics", "industrial", "specialty"]
}

    Response Fields

    FieldTypeDescription
    slugstringUnique vendor identifier
    namestringDisplay name
    categorystringVendor category
    urlstringVendor website
    checkout_methodsstring[]Supported checkout methods
    capabilitiesstring[]Vendor capabilities
    maturitystringSkill maturity level (verified, beta, community, draft)
    agent_friendlinessnumberScore from 0–100 indicating how well the vendor supports agent-driven purchases
    guest_checkoutbooleanWhether the vendor supports guest checkout
    bulk_pricingbooleanWhether bulk pricing is available
    free_shipping_abovenumber | nullOrder amount threshold for free shipping
    skill_urlstringURL to fetch the full skill markdown
    catalog_urlstringURL to the vendor's skill page on CreditClaw
    versionstringSkill version (semver)
    last_verifiedstringDate the skill was last verified
    success_ratenumber | nullHistorical purchase success rate (0–1)

    Example

    # Search for office supply vendors with programmatic checkout
curl "https://creditclaw.com/api/v1/bot/skills?category=office&capability=programmatic_checkout" \
  -H "Authorization: Bearer cck_live_abc123..."

    # Find vendors that support x402 payments
curl "https://creditclaw.com/api/v1/bot/skills?checkout=x402&maturity=verified,beta" \
  -H "Authorization: Bearer cck_live_abc123..."

    Get Vendor Skill

    Retrieve the full skill file for a specific vendor. The response is a Markdown document containing detailed procurement instructions, checkout flows, payment methods, and integration notes.

    MethodGET
    Path/api/v1/bot/skills/:vendor
    AuthBearer token (Authorization: Bearer cck_live_...)

    Path Parameters

    ParameterTypeDescription
    vendorstringThe vendor slug (e.g., amazon, staples)

    Response

    The response is a text/markdown document with the following headers:

    HeaderDescription
    Content-Typetext/markdown; charset=utf-8
    Cache-Controlpublic, max-age=3600, s-maxage=86400
    X-Skill-VersionSkill version (e.g., 1.0.0)
    X-Skill-MaturityMaturity level (e.g., verified)

    The Markdown body includes sections such as:

    • Vendor overview and supported categories
    • Available checkout methods with configuration details
    • Search patterns and product URL templates
    • Shipping and return policies
    • Agent integration notes and tips

    Error Response

    {
  "error": "vendor_not_found",
  "message": "No skill found for vendor 'unknown-vendor'"
}

    Status: 404 Not Found

    Example

    # Fetch the full skill file for Amazon
curl "https://creditclaw.com/api/v1/bot/skills/amazon" \
  -H "Authorization: Bearer cck_live_abc123..."

    Response (truncated):

    # Amazon — Procurement Skill

## Overview
Amazon is a retail vendor supporting crossmint_world and self_hosted_card checkout methods...

## Checkout Methods
...

    Related

    • Authentication — How to authenticate API requests
    • Bots — Register and manage your bot
    • Webhooks — Get notified of purchase events
    PreviousSales
    NextSetup & Signing