Retrieves card settlements within a specified date range (max 1 year). Requires from and to query parameters in YYYY-MM-DD format.
Each entry represents a single settlement (presentment or chargeback) and carries paymentId linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook transactionId, use /transactions.
GET
/
settlements
List card settlements
curl --request GET \ --url https://api.dash.fi/v1/public/settlements \ --header 'Authorization: <api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dash.fi Developers","description":"Developer documentation for Dash.fi. MCP server and REST API reference.","colors":{"primary":"#3EAEA4","light":"#3EAEA4","dark":"#3EAEA4"},"logo":{"light":"https://mintcdn.com/dashfi-developers/4vCIsOaMEvI8SYKW/logo/dashfi-logo-black.svg?fit=max\u0026auto=format\u0026n=4vCIsOaMEvI8SYKW\u0026q=85\u0026s=da5748857dff00ecce634beb4f22f4bf","dark":"https://mintcdn.com/dashfi-developers/KkwH8PIBhqa8Uld_/logo/dashfi-logo-white.svg?fit=max\u0026auto=format\u0026n=KkwH8PIBhqa8Uld_\u0026q=85\u0026s=8d5d127f0ce232ea56a49ace8d063203","href":"https://dash.fi"},"favicon":{"light":"https://mintcdn.com/dashfi-developers/4vCIsOaMEvI8SYKW/images/dashfi-app-icon-ink-512px.png?fit=max\u0026auto=format\u0026n=4vCIsOaMEvI8SYKW\u0026q=85\u0026s=45d799d8578211d1b09d16225d81916e","dark":"https://mintcdn.com/dashfi-developers/KmuXJCBHnscVs0-J/images/dashfi-app-icon-cream-512px.png?fit=max\u0026auto=format\u0026n=KmuXJCBHnscVs0-J\u0026q=85\u0026s=9e288d0f0721fdcfa1d685cf13b605cb"},"background":{"color":{"light":"#FAF8F1","dark":"#131619"}},"navbar":{"links":[{"href":"https://support.dash.fi","label":"Help Center"},{"href":"mailto:support@dash.fi","label":"Contact Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.dash.fi"}},"fonts":{"heading":{"family":"PP Supply Mono","weight":700,"source":"fonts/PPSupplyMono-Ultralight.woff2","format":"woff2"},"body":{"family":"Bai Jamjuree","weight":400,"source":"fonts/bai-jamjuree-v13-latin-regular.woff2","format":"woff2"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"contextual":{"options":["copy","view","assistant","mcp","add-mcp"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dashfi-developers","hasAudioNarration":false,"actualSubdomain":"dashfi-developers","customDomains":["developers.dash.fi"],"gitSource":{"type":"github","owner":"funneldash","repo":"mintlify-developer-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeb2559d2d002df62e291fc","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"API Reference","count":20},{"language":"default","tag":"Card","count":9},{"language":"default","tag":"Account","count":5},{"language":"default","tag":"Financial","count":5},{"language":"default","tag":"Getting Started","count":1},{"language":"default","tag":"MCP Server","count":1},{"language":"default","tag":"Health","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/financial/list-card-settlements","slug":"/api-reference/financial/list-card-settlements","pageMetadata":{"title":"List card settlements","description":"Retrieves card settlements within a specified date range (max 1 year). Requires `from` and `to` query parameters in YYYY-MM-DD format.\n\nEach entry represents a single settlement (presentment or chargeback) and carries `paymentId` linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook `transactionId`, use `/transactions`.","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /settlements","href":"/api-reference/financial/list-card-settlements","autogeneratedByOpenApi":true},"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 code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Retrieves card settlements within a specified date range (max 1 year). Requires \", _jsx(_components.code, {\n children: \"from\"\n }), \" and \", _jsx(_components.code, {\n children: \"to\"\n }), \" query parameters in YYYY-MM-DD format.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Each entry represents a single settlement (presentment or chargeback) and carries \", _jsx(_components.code, {\n children: \"paymentId\"\n }), \" linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook \", _jsx(_components.code, {\n children: \"transactionId\"\n }), \", use \", _jsx(_components.code, {\n children: \"/transactions\"\n }), \".\"]\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":"List card settlements","description":"Retrieves card settlements within a specified date range (max 1 year). Requires `from` and `to` query parameters in YYYY-MM-DD format.\n\nEach entry represents a single settlement (presentment or chargeback) and carries `paymentId` linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook `transactionId`, use `/transactions`.","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /settlements","href":"/api-reference/financial/list-card-settlements","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Retrieves card settlements within a specified date range (max 1 year). Requires `from` and `to` query parameters in YYYY-MM-DD format.\n\nEach entry represents a single settlement (presentment or chargeback) and carries `paymentId` linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook `transactionId`, use `/transactions`.","operationId":"GetSettlements","parameters":["f6b19113-d350-4cfd-97b3-480b71b6336b","b934dea2-e359-4f32-be71-2aa117effa75","aa80da50-835d-44f3-869e-0d52921d7305"],"responses":{"200":"087af463-6304-476d-ad4f-67756eaba840","400":"474ff240-9c5d-45f1-82a6-e206a5ac1dcb","401":"3f048ba9-5568-4a89-b9b8-7155ab69635f","500":"88b68016-1989-4e87-b9bc-225f896123a1"},"summary":"List card settlements","tags":["Financial"],"method":"get","type":"path","servers":["43d6bcad-0037-4a5b-a912-29ff87f3890a"],"security":["d0a0b647-63d6-40d4-9580-5d6395182246"],"path":"/settlements","baseUrlOptions":["https://api.dash.fi/v1/public"],"title":"List card settlements","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f6b19113-d350-4cfd-97b3-480b71b6336b":{"description":"Account to read. Required for customer-scoped API keys; optional otherwise and must then match the key's account.","in":"query","name":"filter.accountId","schema":{"description":"Account to read. Required for customer-scoped API keys; optional otherwise and must then match the key's account.","type":"integer","x-order":"0003","uniqueKey":"","typeLabel":"integer"}},"b934dea2-e359-4f32-be71-2aa117effa75":{"in":"query","name":"from","required":true,"schema":{"example":"2026-01-01","format":"date","type":"string","x-order":"0001","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cdate>"}},"aa80da50-835d-44f3-869e-0d52921d7305":{"description":"At most one year after from.","in":"query","name":"to","required":true,"schema":{"description":"At most one year after from.","example":"2026-01-31","format":"date","type":"string","x-order":"0002","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cdate>"}}},"responses":{"087af463-6304-476d-ad4f-67756eaba840":{"content":{"application/json":{"schema":{"properties":{"data":{"items":{"properties":{"cardName":{"description":"Card name.","example":"Test Card","type":"string","x-order":"0005","isRequired":true,"uniqueKey":"data.items.[INDEX].cardName","typeLabel":"string"},"createdAt":{"description":"Settlement creation timestamp.","example":"2025-01-01T00:00:00Z","format":"date-time","type":"string","x-order":"0006","isRequired":true,"uniqueKey":"data.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"id":{"description":"Unique identifier for the settlement.","example":"550e8400-e29b-41d4-a716-446655440000","format":"uuid","type":"string","x-order":"0001","isRequired":true,"uniqueKey":"data.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"settledAmount":{"description":"Settled amount.","example":"100.00","type":"string","x-order":"0002","isRequired":true,"uniqueKey":"data.items.[INDEX].settledAmount","typeLabel":"string"},"settlementDate":{"description":"Date the settlement cleared (UTC), formatted YYYY-MM-DD.","example":"2025-01-01","format":"date","type":"string","x-order":"0003","isRequired":true,"uniqueKey":"data.items.[INDEX].settlementDate","typeLabel":"string\u003cdate>"},"merchantName":{"description":"Card acceptor / merchant name. Omitted when the settlement carries none.","example":"TARGET.COM","type":"string","x-order":"0004","uniqueKey":"data.items.[INDEX].merchantName","typeLabel":"string"},"paymentId":{"description":"Identifier of the payment that cleared this settlement, if any.","example":"550e8400-e29b-41d4-a716-446655440000","format":"uuid","type":"string","x-order":"0007","uniqueKey":"data.items.[INDEX].paymentId","typeLabel":"string\u003cuuid>"}},"required":["cardName","createdAt","id","settledAmount","settlementDate"],"type":"object","uniqueKey":"data.items.[INDEX]","typeLabel":"object"},"type":"array","x-order":"0001","isRequired":true,"uniqueKey":"data","typeLabel":"object[]"}},"required":["data"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"cardName":"Test Card","createdAt":"2025-01-01T00:00:00Z","id":"550e8400-e29b-41d4-a716-446655440000","settledAmount":"100.00","settlementDate":"2025-01-01","merchantName":"TARGET.COM","paymentId":"550e8400-e29b-41d4-a716-446655440000"}]}}},"exampleType":"generated"}},"description":"A list of settlements matching the criteria","exampleType":"generated"},"474ff240-9c5d-45f1-82a6-e206a5ac1dcb":{"content":{"application/json":{"schema":{"properties":{"code":{"type":"string","x-order":"0001","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","x-order":"0002","uniqueKey":"message","typeLabel":"string"}},"required":["code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"\u003cstring>","message":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Validation error for query parameters (format, range, etc.)","exampleType":"generated"},"3f048ba9-5568-4a89-b9b8-7155ab69635f":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"unauthorized","type":"string","x-order":"0001","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"example":"authorization header not provided","type":"string","x-order":"0002","uniqueKey":"message","typeLabel":"string"}},"required":["code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"unauthorized","message":"authorization header not provided"}}},"exampleType":"generated"}},"description":"Unauthorized access","exampleType":"generated"},"88b68016-1989-4e87-b9bc-225f896123a1":{"content":{"application/json":{"schema":{"properties":{"code":{"example":"internal-server-error","type":"string","x-order":"0001","isRequired":true,"uniqueKey":"code","typeLabel":"string"},"message":{"type":"string","x-order":"0002","uniqueKey":"message","typeLabel":"string"}},"required":["code"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"internal-server-error","message":"\u003cstring>"}}},"exampleType":"generated"}},"description":"Internal server error","exampleType":"generated"}},"security":{"d0a0b647-63d6-40d4-9580-5d6395182246":{"BearerAuth":{"description":"Type \"Bearer\" followed by a space and your API token. Obtain your key from the Dash.fi dashboard. Example: \"Bearer YOUR_API_KEY\"","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"43d6bcad-0037-4a5b-a912-29ff87f3890a":{"url":"https://api.dash.fi/v1/public"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Type \"Bearer\" followed by a space and your API token. Obtain your key from the Dash.fi dashboard. Example: \"Bearer YOUR_API_KEY\"","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Authorization","type":"string","description":"Type \"Bearer\" followed by a space and your API token. Obtain your key from the Dash.fi dashboard. Example: \"Bearer YOUR_API_KEY\"","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383"},"subdomain":"dashfi-developers","siteName":"Dash.fi Developers","title":"List card settlements - Dash.fi Developers","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-08-27T05:17:44.951Z","originalFileLocation":"api-reference/financial/list-card-settlements.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=\"Retrieves card settlements within a specified date range (max 1 year). Requires from and to query parameters in YYYY-MM-DD format. Each entry represents a single settlement (presentment or chargeback) and carries paymentId linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook transactionId, use /transactions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dash.fi Developers\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_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/dashfi-developers/L0vhuBa-x7tBm0RU/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List card settlements - Dash.fi Developers\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves card settlements within a specified date range (max 1 year). Requires from and to query parameters in YYYY-MM-DD format. Each entry represents a single settlement (presentment or chargeback) and carries paymentId linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook transactionId, use /transactions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dash.fi Developers\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.dash.fi/api-reference/financial/list-card-settlements\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dashfi-developers.mintlify.site/_mintlify/api/og/v2?division=Financial\u0026amp;title=List+card+settlements\u0026amp;description=Retrieves+card+settlements+within+a+specified+date+range+%28max+1+year%29.+Requires+%60from%60+and+%60to%60+query+parameters+in+YYYY-MM-DD+format.%0A%0AEach+entry+represents+a+\u0026amp;theme=088cdbefbca3ca032b65b4d9\u0026amp;signature=85c579315a0536bfe8c03d28d27dc9d4a4b89998f692ee8e34a9ac04e26cc214\">\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=\"List card settlements - Dash.fi Developers\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves card settlements within a specified date range (max 1 year). Requires from and to query parameters in YYYY-MM-DD format. Each entry represents a single settlement (presentment or chargeback) and carries paymentId linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook transactionId, use /transactions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dashfi-developers.mintlify.site/_mintlify/api/og/v2?division=Financial\u0026amp;title=List+card+settlements\u0026amp;description=Retrieves+card+settlements+within+a+specified+date+range+%28max+1+year%29.+Requires+%60from%60+and+%60to%60+query+parameters+in+YYYY-MM-DD+format.%0A%0AEach+entry+represents+a+\u0026amp;theme=088cdbefbca3ca032b65b4d9\u0026amp;signature=85c579315a0536bfe8c03d28d27dc9d4a4b89998f692ee8e34a9ac04e26cc214\">\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/dashfi-developers/L0vhuBa-x7tBm0RU/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dash.fi Developers\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3EAEA4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.dash.fi/api-reference/financial/list-card-settlements\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/financial/list-card-settlements.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.dash.fi/#organization\",\"name\":\"Dash.fi Developers\",\"url\":\"https://developers.dash.fi\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dashfi-developers/4vCIsOaMEvI8SYKW/logo/dashfi-logo-black.svg?fit=max\u0026auto=format\u0026n=4vCIsOaMEvI8SYKW\u0026q=85\u0026s=da5748857dff00ecce634beb4f22f4bf\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.dash.fi#website\",\"name\":\"Dash.fi Developers\",\"url\":\"https://developers.dash.fi\",\"publisher\":{\"@id\":\"https://developers.dash.fi/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements#webpage\",\"url\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements\",\"name\":\"List card settlements\",\"description\":\"Retrieves card settlements within a specified date range (max 1 year). Requires from and to query parameters in YYYY-MM-DD format. Each entry represents a single settlement (presentment or chargeback) and carries paymentId linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook transactionId, use /transactions.\",\"dateModified\":\"2026-08-27T05:17:44.951Z\",\"isPartOf\":{\"@id\":\"https://developers.dash.fi#website\"},\"breadcrumb\":{\"@id\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Financial\",\"item\":\"https://developers.dash.fi/api-reference/financial/get-account-balance\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List card settlements\",\"item\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements#apireference\",\"headline\":\"List card settlements\",\"name\":\"List card settlements\",\"description\":\"Retrieves card settlements within a specified date range (max 1 year). Requires from and to query parameters in YYYY-MM-DD format. Each entry represents a single settlement (presentment or chargeback) and carries paymentId linking it to the payment that cleared it. For the full transaction lifecycle (pending / declined / settled / released) or to reconcile against webhook transactionId, use /transactions.\",\"url\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements\",\"mainEntityOfPage\":{\"@id\":\"https://developers.dash.fi/api-reference/financial/list-card-settlements#webpage\"},\"dateModified\":\"2026-08-27T05:17:44.951Z\",\"publisher\":{\"@id\":\"https://developers.dash.fi/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.dash.fi#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dash.fi Developers\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Dash.fi Developers","nav":{"global":null,"tabs":[{"tab":"Getting Started","icon":"rocket","pages":[{"title":"Getting Started","href":"/api-reference/introduction"}]},{"tab":"MCP Server","icon":"cpu","pages":[{"title":"MCP Server","href":"/mcp-server"}]},{"tab":"API Reference","icon":"terminal","groups":[{"group":"Account","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /accounts","href":"/api-reference/account/list-accounts"},{"title":"Create an account","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 post /accounts","href":"/api-reference/account/create-an-account"},{"title":"Get an account","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /accounts/{account-id}","href":"/api-reference/account/get-an-account"},{"title":"Rename an account","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 patch /accounts/{account-id}","href":"/api-reference/account/rename-an-account"},{"title":"Transfer between accounts","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 post /accounts/{account-id}/transfers","href":"/api-reference/account/transfer-between-accounts"}]},{"group":"Financial","pages":[{"title":"Get account balance","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /balance","href":"/api-reference/financial/get-account-balance"},{"title":"Get payments","description":"Retrieves a list of payments within a specified date range (max 1 year). Not available for WEX accounts, which answer 400 with code `unsupported-account-type`.","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /payments","href":"/api-reference/financial/get-payments"},{"title":"List card settlements","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /settlements","href":"/api-reference/financial/list-card-settlements"},{"title":"List card transactions","description":"Retrieves a paginated list of card transactions for the authenticated account. Each entry's `id` matches the `transactionId` field emitted on card financial event webhooks, so webhook deliveries and API rows can be reconciled directly. Returned in reverse chronological order by `createdAt`.\n\nIf both pagination parameters are not provided, a default of page 1 with size 100 is used. Max page size is 100. For post-settlement reconciliation against payment cycles, see `/settlements`.","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /transactions","href":"/api-reference/financial/list-card-transactions"},{"title":"Get a card transaction by ID","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /transactions/{transaction-id}","href":"/api-reference/financial/get-a-card-transaction-by-id"}]},{"group":"Card","pages":[{"title":"Get cards","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /cards","href":"/api-reference/card/get-cards"},{"title":"Create a card","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 post /cards","href":"/api-reference/card/create-a-card"},{"title":"Get a card","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /cards/{card-id}","href":"/api-reference/card/get-a-card"},{"title":"Update a card","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 patch /cards/{card-id}","href":"/api-reference/card/update-a-card"},{"title":"Archive a card","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 post /cards/{card-id}/archive","href":"/api-reference/card/archive-a-card"},{"title":"Get card financial events","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /cards/{card-id}/financial-events","href":"/api-reference/card/get-card-financial-events"},{"title":"Freeze a card","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 post /cards/{card-id}/freeze","href":"/api-reference/card/freeze-a-card"},{"title":"Get sensitive details","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /cards/{card-id}/sensitive-details","href":"/api-reference/card/get-sensitive-details"},{"title":"Unfreeze a card","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 post /cards/{card-id}/unfreeze","href":"/api-reference/card/unfreeze-a-card"}]},{"group":"Health","pages":[{"title":"Health status of the service.","deprecated":null,"version":null,"openapi":"https://api.dash.fi/v1/public/swagger/doc.json?rev=23aaa263bb20308cbc7f24f28da5e83275c855def9ff1a81b8bf6970ae335383 get /health","href":"/api-reference/health/health-status-of-the-service"}]}]}]},"basePath":"","title":"List card settlements - Dash.fi Developers","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}