Retrieves orders for a specific customer. The request body is optional — omitting it
returns the first page with defaults (pageSize 30, pageNumber 0, no filters).
Returns on/off-ramp orders only — swaps are not included. Track swaps via swap_updated webhooks.
URL to fetch the next page of results, if available.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Etherfuse API","colors":{"primary":"#141414","light":"#E4FF3F","dark":"#141414"},"logo":{"light":"https://mintcdn.com/etherfuse/XRSchVFGUgreQatD/img/logo-black.svg?fit=max\u0026auto=format\u0026n=XRSchVFGUgreQatD\u0026q=85\u0026s=92cf84eca27df4a19f7b032da398d110","dark":"https://mintcdn.com/etherfuse/XRSchVFGUgreQatD/img/logo-white.svg?fit=max\u0026auto=format\u0026n=XRSchVFGUgreQatD\u0026q=85\u0026s=7c87780c9a248347ffe6357ccf6762ed","href":"https://etherfuse.com"},"favicon":"https://mintcdn.com/etherfuse/pF4txuzXWQE790kS/img/favicon.png?fit=max\u0026auto=format\u0026n=pF4txuzXWQE790kS\u0026q=85\u0026s=ac74be5f7f4605e75bc961be0c6e5ff9","api":{"playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python"],"autogenerate":true}},"navbar":{"links":[{"href":"https://cal.com/team/etherfuse/api-overview?overlayCalendar=true","label":"Book a demo"},{"href":"https://app.etherfuse.com","label":"App"}],"primary":{"type":"button","label":"Get sandbox keys","href":"https://sandbox.etherfuse.com/sign-in?returnTo=%2Faccount%2Fmanage"}},"footer":{"links":[{"items":[{"label":"Website","href":"https://etherfuse.com"},{"label":"App","href":"https://app.etherfuse.com"},{"label":"Book a demo","href":"https://cal.com/team/etherfuse/api-overview?overlayCalendar=true"}]}]},"fonts":{"family":"Figtree"},"integrations":{"posthog":{"apiKey":"phc_vJEpZk4aZr9PxdPqapjg8ZKWFybTTmDvAxZNg88LTuPu","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"etherfuse","hasAudioNarration":false,"actualSubdomain":"etherfuse","customDomains":["docs.etherfuse.com"],"gitSource":{"type":"github","owner":"etherfuse","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae3779d1c0f0903e5d7bbe7","collectionId":"954573e7-24c6-4c9a-8b93-551f6122b6ad","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae3779d1c0f0903e5d7bbe7"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae3779d1c0f0903e5d7bbe7","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API Reference","count":151},{"language":"default","tag":"Ramp API","count":72},{"language":"default","tag":"Guides","count":65},{"language":"default","tag":"KYC","count":20},{"language":"default","tag":"Lookup API","count":18},{"language":"default","tag":"Orders","count":17},{"language":"default","tag":"Organizations","count":16},{"language":"default","tag":"User Authentication","count":12},{"language":"default","tag":"Blockchains","count":12},{"language":"default","tag":"Integration Guides","count":12}]},"assistantConfig":{},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"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":"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":"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}],"googleFontsInlined":true},"customCss":[{"filePath":"global.css","content":"body{scrollbar-gutter:stable}.sandbox-playground-cta{display:block;margin:1rem 0 1.25rem;padding:1rem 1.25rem;border-radius:.75rem;border:1px solid #141414;background-color:#e4ff3f;color:#141414!important;text-decoration:none;transition:background-color .15s ease,box-shadow .15s ease}.sandbox-playground-cta:hover{background-color:#d8f32f;box-shadow:0 2px 8px rgba(20,20,20,.12);color:#141414!important}.sandbox-playground-cta__body,.sandbox-playground-cta__detail,.sandbox-playground-cta__title{color:inherit!important}.dark .sandbox-playground-cta{border-color:#e4ff3f;background-color:#e4ff3f;color:#141414!important}.dark .sandbox-playground-cta:hover{background-color:#d8f32f;color:#141414!important}.sandbox-playground-cta__title{display:block;font-size:1rem;font-weight:600;margin-bottom:.35rem}.sandbox-playground-cta__body{display:block;font-size:.95rem;line-height:1.45;font-weight:500}.sandbox-playground-cta__detail{display:block;margin-top:.35rem;font-size:.85rem;line-height:1.45;opacity:.85}"}],"page":{"pagePath":"api-reference/orders/search-customer-orders","slug":"/api-reference/orders/search-customer-orders","pageMetadata":{"title":"Search customer orders","description":"Retrieves orders for a specific customer. The request body is optional — omitting it\nreturns the first page with defaults (pageSize 30, pageNumber 0, no filters).\n\nReturns on/off-ramp orders only — swaps are not included. Track swaps via `swap_updated` webhooks.","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/orders","href":"/api-reference/orders/search-customer-orders","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: [_jsx(_components.p, {\n children: \"Retrieves orders for a specific customer. The request body is optional — omitting it\\nreturns the first page with defaults (pageSize 30, pageNumber 0, no filters).\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Returns on/off-ramp orders only — swaps are not included. Track swaps via \", _jsx(_components.code, {\n children: \"swap_updated\"\n }), \" webhooks.\"]\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":"Search customer orders","description":"Retrieves orders for a specific customer. The request body is optional — omitting it\nreturns the first page with defaults (pageSize 30, pageNumber 0, no filters).\n\nReturns on/off-ramp orders only — swaps are not included. Track swaps via `swap_updated` webhooks.","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/orders","href":"/api-reference/orders/search-customer-orders","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Orders"],"summary":"Search customer orders","description":"Retrieves orders for a specific customer. The request body is optional — omitting it\nreturns the first page with defaults (pageSize 30, pageNumber 0, no filters).\n\nReturns on/off-ramp orders only — swaps are not included. Track swaps via `swap_updated` webhooks.","operationId":"get_customer_orders","parameters":["2afdab5d-49d8-4e68-b450-948cc117e224"],"requestBody":"25258056-6c70-4f7a-b1e1-31ddc19cc67c","responses":{"200":"7bb2ab10-31a0-43dc-9868-5588c49255c2","404":"107b5aa4-58ed-414c-a26d-c44f7c2bdc64"},"method":"post","type":"path","servers":["5b2726ff-68c2-4cd4-86ba-a3ca5b043bf9"],"security":["4763c3ad-1e8c-45b3-9b31-4cc591887834"],"path":"/ramp/customer/{customer_id}/orders","baseUrlOptions":["https://api.sand.etherfuse.com"],"title":"Search customer orders","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"2afdab5d-49d8-4e68-b450-948cc117e224":{"name":"customer_id","in":"path","description":"The customer (child org) ID. Must belong to the caller's organization or a direct child.","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"description":"The customer (child org) ID. Must belong to the caller's organization or a direct child.","uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"object","required":["fromDate"],"properties":{"fromDate":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"filters.fromDate","typeLabel":"string\u003cdate-time>"},"toDate":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"filters.toDate.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"filters.toDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.toDate","typeLabel":"string\u003cdate-time> | null"}},"example":{"fromDate":"2026-01-01T00:00:00Z","toDate":"2026-06-01T00:00:00Z"},"uniqueKey":"filters","typeLabel":"object"},"pageNumber":{"type":"integer","description":"which page of results to return (starts at 0)","minimum":0,"uniqueKey":"pageNumber","typeLabel":"integer"},"pageSize":{"type":"integer","description":"The number of items to get back in one page","minimum":0,"uniqueKey":"pageSize","typeLabel":"integer"}},"example":{"pageNumber":0,"pageSize":30},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"pageNumber":0,"pageSize":30}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"7bb2ab10-31a0-43dc-9868-5588c49255c2":{"description":"Paginated orders","content":{"application/json":{"schema":{"type":"object","description":"A page of orders.","required":["items","totalItems","pageSize","pageNumber","totalPages"],"properties":{"items":{"type":"array","items":{"type":"object","description":"Order representation for WebSocket messages","required":["orderId","customerId","createdAt","updatedAt","walletId","bankAccountId","orderType","status","statusPage"],"properties":{"bankAccountId":{"type":"string","format":"uuid","description":"ID of the bank account used for the order.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].bankAccountId","typeLabel":"string\u003cuuid>"},"createdAt":{"type":"string","format":"date-time","description":"Timestamp when the order was created.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"customerId":{"type":"string","format":"uuid","description":"Organization ID associated with the order. In webhook payloads, this is the\nrecipient organization's ID.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].customerId","typeLabel":"string\u003cuuid>"},"orderId":{"type":"string","format":"uuid","description":"Unique identifier for the order.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].orderId","typeLabel":"string\u003cuuid>"},"orderType":{"type":"string","description":"Type of the order (onramp/offramp/swap).","enum":["onramp","offramp"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].orderType","typeLabel":"enum\u003cstring>"},"status":{"type":"string","description":"Current status of the order. For offramps, `completed` means fiat has been sent to\nthe customer; `finalized` means the reversal window has passed and the funds can no\nlonger be returned.","enum":["created","funded","completed","failed","refunded","canceled","finalized"],"isRequired":true,"uniqueKey":"\\items.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"statusPage":{"type":"string","description":"URL to an Etherfuse-branded page where the customer can view order status and sign\ntransactions (for offramps). Can be used as an alternative to handling transaction\nsigning in your own application. The page requires an Etherfuse sign in with an account in the\norder's organization or its parent organization.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].statusPage","typeLabel":"string"},"updatedAt":{"type":"string","format":"date-time","description":"Timestamp when the order was last updated.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].updatedAt","typeLabel":"string\u003cdate-time>"},"walletId":{"type":"string","format":"uuid","description":"ID of the wallet used for the order.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].walletId","typeLabel":"string\u003cuuid>"},"amountInFiat":{"oneOf":[{"type":"string","description":"Amount in fiat currency (e.g. MXN).","uniqueKey":"\\items.items.[INDEX].amountInFiat.oneOf.0","typeLabel":"string"},{"type":"null","description":"Amount in fiat currency (e.g. MXN).","uniqueKey":"\\items.items.[INDEX].amountInFiat.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].amountInFiat","typeLabel":"string | null"},"amountInTokens":{"oneOf":[{"type":"string","description":"Amount in crypto tokens.","uniqueKey":"\\items.items.[INDEX].amountInTokens.oneOf.0","typeLabel":"string"},{"type":"null","description":"Amount in crypto tokens.","uniqueKey":"\\items.items.[INDEX].amountInTokens.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].amountInTokens","typeLabel":"string | null"},"blockchain":{"oneOf":[{"type":"null","uniqueKey":"\\items.items.[INDEX].blockchain.oneOf.0","typeLabel":"null"},{"type":"string","description":"Blockchain the order settles on.","enum":["stellar","solana","base","polygon","monad","avalanche"],"uniqueKey":"\\items.items.[INDEX].blockchain.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"\\items.items.[INDEX].blockchain","typeLabel":"null | enum\u003cstring>"},"burnTransaction":{"oneOf":[{"type":"string","description":"Encoded transaction for the user to sign (bring-your-own-wallet offramp orders). Embedded wallets omit this and instead surface `approval` on the order; sign via POST /ramp/order/{order_id}/approvals. See [Embedded Wallets](/guides/embedded-wallets).","uniqueKey":"\\items.items.[INDEX].burnTransaction.oneOf.0","typeLabel":"string"},{"type":"null","description":"Encoded transaction for the user to sign (bring-your-own-wallet offramp orders). Embedded wallets omit this and instead surface `approval` on the order; sign via POST /ramp/order/{order_id}/approvals. See [Embedded Wallets](/guides/embedded-wallets).","uniqueKey":"\\items.items.[INDEX].burnTransaction.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].burnTransaction","typeLabel":"string | null"},"completedAt":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the order was completed.","uniqueKey":"\\items.items.[INDEX].completedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the order was completed.","uniqueKey":"\\items.items.[INDEX].completedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].completedAt","typeLabel":"string\u003cdate-time> | null"},"confirmedTxSignature":{"oneOf":[{"type":"string","description":"Blockchain transaction hash, set once the crypto transfer is confirmed.","uniqueKey":"\\items.items.[INDEX].confirmedTxSignature.oneOf.0","typeLabel":"string"},{"type":"null","description":"Blockchain transaction hash, set once the crypto transfer is confirmed.","uniqueKey":"\\items.items.[INDEX].confirmedTxSignature.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].confirmedTxSignature","typeLabel":"string | null"},"trackingCode":{"oneOf":[{"type":"string","description":"SPEI tracking key (clave de rastreo) for the order's fiat transfer. On onramps this is the incoming deposit's clave; on offramps it is the outgoing payout's clave. Present once the SPEI transfer settles — use it to look up the CEP (Comprobante Electrónico de Pago) receipt. Absent until then.","uniqueKey":"\\items.items.[INDEX].trackingCode.oneOf.0","typeLabel":"string"},{"type":"null","description":"SPEI tracking key (clave de rastreo) for the order's fiat transfer. On onramps this is the incoming deposit's clave; on offramps it is the outgoing payout's clave. Present once the SPEI transfer settles — use it to look up the CEP (Comprobante Electrónico de Pago) receipt. Absent until then.","uniqueKey":"\\items.items.[INDEX].trackingCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].trackingCode","typeLabel":"string | null"},"deletedAt":{"oneOf":[{"type":"string","format":"date-time","description":"Timestamp when the order was deleted (if applicable).","uniqueKey":"\\items.items.[INDEX].deletedAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Timestamp when the order was deleted (if applicable).","uniqueKey":"\\items.items.[INDEX].deletedAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].deletedAt","typeLabel":"string\u003cdate-time> | null"},"depositAccountHolder":{"oneOf":[{"type":"string","description":"Account holder name for the deposit CLABE. Hardcoded to Etherfuse MX for now.","uniqueKey":"\\items.items.[INDEX].depositAccountHolder.oneOf.0","typeLabel":"string"},{"type":"null","description":"Account holder name for the deposit CLABE. Hardcoded to Etherfuse MX for now.","uniqueKey":"\\items.items.[INDEX].depositAccountHolder.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].depositAccountHolder","typeLabel":"string | null"},"depositBankName":{"oneOf":[{"type":"string","description":"Name of the bank that holds the deposit CLABE.","uniqueKey":"\\items.items.[INDEX].depositBankName.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the bank that holds the deposit CLABE.","uniqueKey":"\\items.items.[INDEX].depositBankName.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].depositBankName","typeLabel":"string | null"},"depositClabe":{"oneOf":[{"type":"string","description":"CLABE number for deposit (onramp orders only).","uniqueKey":"\\items.items.[INDEX].depositClabe.oneOf.0","typeLabel":"string"},{"type":"null","description":"CLABE number for deposit (onramp orders only).","uniqueKey":"\\items.items.[INDEX].depositClabe.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].depositClabe","typeLabel":"string | null"},"etherfuseMidMarketRate":{"oneOf":[{"type":"string","description":"Raw mid-market rate before fees","uniqueKey":"\\items.items.[INDEX].etherfuseMidMarketRate.oneOf.0","typeLabel":"string"},{"type":"null","description":"Raw mid-market rate before fees","uniqueKey":"\\items.items.[INDEX].etherfuseMidMarketRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].etherfuseMidMarketRate","typeLabel":"string | null"},"exchangeRate":{"oneOf":[{"type":"string","description":"Fee-inclusive exchange rate between source and target assets","uniqueKey":"\\items.items.[INDEX].exchangeRate.oneOf.0","typeLabel":"string"},{"type":"null","description":"Fee-inclusive exchange rate between source and target assets","uniqueKey":"\\items.items.[INDEX].exchangeRate.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].exchangeRate","typeLabel":"string | null"},"feeAmountInFiat":{"oneOf":[{"type":"string","description":"Quoted fee amount in fiat currency, derived from fee_bps × order amount.","uniqueKey":"\\items.items.[INDEX].feeAmountInFiat.oneOf.0","typeLabel":"string"},{"type":"null","description":"Quoted fee amount in fiat currency, derived from fee_bps × order amount.","uniqueKey":"\\items.items.[INDEX].feeAmountInFiat.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].feeAmountInFiat","typeLabel":"string | null"},"feeBps":{"oneOf":[{"type":"integer","format":"int32","description":"Fee in basis points (e.g., 20 = 0.20%). Always present when order was created with a quote.","minimum":0,"uniqueKey":"\\items.items.[INDEX].feeBps.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"Fee in basis points (e.g., 20 = 0.20%). Always present when order was created with a quote.","minimum":0,"uniqueKey":"\\items.items.[INDEX].feeBps.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].feeBps","typeLabel":"integer\u003cint32> | null"},"isAnchorOrder":{"oneOf":[{"type":"boolean","description":"Whether this is an anchor order (SEP-24 mode — no pre-signed TX)","uniqueKey":"\\items.items.[INDEX].isAnchorOrder.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this is an anchor order (SEP-24 mode — no pre-signed TX)","uniqueKey":"\\items.items.[INDEX].isAnchorOrder.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].isAnchorOrder","typeLabel":"boolean | null"},"memo":{"oneOf":[{"type":"string","description":"Optional memo for the order.","uniqueKey":"\\items.items.[INDEX].memo.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional memo for the order.","uniqueKey":"\\items.items.[INDEX].memo.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].memo","typeLabel":"string | null"},"partnerFeeAmountFiat":{"oneOf":[{"type":"string","description":"Partner fee amount collected in fiat currency, derived from the total fee using the\npartner fee ratio.","uniqueKey":"\\items.items.[INDEX].partnerFeeAmountFiat.oneOf.0","typeLabel":"string"},{"type":"null","description":"Partner fee amount collected in fiat currency, derived from the total fee using the\npartner fee ratio.","uniqueKey":"\\items.items.[INDEX].partnerFeeAmountFiat.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].partnerFeeAmountFiat","typeLabel":"string | null"},"partnerFeeBps":{"oneOf":[{"type":"integer","format":"int32","description":"Partner fee in basis points applied to this order (e.g. 100 = 1.00%). Only present\nwhen a partner fee was configured at quote time.","uniqueKey":"\\items.items.[INDEX].partnerFeeBps.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","format":"int32","description":"Partner fee in basis points applied to this order (e.g. 100 = 1.00%). Only present\nwhen a partner fee was configured at quote time.","uniqueKey":"\\items.items.[INDEX].partnerFeeBps.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].partnerFeeBps","typeLabel":"integer\u003cint32> | null"},"partnerFeeStatus":{"oneOf":[{"type":"string","description":"Disbursement status of the partner fee. Only present when `partnerFeeBps` > 0:\n`none` — order not yet completed; `pending` — order completed, fee awaiting offline\ndisbursement; `disbursed` — partner fee has been paid out.","uniqueKey":"\\items.items.[INDEX].partnerFeeStatus.oneOf.0","typeLabel":"string"},{"type":"null","description":"Disbursement status of the partner fee. Only present when `partnerFeeBps` > 0:\n`none` — order not yet completed; `pending` — order completed, fee awaiting offline\ndisbursement; `disbursed` — partner fee has been paid out.","uniqueKey":"\\items.items.[INDEX].partnerFeeStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].partnerFeeStatus","typeLabel":"string | null"},"sourceAsset":{"oneOf":[{"type":"string","description":"Source asset identifier. For onramps this is the fiat currency (e.g. `MXN`); for\nofframps it is the crypto asset identifier.","uniqueKey":"\\items.items.[INDEX].sourceAsset.oneOf.0","typeLabel":"string"},{"type":"null","description":"Source asset identifier. For onramps this is the fiat currency (e.g. `MXN`); for\nofframps it is the crypto asset identifier.","uniqueKey":"\\items.items.[INDEX].sourceAsset.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].sourceAsset","typeLabel":"string | null"},"approval":{"oneOf":[{"type":"object","description":"Pending embedded-wallet approval. Present only when the order is awaiting the owner's signature. The owner signs `approvalMessage` and submits it to POST /ramp/order/{order_id}/approvals. Re-read the order right before signing: `approvalMessage` embeds a timestamp that re-mints on each read. Delivered on the order read, the `order_updated` webhook, and the WebSocket stream.","properties":{"approvalMessageId":{"type":"string","format":"uuid","description":"Identifies the proposal being approved. Echoed back on submit so a superseded proposal (re-proposed on expiry) is rejected as stale.","uniqueKey":"\\items.items.[INDEX].approval.oneOf.0.approvalMessageId","typeLabel":"string\u003cuuid>"},"approvalMessage":{"type":"string","description":"The exact bytes the owner signs with their key. Built fresh on each read so the request is current when signed.","uniqueKey":"\\items.items.[INDEX].approval.oneOf.0.approvalMessage","typeLabel":"string"},"summary":{"type":"string","description":"Human-readable description of what is being approved (e.g. `Claim 99.61 CETES`). Present only when set.","uniqueKey":"\\items.items.[INDEX].approval.oneOf.0.summary","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX].approval.oneOf.0","typeLabel":"object"},{"type":"null","description":"Pending embedded-wallet approval. Present only when the order is awaiting the owner's signature. The owner signs `approvalMessage` and submits it to POST /ramp/order/{order_id}/approvals. Re-read the order right before signing: `approvalMessage` embeds a timestamp that re-mints on each read. Delivered on the order read, the `order_updated` webhook, and the WebSocket stream.","properties":{"approvalMessageId":{"type":"string","format":"uuid","description":"Identifies the proposal being approved. Echoed back on submit so a superseded proposal (re-proposed on expiry) is rejected as stale."},"approvalMessage":{"type":"string","description":"The exact bytes the owner signs with their key. Built fresh on each read so the request is current when signed."},"summary":{"type":"string","description":"Human-readable description of what is being approved (e.g. `Claim 99.61 CETES`). Present only when set."}},"uniqueKey":"\\items.items.[INDEX].approval.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].approval","typeLabel":"object | null"},"stellarClaimTransaction":{"oneOf":[{"type":"string","description":"Unsigned XDR (base64) for the claim TX (ChangeTrust + ClaimClaimableBalance).\nThe user signs this and submits to Horizon to receive their tokens.","uniqueKey":"\\items.items.[INDEX].stellarClaimTransaction.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unsigned XDR (base64) for the claim TX (ChangeTrust + ClaimClaimableBalance).\nThe user signs this and submits to Horizon to receive their tokens.","uniqueKey":"\\items.items.[INDEX].stellarClaimTransaction.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].stellarClaimTransaction","typeLabel":"string | null"},"stellarClaimableBalanceId":{"oneOf":[{"type":"string","description":"Stellar claimable balance ID (hex). Present when tokens were delivered via claimable balance.\nThe user must sign a claim TX to receive their tokens.","uniqueKey":"\\items.items.[INDEX].stellarClaimableBalanceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Stellar claimable balance ID (hex). Present when tokens were delivered via claimable balance.\nThe user must sign a claim TX to receive their tokens.","uniqueKey":"\\items.items.[INDEX].stellarClaimableBalanceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].stellarClaimableBalanceId","typeLabel":"string | null"},"targetAsset":{"oneOf":[{"type":"string","description":"Target asset identifier. For onramps this is the crypto asset identifier; for\nofframps it is the fiat currency (e.g. `MXN`).","uniqueKey":"\\items.items.[INDEX].targetAsset.oneOf.0","typeLabel":"string"},{"type":"null","description":"Target asset identifier. For onramps this is the crypto asset identifier; for\nofframps it is the fiat currency (e.g. `MXN`).","uniqueKey":"\\items.items.[INDEX].targetAsset.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].targetAsset","typeLabel":"string | null"},"withdrawAnchorAccount":{"oneOf":[{"type":"string","description":"Anchor destination account for SEP-24 anchor offramps","uniqueKey":"\\items.items.[INDEX].withdrawAnchorAccount.oneOf.0","typeLabel":"string"},{"type":"null","description":"Anchor destination account for SEP-24 anchor offramps","uniqueKey":"\\items.items.[INDEX].withdrawAnchorAccount.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].withdrawAnchorAccount","typeLabel":"string | null"},"withdrawMemo":{"oneOf":[{"type":"string","description":"Memo to include in the anchor payment (derived from transaction_id)","uniqueKey":"\\items.items.[INDEX].withdrawMemo.oneOf.0","typeLabel":"string"},{"type":"null","description":"Memo to include in the anchor payment (derived from transaction_id)","uniqueKey":"\\items.items.[INDEX].withdrawMemo.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].withdrawMemo","typeLabel":"string | null"},"withdrawMemoType":{"oneOf":[{"type":"string","description":"Memo type for the anchor payment (always \"hash\" for anchor orders)","uniqueKey":"\\items.items.[INDEX].withdrawMemoType.oneOf.0","typeLabel":"string"},{"type":"null","description":"Memo type for the anchor payment (always \"hash\" for anchor orders)","uniqueKey":"\\items.items.[INDEX].withdrawMemoType.oneOf.1","typeLabel":"null"}],"uniqueKey":"\\items.items.[INDEX].withdrawMemoType","typeLabel":"string | null"}},"example":{"amountInFiat":"1000.00","amountInTokens":"58.42","bankAccountId":"b2c3d4e5-f6a7-8901-bcde-f12345678901","blockchain":"stellar","completedAt":"2026-05-02T09:16:30Z","createdAt":"2026-05-02T09:15:00Z","customerId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","depositAccountHolder":"Etherfuse MX","depositBankName":"Example Bank","depositClabe":"646180157000000004","etherfuseMidMarketRate":"17.15","exchangeRate":"17.12","feeAmountInFiat":"2.00","feeBps":20,"orderId":"7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e","orderType":"onramp","sourceAsset":"MXN","status":"completed","statusPage":"https://app.etherfuse.com/ramp/order/7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e","stellarClaimTransaction":"AAAAAgAAAABk...base64_xdr...","stellarClaimableBalanceId":"00000000abc1230000000000000000000000000000000000000000000000000000","targetAsset":"USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5","updatedAt":"2026-05-02T09:16:30Z","walletId":"c3d4e5f6-a7b8-9012-cdef-123456789012"},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"description":"The items on this page.","isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"pageNumber":{"type":"integer","description":"Zero-based index of this page.","example":0,"minimum":0,"isRequired":true,"uniqueKey":"pageNumber","typeLabel":"integer"},"pageSize":{"type":"integer","description":"Number of items per page.","example":30,"minimum":0,"isRequired":true,"uniqueKey":"pageSize","typeLabel":"integer"},"totalItems":{"type":"integer","description":"Total number of items across all pages.","example":42,"minimum":0,"isRequired":true,"uniqueKey":"totalItems","typeLabel":"integer"},"totalPages":{"type":"integer","description":"Total number of pages.","example":2,"minimum":0,"isRequired":true,"uniqueKey":"totalPages","typeLabel":"integer"},"next":{"oneOf":[{"type":"string","description":"URL to fetch the next page of results, if available.","uniqueKey":"next.oneOf.0","typeLabel":"string"},{"type":"null","description":"URL to fetch the next page of results, if available.","uniqueKey":"next.oneOf.1","typeLabel":"null"}],"uniqueKey":"next","typeLabel":"string | null"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"items":[{"amountInFiat":"1000.00","amountInTokens":"58.42","bankAccountId":"b2c3d4e5-f6a7-8901-bcde-f12345678901","blockchain":"stellar","completedAt":"2026-05-02T09:16:30Z","createdAt":"2026-05-02T09:15:00Z","customerId":"a1b2c3d4-e5f6-7890-abcd-ef1234567890","depositAccountHolder":"Etherfuse MX","depositBankName":"Example Bank","depositClabe":"646180157000000004","etherfuseMidMarketRate":"17.15","exchangeRate":"17.12","feeAmountInFiat":"2.00","feeBps":20,"orderId":"7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e","orderType":"onramp","sourceAsset":"MXN","status":"completed","statusPage":"https://app.etherfuse.com/ramp/order/7b9c1e2d-3f4a-5b6c-7d8e-9f0a1b2c3d4e","stellarClaimTransaction":"AAAAAgAAAABk...base64_xdr...","stellarClaimableBalanceId":"00000000abc1230000000000000000000000000000000000000000000000000000","targetAsset":"USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5","updatedAt":"2026-05-02T09:16:30Z","walletId":"c3d4e5f6-a7b8-9012-cdef-123456789012"}],"pageNumber":0,"pageSize":30,"totalItems":42,"totalPages":2,"next":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"107b5aa4-58ed-414c-a26d-c44f7c2bdc64":{"description":"No organization exists with that `customer_id`, or it is not a customer of your organization.","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"4763c3ad-1e8c-45b3-9b31-4cc591887834":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"API key sent in the Authorization header.","scopes":[],"schemeName":"ApiKeyAuth"}}},"servers":{"5b2726ff-68c2-4cd4-86ba-a3ca5b043bf9":{"url":"https://api.sand.etherfuse.com","description":"Sandbox"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"API key sent in the Authorization header.","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"Authorization","type":"string","description":"API key sent in the Authorization header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"Authorization"}],"title":"ApiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"etherfuse","siteName":"Etherfuse API","title":"Search customer orders - Etherfuse API","navMaps":{"firstHrefInVersion":{"v2 (beta)":{"href":"/v2","matchLevel":4},"v1 (legacy)":{"href":"/api-reference/orders/search-customer-orders","matchLevel":0}},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T16:43:40.367Z","originalFileLocation":"api-reference/orders/search-customer-orders.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 orders for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters). Returns on/off-ramp orders only — swaps are not included. Track swaps via swap_updated webhooks.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Etherfuse API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_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/etherfuse/2PYR-_ECBzhTGa_z/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search customer orders - Etherfuse API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieves orders for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters). Returns on/off-ramp orders only — swaps are not included. Track swaps via swap_updated webhooks.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Etherfuse API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://etherfuse.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Search+customer+orders\u0026amp;description=Retrieves+orders+for+a+specific+customer.+The+request+body+is+optional+%E2%80%94+omitting+it%0Areturns+the+first+page+with+defaults+%28pageSize+30%2C+pageNumber+0%2C+no+filters\u0026amp;theme=a63046a1b6875a84019a21bc\u0026amp;signature=f2abef20cdfd556dd1d054f8f4dc2345d322c2ac460ec1c6f190621a652af664\">\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=\"Search customer orders - Etherfuse API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieves orders for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters). Returns on/off-ramp orders only — swaps are not included. Track swaps via swap_updated webhooks.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://etherfuse.mintlify.app/_mintlify/api/og/v2?division=Orders\u0026amp;title=Search+customer+orders\u0026amp;description=Retrieves+orders+for+a+specific+customer.+The+request+body+is+optional+%E2%80%94+omitting+it%0Areturns+the+first+page+with+defaults+%28pageSize+30%2C+pageNumber+0%2C+no+filters\u0026amp;theme=a63046a1b6875a84019a21bc\u0026amp;signature=f2abef20cdfd556dd1d054f8f4dc2345d322c2ac460ec1c6f190621a652af664\">\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/etherfuse/2PYR-_ECBzhTGa_z/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Etherfuse API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#141414\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/orders/search-customer-orders.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.etherfuse.com/#organization\",\"name\":\"Etherfuse API\",\"url\":\"https://docs.etherfuse.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/etherfuse/XRSchVFGUgreQatD/img/logo-black.svg?fit=max\u0026auto=format\u0026n=XRSchVFGUgreQatD\u0026q=85\u0026s=92cf84eca27df4a19f7b032da398d110\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.etherfuse.com#website\",\"name\":\"Etherfuse API\",\"url\":\"https://docs.etherfuse.com\",\"publisher\":{\"@id\":\"https://docs.etherfuse.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders#webpage\",\"url\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders\",\"name\":\"Search customer orders\",\"description\":\"Retrieves orders for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters). Returns on/off-ramp orders only — swaps are not included. Track swaps via swap_updated webhooks.\",\"dateModified\":\"2026-10-29T16:43:40.367Z\",\"isPartOf\":{\"@id\":\"https://docs.etherfuse.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Ramp API\",\"item\":\"https://docs.etherfuse.com/api-reference/assets/list-assets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Orders\",\"item\":\"https://docs.etherfuse.com/api-reference/orders/create-order\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Search customer orders\",\"item\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders#apireference\",\"headline\":\"Search customer orders\",\"name\":\"Search customer orders\",\"description\":\"Retrieves orders for a specific customer. The request body is optional — omitting it returns the first page with defaults (pageSize 30, pageNumber 0, no filters). Returns on/off-ramp orders only — swaps are not included. Track swaps via swap_updated webhooks.\",\"url\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders\",\"mainEntityOfPage\":{\"@id\":\"https://docs.etherfuse.com/api-reference/orders/search-customer-orders#webpage\"},\"dateModified\":\"2026-10-29T16:43:40.367Z\",\"publisher\":{\"@id\":\"https://docs.etherfuse.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.etherfuse.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Etherfuse API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Etherfuse API","nav":{"global":null,"versions":[{"version":"v2 (beta)","default":true,"pages":[{"title":"v2 (beta)","href":"/v2"}]},{"version":"v1 (legacy)","tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API Reference","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"API Authentication","href":"/authentication"},{"title":"Errors","href":"/errors"},{"title":"Pagination","href":"/pagination"},{"title":"Idempotency","href":"/idempotency"},{"group":"User Authentication","icon":"key","pages":[{"openapi":"openapi.json POST /auth/launch","title":"Launch a user into the app","href":"/api-reference/authentication/launch-a-user-into-the-app"},{"openapi":"openapi.json GET /auth/launch","title":"Launch a user via postMessage","href":"/api-reference/launch-via-postmessage"},{"title":"Exchange a partner JWT","deprecated":null,"version":null,"openapi":"/openapi.json post /auth/token","href":"/api-reference/authentication/exchange-a-partner-jwt"}]},{"group":"Ramp API","icon":"money-bill-transfer","pages":[{"group":"Assets","icon":"coins","pages":[{"title":"List assets","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/assets","href":"/api-reference/assets/list-assets"},{"title":"Get one wallet's balances","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/balances","href":"/api-reference/assets/get-one-wallets-balances"}]},{"group":"Bank Accounts","icon":"building-columns","pages":[{"title":"Create bank account (presigned)","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/bank-account","href":"/api-reference/bank-accounts/create-bank-account-presigned"},{"title":"Get bank account","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/bank-account/{bank_account_id}","href":"/api-reference/bank-accounts/get-bank-account"},{"title":"List bank accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/bank-accounts","href":"/api-reference/bank-accounts/list-bank-accounts"},{"title":"Search bank accounts","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/bank-accounts","href":"/api-reference/bank-accounts/search-bank-accounts"},{"title":"Create bank account (API)","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/bank-account","href":"/api-reference/bank-accounts/create-bank-account-api"},{"title":"List customer accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customer/{customer_id}/bank-accounts","href":"/api-reference/bank-accounts/list-customer-accounts"},{"title":"Search customer accounts","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/bank-accounts","href":"/api-reference/bank-accounts/search-customer-accounts"}]},{"group":"Quotes","icon":"tag","pages":[{"title":"Get quote","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/quote","href":"/api-reference/quotes/get-quote"}]},{"group":"Orders","icon":"receipt","pages":[{"title":"Create order","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/order","href":"/api-reference/orders/create-order"},{"title":"Get order","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/order/{order_id}","href":"/api-reference/orders/get-order"},{"title":"Cancel order","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/order/{order_id}/cancel","href":"/api-reference/orders/cancel-order"},{"title":"Regenerate tx","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/order/{order_id}/regenerate_tx","href":"/api-reference/orders/regenerate-tx"},{"title":"Get order approval","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/order/{order_id}/approvals","href":"/api-reference/orders/get-order-approval"},{"title":"Submit order approval","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/order/{order_id}/approvals","href":"/api-reference/orders/submit-order-approval"},{"title":"List orders","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/orders","href":"/api-reference/orders/list-orders"},{"title":"Search orders","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/orders","href":"/api-reference/orders/search-orders"},{"title":"List customer orders","description":"Returns the first page of orders for a specific customer with defaults (pageSize 30,\npageNumber 0, no filters). Use the POST variant for pagination and date filtering.\n\nReturns on/off-ramp orders only — swaps are not included. Track swaps via `swap_updated` webhooks.","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customer/{customer_id}/orders","href":"/api-reference/orders/list-customer-orders"},{"title":"Search customer orders","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/orders","href":"/api-reference/orders/search-customer-orders"}]},{"group":"Statements","icon":"file-invoice-dollar","pages":[{"title":"List partner statements","description":"Returns your monthly revenue share statements, newest first. The organization comes from your API key.\n\nOnly closed months are listed. A month still open does not appear and its CSV and PDF return 404, so the month in progress is never visible. A closed month carries no amount until a payout is recorded, because the payout is converted at a rate struck at that time.","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/partner-statements","href":"/api-reference/statements/list-partner-statements"},{"title":"Download statement CSV","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/partner-statements/{year}-{month}/csv","href":"/api-reference/statements/download-statement-csv"},{"title":"Download statement PDF","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/partner-statements/{year}-{month}/pdf","href":"/api-reference/statements/download-statement-pdf"}]},{"group":"WebSocket","icon":"plug","pages":[{"title":"Mint WebSocket token","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/ws-api-token","href":"/api-reference/websocket/mint-websocket-token"},{"title":"Connect to the live update stream","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/ws","href":"/api-reference/websocket/connect-to-the-live-update-stream"}]},{"group":"Swaps","icon":"right-left","pages":[{"title":"Swap assets","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/swap","href":"/api-reference/swaps/swap-assets"},{"title":"Regenerate swap tx","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/swap/{order_id}/regenerate_tx","href":"/api-reference/swaps/regenerate-swap-tx"}]},{"group":"Sponsored","icon":"hand-holding-dollar","pages":[{"title":"Approve EVM token","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/evm/approve","href":"/api-reference/sponsored/approve-evm-token"}]},{"group":"Customers","icon":"users","pages":[{"title":"Search customers","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customers","href":"/api-reference/customers/search-customers"},{"title":"List customers","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customers","href":"/api-reference/customers/list-customers"},{"title":"Get customer","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customer/{customer_id}","href":"/api-reference/customers/get-customer"},{"title":"List a customer's organizations","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customer/{customer_id}/organization","href":"/api-reference/customers/list-a-customers-organizations"}]},{"group":"Wallets","icon":"wallet","pages":[{"title":"Register wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/wallet","href":"/api-reference/wallets/register-wallet"},{"title":"Get wallet","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/wallet/{wallet_id}","href":"/api-reference/wallets/get-wallet"},{"title":"Delete wallet","deprecated":null,"version":null,"openapi":"/openapi.json delete /ramp/wallet/{wallet_id}","href":"/api-reference/wallets/delete-wallet"},{"title":"List wallets","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/wallets","href":"/api-reference/wallets/list-wallets"},{"title":"Search wallets","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/wallets","href":"/api-reference/wallets/search-wallets"},{"title":"Register customer wallet","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/wallet","href":"/api-reference/wallets/register-customer-wallet"},{"title":"List customer wallets","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customer/{customer_id}/wallets","href":"/api-reference/wallets/list-customer-wallets"},{"title":"Search customer wallets","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/wallets","href":"/api-reference/wallets/search-customer-wallets"}]},{"group":"KYC","icon":"id-card","pages":[{"title":"Get KYC status","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/customer/{customer_id}/kyc","href":"/api-reference/kyc/get-kyc-status"},{"title":"Submit verification data","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/verification","href":"/api-reference/kyc/submit-verification-data"},{"title":"Upload verification documents","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/verification/documents","href":"/api-reference/kyc/upload-verification-documents"},{"title":"Submit a verification questionnaire","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/verification/questionnaire","href":"/api-reference/kyc/submit-a-verification-questionnaire"},{"title":"Import a verified session","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/verification/import","href":"/api-reference/kyc/import-a-verified-session"},{"title":"List occupation categories","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/verification/occupations","href":"/api-reference/kyc/list-occupation-categories"}]},{"group":"Webhooks","icon":"bell","pages":[{"title":"Create webhook","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/webhook","href":"/api-reference/webhooks/create-webhook"},{"title":"Get webhook","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/webhook/{webhook_id}","href":"/api-reference/webhooks/get-webhook"},{"title":"Delete webhook","deprecated":null,"version":null,"openapi":"/openapi.json delete /ramp/webhook/{webhook_id}","href":"/api-reference/webhooks/delete-webhook"},{"title":"List webhooks","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/webhooks","href":"/api-reference/webhooks/list-webhooks"}]},{"group":"Webhook Events","icon":"tower-broadcast","pages":[{"title":"Order updated","version":null,"deprecated":null,"openapi":"/openapi.json webhook orderUpdated","href":"/api-reference/webhooks/order_updated"},{"title":"Swap updated","version":null,"deprecated":null,"openapi":"/openapi.json webhook swapUpdated","href":"/api-reference/webhooks/swap_updated"},{"title":"Customer updated","version":null,"deprecated":null,"openapi":"/openapi.json webhook customerUpdated","href":"/api-reference/webhooks/customer_updated"},{"title":"Bank account updated","version":null,"deprecated":null,"openapi":"/openapi.json webhook bankAccountUpdated","href":"/api-reference/webhooks/bank_account_updated"},{"title":"Kyc updated","version":null,"deprecated":null,"openapi":"/openapi.json webhook kycUpdated","href":"/api-reference/webhooks/kyc_updated"},{"title":"Kyb updated","version":null,"deprecated":null,"openapi":"/openapi.json webhook kybUpdated","href":"/api-reference/webhooks/kyb_updated"}]},{"group":"Organizations","icon":"building","pages":[{"title":"Verify API key","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp","href":"/api-reference/organizations/verify-api-key"},{"title":"Get organization","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/me","href":"/api-reference/organizations/get-organization"},{"title":"Create child org","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/organization","href":"/api-reference/organizations/create-child-org"},{"title":"Add organization member","deprecated":null,"version":null,"openapi":"/openapi.json post /ramp/organization/{id}/member","href":"/api-reference/organizations/add-organization-member"},{"title":"List organization members","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/organization/{id}/member","href":"/api-reference/organizations/list-organization-members"},{"title":"Remove organization member","deprecated":null,"version":null,"openapi":"/openapi.json delete /ramp/organization/{id}/member/{customer_id}","href":"/api-reference/organizations/remove-organization-member"},{"title":"Revoke organization invite","deprecated":null,"version":null,"openapi":"/openapi.json delete /ramp/organization/{id}/member/invite/{email}","href":"/api-reference/organizations/revoke-organization-invite"},{"title":"Get KYB status","deprecated":null,"version":null,"openapi":"/openapi.json get /ramp/organization/{id}/kyb/status","href":"/api-reference/organizations/get-kyb-status"},{"title":"Rename organization","deprecated":null,"version":null,"openapi":"/openapi.json put /ramp/organization/{org_id}/name","href":"/api-reference/organizations/rename-organization"},{"title":"Set partner fee","deprecated":null,"version":null,"openapi":"/openapi.json put /ramp/partner-fee","href":"/api-reference/organizations/set-partner-fee"}]},{"group":"Sandbox API","icon":"flask","pages":[{"title":"Simulate Fiat Received","api":"POST https://api.sand.etherfuse.com/ramp/order/fiat_received","href":"/sandbox-api/fiat-received"}]},{"group":"Deprecated","icon":"ban","pages":[{"title":"Generate onboarding URL","deprecated":true,"version":null,"openapi":"/openapi.json post /ramp/onboarding-url","href":"/api-reference/deprecated/generate-onboarding-url"},{"title":"Get onboarding bank accounts","deprecated":true,"version":null,"openapi":"/openapi.json post /ramp/onboarding/bank-accounts","href":"/api-reference/deprecated/get-onboarding-bank-accounts"},{"title":"Submit KYC","deprecated":true,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/kyc","href":"/api-reference/deprecated/submit-kyc"},{"title":"Upload KYC docs","deprecated":true,"version":null,"openapi":"/openapi.json post /ramp/customer/{customer_id}/kyc/documents","href":"/api-reference/deprecated/upload-kyc-docs"},{"title":"Get KYB progress","deprecated":true,"version":null,"openapi":"/openapi.json get /ramp/organization/{id}/kyb/progress","href":"/api-reference/deprecated/get-kyb-progress"}]}]},{"group":"Lookup API","icon":"magnifying-glass","pages":[{"title":"List exchange rates","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/exchange_rate","href":"/api-reference/lookup/list-exchange-rates"},{"title":"Get exchange rate","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/exchange_rate/usd_to_{currency}","href":"/api-reference/lookup/get-exchange-rate"},{"title":"List stablebonds","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/stablebonds","href":"/api-reference/lookup/list-stablebonds"},{"title":"Get stablebond","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/stablebond/{identifier}","href":"/api-reference/lookup/get-stablebond"},{"title":"List token costs","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/tokens/cost","href":"/api-reference/lookup/list-token-costs"},{"title":"Get token cost","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/tokens/cost/{identifier}","href":"/api-reference/lookup/get-token-cost"},{"title":"List stablebond costs","deprecated":true,"version":null,"openapi":"/openapi.json get /lookup/bonds/cost","href":"/api-reference/lookup/list-stablebond-costs"},{"title":"Get stablebond cost","deprecated":true,"version":null,"openapi":"/openapi.json get /lookup/bonds/cost/{identifier}","href":"/api-reference/lookup/get-stablebond-cost"},{"title":"List country codes","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/country-codes","href":"/api-reference/lookup/list-country-codes"},{"title":"List restricted countries","deprecated":null,"version":null,"openapi":"/openapi.json get /lookup/restricted-countries","href":"/api-reference/lookup/list-restricted-countries"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]}]},"title":"Search customer orders - Etherfuse API","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}