# Aayat AI Error Known Lookup

> Aayat AI Error Known Lookup is a paid API for AI agents from aayatai.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-02).

Searches GitHub issues and Stack Overflow to determine if an error message or stack trace is a known issue, returning matches with status, links, and excerpts.

## Facts

- Endpoint: GET https://aayatai.com/error/known?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aayat-ai-error-known-lookup-8b5a0fb8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_I8B0RlhsbaGkUibzM_OSg

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aayat-ai-error-known-lookup-8b5a0fb8
```

Example prompt: Can you check if this npm error is a known issue? 'Error: Cannot find module hono/cors' — it's from the hono package.

## When to prefer this

Use this endpoint when you need to quickly determine if an error is a known, documented issue before spending time debugging — especially useful for coding agents to triage errors before attempting fixes. Prefer this over /error/explain when you only need to check existence and status of known reports rather than generating a suggested fix.

## Known failure modes

- Error message too short (under 5 characters) returns validation error
- GitHub API rate limiting may reduce match count
- No matches found returns known:false with empty matches array
- Invalid ecosystem enum value returns schema error
- Library name not found on the specified ecosystem returns null repository

## How this service works

Is this error known? Paste an error message or stack trace (and optionally the library): it is cleaned of paths and line numbers, then searched in the library's own GitHub issues, all GitHub issues and Stack Overflow, returning the best matches with status (closed, accepted answer...), links and excerpts. For a likely fix use /error/explain.

## Output

A JSON object containing: a 'known' boolean, the cleaned query string that was searched, the matched library and repository URL, an array of best-matching issues/questions sorted by score (each with URL, title, source, status, answer count, excerpt, creation date, and relevance score), a summary sentence, sources checked with counts, and a checkedAt timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "message"
     ],
     "properties": {
      "library": {
       "type": "string",
       "maxLength": 214,
       "description": "The package the error comes from, to search its own issues first."
      },
      "message": {
       "type": "string",
       "maxLength": 4000,
       "minLength": 5,
       "description": "The error message (a stack trace is fine; paths and line numbers are stripped)."
      },
      "ecosystem": {
       "enum": [
        "npm",
        "pypi",
        "crates",
        "go"
       ],
       "type": "string",
       "default": "npm",
       "description": "Package ecosystem: npm, pypi, crates (Rust) or go (Go modules)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "query",
      "known",
      "summary",
      "matches",
      "sources"
     ],
     "properties": {
      "known": {
       "type": "boolean"
      },
      "query": {
       "type": "string",
       "description": "The cleaned-up phrase that was searched."
      },
      "trust": {
       "type": "object",
       "description": "Third-party text, cleaned: read trust.notice; removed = what we stripped."
      },
      "library": {
       "type": [
        "string",
        "null"
       ]
      },
      "matches": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "url": {
          "type": "string"
         },
         "score": {
          "type": "integer"
         },
         "title": {
          "type": "string"
         },
         "source": {
          "enum": [
           "github-issue",
           "stackoverflow"
          ],
          "type": "string"
         },
         "status": {
          "type": "string",
          "description": "open / closed / accepted answer / answered / unanswered."
         },
         "answers": {
          "type": [
         
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "known": true,
  "query": "Error: Cannot find module 'hono/cors'",
  "library": "hono",
  "matches": [
   {
    "url": "https://github.com/honojs/hono/issues/1",
    "score": 12,
    "title": "Cannot find module 'hono/cors' with moduleResolution node",
    "source": "github-issue",
    "status": "closed",
    "answers": 8,
    "excerpt": "Set moduleResolution to bundler...",
    "createdAt": "2026-01-01T00:00:00Z",
    "relevance": 1
   }
  ],
  "sources": [
   {
    "ok": true,
    "name": "github-issues",
    "count": 1
   },
   {
    "ok": true,
    "name": "stackoverflow",
    "count": 1
   }
  ],
  "summary": "2 similar report(s); 1 solved (closed issue or accepted answer).",
  "checkedAt": "2026-09-28T12:00:00.000Z",
  "repository": "https://github.com/honojs/hono"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aayat-ai-error-known-lookup-8b5a0fb8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from aayatai.com](https://www.zero.xyz/host/aayatai.com/llms.txt)