Submits a claim for a specified amount from reward certificates
A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Crown API Documentation","colors":{"primary":"#002804","light":"#DAD7C8","dark":"#002804"},"logo":{"light":"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/logo/light.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=ac83b7b6f874f0613ee2d0c9a5ade601","dark":"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/logo/dark.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=6cf82e209d2e6bd90fa78c7a47b9404d"},"favicon":"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/favicon.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=aa30534896387d541312323082b55ff5","background":{"color":{"light":"#DAD7C8","dark":"#002804"}},"navbar":{"links":[{"href":"mailto:operations@crowndigital.xyz","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.crown-brlv.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/crown-brl"}},"fonts":{"heading":{"family":"Season Mix","weight":700,"source":"fonts/SeasonMix-Bold.woff2","format":"woff2"},"body":{"family":"Season Sans","weight":400,"source":"fonts/SeasonSans-Regular.woff2","format":"woff2"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"crown-2b36dce9","hasAudioNarration":false,"actualSubdomain":"crown-2b36dce9","customDomains":["docs.crown-brlv.com"],"gitSource":{"type":"github","owner":"crown-xyz","repo":"crown-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae00ba328f1c789c872be2e","collectionId":"83f61fab-6ec3-4afb-a11d-3263f057f3f9","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae00ba328f1c789c872be2e"},"entitlements":{},"buildId":"6ae00ba328f1c789c872be2e","clientVersion":"0.0.3990","searchFilterCounts":[{"language":"default","tag":"API reference","count":80},{"language":"default","tag":"Claims","count":13},{"language":"default","tag":"Auto-claims","count":11},{"language":"default","tag":"Webhooks","count":10},{"language":"default","tag":"Withdrawals","count":9},{"language":"default","tag":"Guides","count":9},{"language":"default","tag":"Orders","count":7},{"language":"default","tag":"Accounts","count":6},{"language":"default","tag":"Deposits","count":5},{"language":"default","tag":"Wallets","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@keyframes cd-rise{0%{opacity:0;transform:translateY(5px)}to{opacity:1;transform:translateY(0)}}.crown-deprecated{--cd-oxblood:#b5454a;--cd-cream:#dad7c8;display:flex;align-items:center;gap:1rem 1.5rem;flex-wrap:wrap;margin:0 0 2rem;padding:.875rem 1.25rem;border:1px solid color-mix(in srgb,var(--cd-oxblood) 28%,transparent);border-radius:.75rem;background:color-mix(in srgb,var(--cd-oxblood) 10%,transparent);font-family:\"Season Sans\",ui-sans-serif,system-ui,sans-serif;animation:cd-rise .45s cubic-bezier(.22,1,.36,1) both}.crown-deprecated__dot{flex:none;width:.5rem;height:.5rem;border-radius:50%;background:var(--cd-oxblood);box-shadow:0 0 0 4px color-mix(in srgb,var(--cd-oxblood) 18%,transparent)}.crown-deprecated__text{flex:1 1 16rem;margin:0;font-size:.9375rem;line-height:1.45;color:color-mix(in srgb,#7a2e32 92%,black)}.crown-deprecated__text strong{font-weight:700;color:#7a2e32}.crown-deprecated__action{flex:none;display:inline-flex;align-items:center;gap:.4rem;font-size:.875rem;font-weight:600;white-space:nowrap;text-decoration:none;color:#7a2e32;transition:gap .18s ease,opacity .18s ease}.crown-deprecated__action:hover{gap:.6rem;opacity:.85}.dark .crown-deprecated{border-color:color-mix(in srgb,var(--cd-oxblood) 40%,transparent);background:color-mix(in srgb,var(--cd-oxblood) 16%,transparent)}.dark .crown-deprecated__text{color:color-mix(in srgb,var(--cd-cream) 88%,transparent)}.dark .crown-deprecated__dot{background:#e8868a;box-shadow:0 0 0 4px color-mix(in srgb,#e8868a 20%,transparent)}.dark .crown-deprecated__action,.dark .crown-deprecated__text strong{color:var(--cd-cream)}@media (prefers-reduced-motion:reduce){.crown-deprecated{animation:none}.crown-deprecated__action{transition:none}}:root{--cv-forest:#002804;--cv-cream:#dad7c8}div:has(>[data-component-part=version-select-trigger])::before{content:\"VERSION\";align-self:center;font-family:\"Season Sans\",ui-sans-serif,system-ui,sans-serif;font-size:.6875rem;font-weight:600;letter-spacing:.14em;color:color-mix(in srgb,var(--cv-forest) 48%,transparent)}[data-component-part=version-select-trigger]{border:1px solid color-mix(in srgb,var(--cv-forest) 22%,transparent);background:color-mix(in srgb,var(--cv-forest) 5%,transparent);border-radius:.75rem;padding-top:.375rem;padding-bottom:.375rem;transition:border-color .18s ease,background .18s ease}[data-component-part=version-select-trigger]:hover{border-color:color-mix(in srgb,var(--cv-forest) 36%,transparent)}[data-component-part=version-select-trigger]>span{font-family:\"Season Mix\",Georgia,serif;font-weight:700;font-variant-numeric:tabular-nums}.dark div:has(>[data-component-part=version-select-trigger])::before{color:color-mix(in srgb,var(--cv-cream) 52%,transparent)}.dark [data-component-part=version-select-trigger]{border-color:color-mix(in srgb,var(--cv-cream) 22%,transparent);background:color-mix(in srgb,var(--cv-cream) 5%,transparent)}.dark [data-component-part=version-select-trigger]:hover{border-color:color-mix(in srgb,var(--cv-cream) 38%,transparent)}[data-component-part=version-select-item]>p{flex:0 0 auto}[data-component-part=version-select-item]>svg{margin-left:auto}"}],"page":{"pagePath":"api-reference/endpoint/v1/claims/create-claim","slug":"/api-reference/endpoint/v1/claims/create-claim","pageMetadata":{"title":"Submit Claim Request","openapi":"POST /api/v1/accounts/{account-id}/claims","description":"Submits a claim for a specified amount from reward certificates\n\nA BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.","href":"/api-reference/endpoint/v1/claims/create-claim"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Submits a claim for a specified amount from reward certificates\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Submit Claim Request","openapi":"POST /api/v1/accounts/{account-id}/claims","description":"Submits a claim for a specified amount from reward certificates\n\nA BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.","href":"/api-reference/endpoint/v1/claims/create-claim"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"parameters":["e0882876-9f82-4154-9af4-ff5b4290908d"],"requestBody":"85fa8325-b871-4bbd-8247-fc6a700f0b41","responses":{"200":"bd9b6b5d-3327-4ee0-a329-cd4d756b4bc7","400":"e5ae36d9-fcb3-41a3-83f7-c03c62b5df8b","403":"1e5df92a-d568-46c8-ab08-3d57ac91a413","404":"d874def1-1179-4087-b76e-ad936c00465c","422":"2a6f31fd-dc91-477a-883d-6f6b6ae13014"},"summary":"Submit a claim request","description":"Submits a claim for a specified amount from reward certificates\n\nA BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.","method":"post","type":"path","servers":["de5b12f1-f1d2-42fb-ad62-9178d37a09c1"],"security":[],"path":"/api/v1/accounts/{account-id}/claims","baseUrlOptions":["https://app.crown-brlv.com"],"title":"Submit a claim request","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"e0882876-9f82-4154-9af4-ff5b4290908d":{"in":"path","name":"account-id","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"amount":{"oneOf":[{"type":"string","description":"Amount to claim from reward certificates","example":"100.00","isRequired":true,"uniqueKey":"amount.oneOf.0","typeLabel":"string"},{"type":"number","description":"Amount to claim from reward certificates","format":"double","example":"100.00","isRequired":true,"uniqueKey":"amount.oneOf.1","typeLabel":"number\u003cdouble>"}],"isRequired":true,"uniqueKey":"amount","typeLabel":"string | number\u003cdouble>"},"target-asset-code":{"type":"string","description":"Destination asset: 'brl' for bank transfer or 'brlv' for on-chain tokens","example":"brlv","enum":["brl","brlv"],"uniqueKey":"target-asset-code","typeLabel":"enum\u003cstring>"}},"additionalProperties":false,"required":["amount"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"amount":"100.00","target-asset-code":"brlv"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"bd9b6b5d-3327-4ee0-a329-cd4d756b4bc7":{"description":"Claim submitted successfully","content":{"application/json":{"schema":{"type":"object","properties":{"claim":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Claims request unique identifier","example":"550e8400-e29b-41d4-a716-446655440003","isRequired":true,"uniqueKey":"claim.id","typeLabel":"string\u003cuuid>"},"gross-amount":{"type":"string","format":"decimal","description":"Total gross amount of the claims","example":"100.00","isRequired":true,"uniqueKey":"claim.gross-amount","typeLabel":"string\u003cdecimal>"},"net-amount":{"type":"string","format":"decimal","description":"Net amount after taxes and fees","example":"85.00","isRequired":true,"uniqueKey":"claim.net-amount","typeLabel":"string\u003cdecimal>"},"tax-amount":{"type":"string","format":"decimal","description":"Total tax amount deducted","example":"15.00","isRequired":true,"uniqueKey":"claim.tax-amount","typeLabel":"string\u003cdecimal>"},"fees":{"type":"string","format":"decimal","description":"Processing fees","example":"0.00","isRequired":true,"uniqueKey":"claim.fees","typeLabel":"string\u003cdecimal>"},"status":{"type":"string","enum":["created","failed","completed","processing","canceled"],"description":"Current status of the claims request","example":"created","isRequired":true,"uniqueKey":"claim.status","typeLabel":"enum\u003cstring>"},"updated-at":{"type":"string","description":"Last update timestamp","example":"2025-09-30T19:21:57.838913Z","isRequired":true,"uniqueKey":"claim.updated-at","typeLabel":"string"}},"additionalProperties":false,"required":["id","gross-amount","net-amount","tax-amount","fees","status","updated-at"],"description":"Details of the submitted claim request","isRequired":true,"uniqueKey":"claim","typeLabel":"object"}},"additionalProperties":false,"required":["claim"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"claim":{"id":"550e8400-e29b-41d4-a716-446655440003","gross-amount":"100.00","net-amount":"85.00","tax-amount":"15.00","fees":"0.00","status":"created","updated-at":"2025-09-30T19:21:57.838913Z"}}}},"exampleType":"generated"}},"exampleType":"generated"},"e5ae36d9-fcb3-41a3-83f7-c03c62b5df8b":{"description":"Bad request - Invalid input parameters","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Bad request error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"1e5df92a-d568-46c8-ab08-3d57ac91a413":{"description":"Forbidden - Access denied","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Forbidden access error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"d874def1-1179-4087-b76e-ad936c00465c":{"description":"Not found - Resource does not exist","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Resource not found error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2a6f31fd-dc91-477a-883d-6f6b6ae13014":{"description":"Unprocessable entity - Validation failed, or a claim for the same amount was already submitted in the last 15 minutes","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","isRequired":true,"uniqueKey":"error.type","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"code":{"type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"}},"additionalProperties":false,"required":["type","message","code"],"description":"Validation error details","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"additionalProperties":false,"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"type":"\u003cstring>","message":"\u003cstring>","code":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"de5b12f1-f1d2-42fb-ad62-9178d37a09c1":{"url":"https://app.crown-brlv.com","description":"Production server"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"crown-2b36dce9","siteName":"Crown API Documentation","title":"Submit Claim Request - Crown API Documentation","navMaps":{"firstHrefInVersion":{"v1":{"href":"/api-reference/endpoint/v1/claims/create-claim","matchLevel":0},"v0":{"href":"/api-reference/endpoint/claims/list-claims","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-08-25T18:26:09.804Z","originalFileLocation":"api-reference/endpoint/v1/claims/create-claim.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Submits a claim for a specified amount from reward certificates A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Crown API Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Submit Claim Request - Crown API Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Submits a claim for a specified amount from reward certificates A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Crown API Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://crown-2b36dce9.mintlify.app/_mintlify/api/og/v2?division=Claims\u0026amp;title=Submit+Claim+Request\u0026amp;description=Submits+a+claim+for+a+specified+amount+from+reward+certificates%0A%0AA+BRLV+claim+submission+is+rejected+when+the+account+already+has+a+claim+for+the+same+amount+su\u0026amp;theme=a7f7184136e2a1b3ff27ca50\u0026amp;signature=3c3931d382066f55404ad166755768a746b31e1a70a0ce5f6d68f749510c9779\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Submit Claim Request - Crown API Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Submits a claim for a specified amount from reward certificates A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://crown-2b36dce9.mintlify.app/_mintlify/api/og/v2?division=Claims\u0026amp;title=Submit+Claim+Request\u0026amp;description=Submits+a+claim+for+a+specified+amount+from+reward+certificates%0A%0AA+BRLV+claim+submission+is+rejected+when+the+account+already+has+a+claim+for+the+same+amount+su\u0026amp;theme=a7f7184136e2a1b3ff27ca50\u0026amp;signature=3c3931d382066f55404ad166755768a746b31e1a70a0ce5f6d68f749510c9779\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/crown-2b36dce9/b-hZSpiTYtCRSAkK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Crown API Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#002804\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoint/v1/claims/create-claim.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.crown-brlv.com/#organization\",\"name\":\"Crown API Documentation\",\"url\":\"https://docs.crown-brlv.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/crown-2b36dce9/-If___UpDLMLlFoP/logo/light.svg?fit=max\u0026auto=format\u0026n=-If___UpDLMLlFoP\u0026q=85\u0026s=ac83b7b6f874f0613ee2d0c9a5ade601\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.crown-brlv.com#website\",\"name\":\"Crown API Documentation\",\"url\":\"https://docs.crown-brlv.com\",\"publisher\":{\"@id\":\"https://docs.crown-brlv.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim#webpage\",\"url\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim\",\"name\":\"Submit Claim Request\",\"description\":\"Submits a claim for a specified amount from reward certificates A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.\",\"dateModified\":\"2026-08-25T18:26:09.804Z\",\"isPartOf\":{\"@id\":\"https://docs.crown-brlv.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Claims\",\"item\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/list-claims\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Submit Claim Request\",\"item\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim#apireference\",\"headline\":\"Submit Claim Request\",\"name\":\"Submit Claim Request\",\"description\":\"Submits a claim for a specified amount from reward certificates A BRLV claim submission is rejected when the account already has a claim for the same amount submitted in the last 15 minutes. Wait out the window before submitting it again.\",\"url\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim\",\"mainEntityOfPage\":{\"@id\":\"https://docs.crown-brlv.com/api-reference/endpoint/v1/claims/create-claim#webpage\"},\"dateModified\":\"2026-08-25T18:26:09.804Z\",\"publisher\":{\"@id\":\"https://docs.crown-brlv.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.crown-brlv.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Crown API Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Crown API Documentation","nav":{"global":null,"versions":[{"version":"v1","default":true,"tag":"Latest","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"API documentation","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]},{"group":"Accounts","pages":[{"title":"List Accounts","openapi":"GET /api/v1/accounts","href":"/api-reference/endpoint/v1/accounts/list-accounts"},{"title":"Create Account (Reliance)","openapi":"POST /api/v1/accounts/reliance","href":"/api-reference/endpoint/v1/accounts/create-reliance-account"},{"title":"Create Account (KYC, Individual)","openapi":"POST /api/v1/accounts/kyc/individual","href":"/api-reference/endpoint/v1/accounts/create-kyc-individual-account"},{"title":"Create Account (KYC, Company)","openapi":"POST /api/v1/accounts/kyc/company","href":"/api-reference/endpoint/v1/accounts/create-kyc-company-account"},{"title":"Upload File","openapi":"POST /api/v1/accounts/files","href":"/api-reference/endpoint/v1/accounts/upload-file"},{"title":"Get Account","openapi":"GET /api/v1/accounts/{account-id}","href":"/api-reference/endpoint/v1/accounts/get-account"}]},{"group":"Orders","pages":[{"title":"List Orders","openapi":"GET /api/v1/accounts/{account-id}/orders","href":"/api-reference/endpoint/v1/orders/list-orders"},{"title":"List Orders by State","openapi":"GET /api/v1/orders","href":"/api-reference/endpoint/v1/orders/list-orders-by-state"},{"title":"Create Order","openapi":"POST /api/v1/accounts/{account-id}/orders","href":"/api-reference/endpoint/v1/orders/create-order"},{"title":"Get Order","openapi":"GET /api/v1/accounts/{account-id}/orders/{id}","href":"/api-reference/endpoint/v1/orders/get-order"}]},{"group":"Quotes","pages":[{"title":"Create Quote","openapi":"POST /api/v1/accounts/{account-id}/quotes","href":"/api-reference/endpoint/v1/quotes/create-quote"}]},{"group":"Wallets","pages":[{"title":"List Wallets","openapi":"GET /api/v1/accounts/{account-id}/wallets","href":"/api-reference/endpoint/v1/wallets/list-wallets"},{"title":"Create Wallet","openapi":"POST /api/v1/accounts/{account-id}/wallets","href":"/api-reference/endpoint/v1/wallets/create-wallet"},{"title":"Update Wallet Metadata","openapi":"PATCH /api/v1/accounts/{account-id}/wallets/{wallet-id}/metadata","href":"/api-reference/endpoint/v1/wallets/update-wallet-metadata"}]},{"group":"Transfers","pages":[{"title":"List Transfers","openapi":"GET /api/v1/accounts/{account-id}/transfers","href":"/api-reference/endpoint/v1/transfers/list-transfers"},{"title":"Transfer Tokens","openapi":"POST /api/v1/accounts/{account-id}/transfers","href":"/api-reference/endpoint/v1/transfers/create-transfer"}]},{"group":"NFT transfers","pages":[{"title":"List Reward Certificate NFT Transfers","openapi":"GET /api/v1/accounts/{account-id}/nft-transfers","href":"/api-reference/endpoint/v1/nft-transfers/list-nft-transfers"},{"title":"Transfer Reward Certificate NFT","openapi":"POST /api/v1/accounts/{account-id}/nft-transfers","href":"/api-reference/endpoint/v1/nft-transfers/create-nft-transfer"}]},{"group":"Withdrawals","pages":[{"title":"List Withdrawals","openapi":"GET /api/v1/accounts/{account-id}/withdrawals","href":"/api-reference/endpoint/v1/withdrawals/list-withdrawals"},{"title":"Create Withdrawal","openapi":"POST /api/v1/accounts/{account-id}/withdrawals","href":"/api-reference/endpoint/v1/withdrawals/create-withdrawal"},{"title":"Get Withdrawal","openapi":"GET /api/v1/accounts/{account-id}/withdrawals/{id}","href":"/api-reference/endpoint/v1/withdrawals/get-withdrawal"}]},{"group":"Deposits","pages":[{"title":"List Deposits by Asset","openapi":"GET /api/v1/accounts/{account-id}/assets/{asset}/deposits","href":"/api-reference/endpoint/v1/deposits/list-deposits"},{"title":"Get Deposit","openapi":"GET /api/v1/accounts/{account-id}/assets/{asset}/deposits/{id}","href":"/api-reference/endpoint/v1/deposits/get-deposit"},{"title":"Confirm Deposit Sender","openapi":"POST /api/v1/accounts/{account-id}/assets/{asset}/deposits/{id}/confirm-sender","href":"/api-reference/endpoint/v1/deposits/confirm-sender"},{"title":"Get PIX Deposit QR Code","openapi":"GET /api/v1/accounts/{account-id}/deposits/pix","href":"/api-reference/endpoint/v1/deposits/pix-deposit"}]},{"group":"Balance","pages":[{"title":"Get Balance by Asset","openapi":"GET /api/v1/accounts/{account-id}/assets/{asset}/balance","href":"/api-reference/endpoint/v1/balance/get-balance"}]},{"group":"Claims","pages":[{"title":"Get Claimable Balance","openapi":"GET /api/v1/accounts/{account-id}/claims","description":"Returns the total available balance that can be claimed","href":"/api-reference/endpoint/v1/claims/list-claims"},{"title":"Submit Claim Request","openapi":"POST /api/v1/accounts/{account-id}/claims","href":"/api-reference/endpoint/v1/claims/create-claim"},{"title":"Get Claim","openapi":"GET /api/v1/accounts/{account-id}/claims/{id}","description":"Retrieves the status and details of a specific claim request submitted by the account.","href":"/api-reference/endpoint/v1/claims/get-claim"},{"title":"List Reward Certificates","openapi":"GET /api/v1/accounts/{account-id}/claims/certificates","href":"/api-reference/endpoint/v1/claims/list-certificates"},{"title":"Get Wallet Claimable Balance","openapi":"GET /api/v1/accounts/{account-id}/wallets/{wallet-address}/claims","href":"/api-reference/endpoint/v1/claims/wallet-claimable-balance"},{"title":"Submit Wallet Claim Request","openapi":"POST /api/v1/accounts/{account-id}/wallets/{wallet-address}/claims","href":"/api-reference/endpoint/v1/claims/create-wallet-claim"},{"title":"List Wallet Reward Certificates","openapi":"GET /api/v1/accounts/{account-id}/wallets/{wallet-address}/claims/certificates","href":"/api-reference/endpoint/v1/claims/list-wallet-certificates"}]},{"group":"Auto-claims","pages":[{"title":"List Auto-Claim Schedules","openapi":"GET /api/v1/accounts/{account-id}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/list-auto-claims"},{"title":"Create Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/create-auto-claim"},{"title":"Get Auto-Claim Schedule","openapi":"GET /api/v1/accounts/{account-id}/auto-claims/{schedule-id}","href":"/api-reference/endpoint/v1/auto-claims/get-auto-claim"},{"title":"Pause Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/pause","href":"/api-reference/endpoint/v1/auto-claims/pause-auto-claim"},{"title":"Resume Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/resume","href":"/api-reference/endpoint/v1/auto-claims/resume-auto-claim"},{"title":"Cancel Auto-Claim Schedule","openapi":"DELETE /api/v1/accounts/{account-id}/auto-claims/{schedule-id}","href":"/api-reference/endpoint/v1/auto-claims/cancel-auto-claim"},{"title":"List Auto-Claim Skip Windows","openapi":"GET /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips","href":"/api-reference/endpoint/v1/auto-claims/list-auto-claim-skips"},{"title":"Skip Auto-Claim","openapi":"POST /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips","href":"/api-reference/endpoint/v1/auto-claims/create-auto-claim-skip"},{"title":"Remove Auto-Claim Skip Window","openapi":"DELETE /api/v1/accounts/{account-id}/auto-claims/{schedule-id}/skips/{skip-id}","href":"/api-reference/endpoint/v1/auto-claims/delete-auto-claim-skip"},{"title":"List Wallet Auto-Claim Schedules","openapi":"GET /api/v1/accounts/{account-id}/wallets/{wallet-address}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/list-wallet-auto-claims"},{"title":"Create Wallet Auto-Claim Schedule","openapi":"POST /api/v1/accounts/{account-id}/wallets/{wallet-address}/auto-claims","href":"/api-reference/endpoint/v1/auto-claims/create-wallet-auto-claim"}]},{"group":"Tax exemption","pages":[{"title":"Get Tax Exemption Progress","openapi":"GET /api/v1/accounts/{account-id}/tax-exemption/progress","href":"/api-reference/endpoint/v1/tax-exemption/progress"}]},{"group":"Webhooks","pages":[{"title":"Deposit Processed","openapi":"webhook deposit-processed","href":"/api-reference/webhooks/deposit-processed"},{"title":"Deposit Quarantined","openapi":"webhook deposit-quarantined","href":"/api-reference/webhooks/deposit-quarantined"},{"title":"Deposit Rejected","openapi":"webhook deposit-rejected","href":"/api-reference/webhooks/deposit-rejected"},{"title":"Order Completed","openapi":"webhook order-completed","href":"/api-reference/webhooks/order-completed"},{"title":"Order Refund Initiated","openapi":"webhook order-refund-initiated","href":"/api-reference/webhooks/order-refund-initiated"},{"title":"Token Transfer Completed","openapi":"webhook token-transfer-completed","href":"/api-reference/webhooks/token-transfer-completed"},{"title":"Withdraw Completed","openapi":"webhook withdraw-completed","href":"/api-reference/webhooks/withdraw-completed"},{"title":"Claim Completed","openapi":"webhook claim-completed","href":"/api-reference/webhooks/claim-completed"},{"title":"Account Approved","openapi":"webhook account-approved","href":"/api-reference/webhooks/account-approved"},{"title":"Account Rejected","openapi":"webhook account-rejected","href":"/api-reference/webhooks/account-rejected"}]}]},{"tab":"Whitepaper","pages":[{"title":"Whitepaper","href":"/whitepaper"}]}]},{"version":"v0","tag":"Deprecated","pages":[{"title":"v0","href":"/api-reference/endpoint/claims/list-claims"}]}]},"title":"Submit Claim Request - Crown API Documentation","buildId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","deploymentId":"dpl_2oYXwqkEXirXBPk8wV1FtM5USFWi","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-WRhTSUDL.js","utils-ChMov4Kr.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-_REmC2bI.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp6nVRCu.js","snippetPresets-DZadmXoU.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CY2WdoTl.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DwYG-Q4l.js","shallow-BXQIGwv4.js","getApiPlaygroundDisplay-CK5nK5B9.js","CodeSnippet-TH4a2aGW.js","CodeSnippets-DwsQiOFS.js","Page-R3M_BF4L.js","getPastedJson-DD7kUzi_.js","icon-holE3QoJ.js","MethodPill-DUW0T8us.js","DuplicateIcon-CI_p4be-.js","createIcon-BdbRvavb.js","DynamicMarkdown-DN96a4Ur.js","SectionHeading-SCu36A9d.js","axios-vUo_bRtp.js","Markdown-CCeGv-zI.js","clsx-BGBGWFTt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-Cv_O2fky.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-2C5OB2eV.js"]}