{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["cards","card"]},"type":"markdown"},"seo":{"title":"Errors & Troubleshooting - API Error Reference","projectTitle":"Vilna Docs","description":"API error response format following RFC 7807 Problem Details. Complete error code reference with validation and troubleshooting guidance.","siteUrl":"https://docs.vilna.io","keywords":["crypto asset management","blockchain monitoring","digital asset security","cryptocurrency API","wallet tracking","blockchain analytics","enterprise crypto","real-time blockchain","CAIP-19","BIP44"],"lang":"en-US","image":"https://cdn.vilna.io/docs/previews/guides.png","meta":[{"name":"og:type","content":"website"},{"name":"og:site_name","content":"Vilna Documentation"},{"name":"og:image:width","content":"1200"},{"name":"og:image:height","content":"630"},{"name":"twitter:card","content":"summary_large_image"}],"llmstxt":{"title":"Vilna API Documentation","description":"Vilna is a blockchain monitoring and wallet management platform. It provides a single unified REST API for tracking addresses, transactions, balances, and activity across top blockchains - Bitcoin, Ethereum, Solana, TRON, TON, Cosmos, and others. The API uses CAIP-2/CAIP-19 standards for cross-chain identification, HD wallet management (BIP-32/44) for address derivation, and RFC 7807 for error responses. Authentication is via API key in the X-Api-Key header.\n","excludeFiles":["legal/**/*.md","@l10n/**/*.md"],"sections":[{"title":"Overview","description":"What Vilna is, supported blockchains, and target audience","includeFiles":["overview.md"],"excludeFiles":[]},{"title":"Getting Started","description":"Quickstart guide and core API concepts","includeFiles":["guides/quickstart.md","guides/dashboard.md","guides/core-concepts.md","guides/authentication.md"],"excludeFiles":[]},{"title":"API Reference","description":"Platform API and Management API endpoint documentation","includeFiles":["apis/platform/index.md","apis/mgmt/index.md","apis/rpc/index.md","apis/platform/api.yaml","apis/mgmt/api.yaml"],"excludeFiles":[]},{"title":"Developer Guides","description":"Integration patterns, events, notifications, SDK, and error handling","includeFiles":["guides/events.md","guides/channels.md","guides/integration-patterns.md","guides/sdk.md","guides/mcp.md","guides/errors.md","guides/simulation.md","guides/invoices.md"],"excludeFiles":[]},{"title":"Business","description":"Value proposition, use cases, and onboarding","includeFiles":["business/index.md","business/use-cases.md"],"excludeFiles":[]},{"title":"Optional","description":"Additional reference material","includeFiles":["guides/blockchain-basics.md","guides/faq.md","apis/mgmt/guide.md","guides/widget.md","guides/storage-client.md","apis/platform/caip-standards.md","apis/mgmt/authorization.md"],"excludeFiles":[]}],"hide":false},"priority":0.5,"jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Guides"},{"@type":"ListItem","position":3,"name":"Errors"}]},{"@type":"TechArticle","headline":"Errors & Troubleshooting - API Error Reference","description":"API error response format following RFC 7807 Problem Details. Complete error code reference with validation and troubleshooting guidance.","url":"https://docs.vilna.io/guides/errors","datePublished":"2025-09-17","dateModified":"2026-03-09","proficiencyLevel":"Beginner","image":"https://cdn.vilna.io/docs/previews/guides.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"errors--troubleshooting","__idx":0},"children":["Errors & troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All Vilna API errors follow the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://tools.ietf.org/html/rfc7807"},"children":["RFC 7807 Problem Details"]}," format, returned as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/problem+json"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-format","__idx":1},"children":["Error format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every error response contains at least ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["title"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["status"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://docs.vilna.io/apis/problems/not-found\",\n  \"title\": \"Not Found\",\n  \"status\": 404,\n  \"detail\": \"Address not found\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validation-errors","__idx":2},"children":["Validation errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requests that fail input validation return status 400 with a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fields"]}," array describing each invalid field:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://docs.vilna.io/apis/problems/invalid-request\",\n  \"title\": \"Invalid Request\",\n  \"status\": 400,\n  \"detail\": \"Validation error\",\n  \"fields\": [\n    { \"name\": \"value\", \"reason\": \"must not be empty\" },\n    { \"name\": \"chainFamily\", \"reason\": \"must be one of: evm, bitcoin, solana, tron\" }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-types","__idx":3},"children":["Error types"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Title"},"children":["Title"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"When"},"children":["When"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["400"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid Request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid or missing request fields"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["401"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unauthorized"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing or invalid API key"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["403"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Forbidden"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Valid key but insufficient permissions"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["404"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Not Found"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resource does not exist"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["409"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conflict"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Resource state conflict (e.g., address already exists)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["422"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unprocessable Entity"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Business logic precondition failed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["429"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Too Many Requests"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rate limit exceeded"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["500"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Internal Server Error"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unexpected server error"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["502"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bad Gateway"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Upstream service unavailable"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["503"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Service Unavailable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Server temporarily overloaded"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limiting","__idx":4},"children":["Rate limiting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you exceed the request rate limit, the API returns 429 with a standard error body:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://docs.vilna.io/apis/problems/rate-limit\",\n  \"title\": \"Too Many Requests\",\n  \"status\": 429,\n  \"detail\": \"Rate limit exceeded\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every response includes rate limit headers:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RateLimit-Limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Maximum requests allowed per window"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RateLimit-Remaining"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Requests remaining in the current window"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RateLimit-Reset"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unix timestamp when the window resets"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you receive a 429, wait until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-RateLimit-Reset"]}," before retrying. If the header is unavailable, use exponential backoff with jitter."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"server-errors-and-retries","__idx":5},"children":["Server errors and retries"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["5xx errors indicate a temporary server-side issue. Retry with exponential backoff: wait 1s, 2s, 4s, and so on up to a maximum of 30s, for at most 5 attempts. Add random jitter (e.g., 0-500ms) to each delay to avoid thundering herd effects."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Idempotency note:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DELETE"]}," requests are safe to retry. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PUT"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH"]}," requests may not be idempotent - check the endpoint documentation or use an idempotency key if supported before retrying."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handling-errors-with-the-sdk","__idx":6},"children":["Handling errors with the SDK"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{ data, error }"]}," from every call. Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," before using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]},":"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"const { data, error } = await client.POST(\"/addresses/external\", {\n  body: {\n    value: \"0x...\",\n    chainFamily: \"evm\",\n    label: \"Treasury\",\n  },\n});\n\nif (error) {\n  switch (error.status) {\n    case 400:\n      // Validation error - inspect individual fields\n      for (const field of error.fields ?? []) {\n        console.error(`${field.name}: ${field.reason}`);\n      }\n      break;\n\n    case 404:\n      console.error(\"Resource not found:\", error.detail);\n      break;\n\n    case 409:\n      console.error(\"Conflict:\", error.detail);\n      break;\n\n    default:\n      console.error(`${error.title}: ${error.detail}`);\n  }\n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"handling-errors-with-curl","__idx":7},"children":["Handling errors with curl"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -s -w \"\\n%{http_code}\" \"https://api.vilna.io/v1/addresses/invalid\" \\\n  -H \"X-Api-Key: your-api-key\" | jq .\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A 404 response looks like:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"type\": \"https://docs.vilna.io/apis/problems/not-found\",\n  \"title\": \"Not Found\",\n  \"status\": 404,\n  \"detail\": \"Address not found\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-issues-and-solutions","__idx":8},"children":["Common issues and solutions"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"invalid-api-key","__idx":9},"children":["Invalid API key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-Api-Key"]}," header is present and the key is active. Make sure you are calling the correct base URL (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api.vilna.io/v1"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"address-not-found","__idx":10},"children":["Address not found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["404 Not Found"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check that the address format matches the chain. EVM addresses start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0x"]}," and are 42 characters. TRON addresses start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T"]}," and are 34 characters. The address must have been previously registered via the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"webhook-delivery-failed","__idx":11},"children":["Webhook delivery failed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error:"]}," Channel marked as failed after repeated delivery failures"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the webhook URL is publicly accessible from the internet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure the endpoint returns an HTTP 2xx status code within 10 seconds."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the endpoint accepts ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/json"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"caip-format-errors","__idx":12},"children":["CAIP format errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Vilna uses ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/platform/caip-standards"},"children":["CAIP standards"]}," for chain, account, and asset identifiers."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Format"},"children":["Format"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Chain (CAIP-2)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{namespace}:{reference}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Asset (CAIP-19)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["{chain_id}/{asset_namespace}:{asset_reference}"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1/erc20:0xa0b8..."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common mistakes:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using a chain ID number instead of CAIP-2 format (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," vs ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eip155:1"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Missing the namespace prefix in asset identifiers"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"further-reading","__idx":13},"children":["Further reading"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":2,"cardMinWidth":240},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Authentication","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/guides/authentication"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API key setup and webhook signature verification"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Platform API","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/apis/platform/"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Complete endpoint documentation"]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"FAQ","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"start","variant":"filled","to":"/guides/faq"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Frequently asked questions"]}]}]}]},"headings":[{"value":"Errors & troubleshooting","id":"errors--troubleshooting","depth":1},{"value":"Error format","id":"error-format","depth":2},{"value":"Validation errors","id":"validation-errors","depth":3},{"value":"Error types","id":"error-types","depth":2},{"value":"Rate limiting","id":"rate-limiting","depth":2},{"value":"Server errors and retries","id":"server-errors-and-retries","depth":2},{"value":"Handling errors with the SDK","id":"handling-errors-with-the-sdk","depth":2},{"value":"Handling errors with curl","id":"handling-errors-with-curl","depth":2},{"value":"Common issues and solutions","id":"common-issues-and-solutions","depth":2},{"value":"Invalid API key","id":"invalid-api-key","depth":3},{"value":"Address not found","id":"address-not-found","depth":3},{"value":"Webhook delivery failed","id":"webhook-delivery-failed","depth":3},{"value":"CAIP format errors","id":"caip-format-errors","depth":3},{"value":"Further reading","id":"further-reading","depth":2}],"frontmatter":{"seo":{"title":"Errors & Troubleshooting - API Error Reference","description":"API error response format following RFC 7807 Problem Details. Complete error code reference with validation and troubleshooting guidance.","priority":0.5,"image":"https://cdn.vilna.io/docs/previews/guides.png","jsonLd":{"@context":"https://schema.org","@graph":[{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://docs.vilna.io/"},{"@type":"ListItem","position":2,"name":"Guides"},{"@type":"ListItem","position":3,"name":"Errors"}]},{"@type":"TechArticle","headline":"Errors & Troubleshooting - API Error Reference","description":"API error response format following RFC 7807 Problem Details. Complete error code reference with validation and troubleshooting guidance.","url":"https://docs.vilna.io/guides/errors","datePublished":"2025-09-17","dateModified":"2026-03-09","proficiencyLevel":"Beginner","image":"https://cdn.vilna.io/docs/previews/guides.png","author":{"@id":"https://vilna.io/#organization"},"publisher":{"@id":"https://vilna.io/#organization"}}]}}},"lastModified":"2026-04-04T17:54:24.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}