Scope: nft:orders · Rate limit: 30 a minute, shared with Estimate a one-token shipmentCarrier rates to ship every token’s item to the holder in one box. Charges nothing and stores nothing. The whole flow: Shipping.
string[]
required
1-25 distinct decimal token ids of your program, all held by holder. Send them as strings.
string
required
The wallet that holds every token now. Checked on chain.
object
required
name, address1, city and country (ISO 3166 alpha-2) are required; address2 is optional; state and zip where the country uses them; phone is required outside the US. name, address1, address2, city and state take up to 100 characters, zip and phone up to 20.
number | null
Shipping insurance cover in dollars, within the range the items allow (a 400 COVER_NOT_ALLOWED gives the range).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"CatchBack Documentation","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/catchbackcards/t6yI8GaEaBqQQEpE/logo/catchback_logo_dark.png?fit=max\u0026auto=format\u0026n=t6yI8GaEaBqQQEpE\u0026q=85\u0026s=c0a46c19893e31a50cd0f4716d47686b","dark":"https://mintcdn.com/catchbackcards/t6yI8GaEaBqQQEpE/logo/catchback_logo_white.png?fit=max\u0026auto=format\u0026n=t6yI8GaEaBqQQEpE\u0026q=85\u0026s=e3c457633020dab4b98738040c7ae111"},"favicon":"https://mintcdn.com/catchbackcards/t6yI8GaEaBqQQEpE/logo/catchback_logo_dark.png?fit=max\u0026auto=format\u0026n=t6yI8GaEaBqQQEpE\u0026q=85\u0026s=c0a46c19893e31a50cd0f4716d47686b","api":{"playground":{"display":"simple"},"mdx":{"auth":{"method":"bearer"},"server":"https://catchbackcards.com"}},"appearance":{"default":"dark"},"navbar":{"links":[{"href":"mailto:support@catchbackcards.com","label":"Support"}],"primary":{"type":"button","label":"Launch App","href":"https://catchbackcards.com"}},"footer":{"socials":{"x":"https://x.com/catchback_cards","instagram":"https://www.instagram.com/catchback_cards","discord":"https://discord.gg/6WjMbRgPMq"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"CatchBack Website","icon":"globe","href":"https://catchbackcards.com"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"catchbackcards","hasAudioNarration":false,"actualSubdomain":"catchbackcards","customDomains":[],"gitSource":{"type":"github","owner":"josephhhzhanggg","repo":"catchback-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6afd1c63365759e98bf2eec9","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"Partner API","count":47},{"language":"default","tag":"API Reference","count":35},{"language":"default","tag":"Documentation","count":21},{"language":"default","tag":"Shipments","count":14},{"language":"default","tag":"Concepts","count":11},{"language":"default","tag":"Keys \u0026 revenue","count":8},{"language":"default","tag":"Features","count":7},{"language":"default","tag":"Resources","count":7},{"language":"default","tag":"Packs \u0026 orders","count":6},{"language":"default","tag":"Tokens \u0026 sell-back","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"partner-api/v2/endpoints/estimate-shipment","slug":"/partner-api/v2/endpoints/estimate-shipment","pageMetadata":{"title":"Estimate a shipment","api":"POST /api/partner/v2/shipments/estimate","description":"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.","href":"/partner-api/v2/endpoints/estimate-shipment"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,ResponseField,Table}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Scope: `,_jsx(_components.code,{children:`nft:orders`}),` · Rate limit: 30 a minute, shared with `,_jsx(_components.a,{href:`/partner-api/v2/endpoints/estimate-token-shipment`,children:`Estimate a one-token shipment`})]}),`\n`,_jsxs(_components.p,{children:[`Carrier rates to ship every token’s item to the holder in one box. Charges nothing and stores nothing. The whole flow: `,_jsx(_components.a,{href:`/partner-api/v2/shipping`,children:`Shipping`}),`.`]}),`\n`,_jsx(ParamField,{body:`token_ids`,type:`string[]`,required:true,id:`param-token-ids`,children:_jsxs(_components.p,{children:[`1-25 distinct decimal token ids of your program, all held by `,_jsx(_components.code,{children:`holder`}),`. Send them as strings.`]})}),`\n`,_jsx(ParamField,{body:`holder`,type:`string`,required:true,id:`param-holder`,children:_jsx(_components.p,{children:`The wallet that holds every token now. Checked on chain.`})}),`\n`,_jsx(ParamField,{body:`address`,type:`object`,required:true,id:`param-address`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`address1`}),`, `,_jsx(_components.code,{children:`city`}),` and `,_jsx(_components.code,{children:`country`}),` (ISO 3166 alpha-2) are required; `,_jsx(_components.code,{children:`address2`}),` is optional; `,_jsx(_components.code,{children:`state`}),` and `,_jsx(_components.code,{children:`zip`}),` where the country uses them; `,_jsx(_components.code,{children:`phone`}),` is required outside the US. `,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`address1`}),`, `,_jsx(_components.code,{children:`address2`}),`, `,_jsx(_components.code,{children:`city`}),` and `,_jsx(_components.code,{children:`state`}),` take up to 100 characters, `,_jsx(_components.code,{children:`zip`}),` and `,_jsx(_components.code,{children:`phone`}),` up to 20.`]})}),`\n`,_jsx(ParamField,{body:`cover_amount`,type:`number | null`,id:`param-cover-amount`,children:_jsxs(_components.p,{children:[`Shipping insurance cover in dollars, within the range the items allow (a `,_jsx(_components.code,{children:`400 COVER_NOT_ALLOWED`}),` gives the range).`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`rates`,type:`object[]`,id:`param-rates`,children:_jsxs(Expandable,{title:`rate`,children:[_jsx(ResponseField,{name:`carrier`,type:`string`,id:`param-carrier`}),_jsx(ResponseField,{name:`service`,type:`string`,id:`param-service`}),_jsxs(ResponseField,{name:`token`,type:`string`,id:`param-token`,children:[`Pass `,_jsx(_components.code,{children:`carrier`}),` and `,_jsx(_components.code,{children:`token`}),` as `,_jsx(_components.code,{children:`rate`}),` to `,_jsx(_components.a,{href:`/partner-api/v2/endpoints/create-shipment`,children:`Create a shipment`}),`.`]}),_jsx(ResponseField,{name:`amount`,type:`number`,id:`param-amount`,children:`The carrier rate.`}),_jsx(ResponseField,{name:`estimated_days`,type:`integer | null`,id:`param-estimated-days`}),_jsxs(ResponseField,{name:`total`,type:`number`,id:`param-total`,children:[`What the holder pays: the rate plus any cover premium. Pass it as `,_jsx(_components.code,{children:`max_cost`}),`.`]})]})}),`\n`,_jsx(Heading,{level:`2`,id:`errors`,children:`Errors`}),`\n`,_jsxs(_components.p,{children:[`A refusal about particular tokens lists them in `,_jsx(_components.code,{children:`token_ids`}),`.`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Status`}),_jsx(_components.th,{children:`Code`}),_jsx(_components.th,{children:`When`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_JSON`})}),_jsx(_components.td,{children:`The body isn’t JSON`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_TOKEN_IDS`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`token_ids`}),` isn’t a list of 1-25 distinct decimal token ids`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_HOLDER`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`holder`}),` is not a wallet address on your mint chain`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_ADDRESS`})}),_jsxs(_components.td,{children:[`The shipping address is invalid; `,_jsx(_components.code,{children:`fields`}),` maps each bad field to a message`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`BAD_COVER`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`cover_amount`}),` isn’t a positive dollar amount with at most two decimals`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`COVER_NOT_ALLOWED`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`cover_amount`}),` is outside what the items can be insured for; the body has `,_jsx(_components.code,{children:`order_value`}),`, `,_jsx(_components.code,{children:`min_cover`}),` and `,_jsx(_components.code,{children:`max_cover`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_SHIPPABLE`})}),_jsx(_components.td,{children:`An item can’t ship`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`PARTNER_GOODS`})}),_jsx(_components.td,{children:`An item is held by its brand partner and can’t ship through CatchBack; it can still be sold back`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`COUNTRY_NOT_SUPPORTED`})}),_jsx(_components.td,{children:`We don’t ship to that country`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`400`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`OVER_CUSTOMS_CAP`})}),_jsx(_components.td,{children:`The items are worth more than we can ship internationally`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`403`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`NOT_HOLDER`})}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`holder`}),` doesn’t hold these tokens on chain right now`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`404`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`UNKNOWN_TOKEN`})}),_jsx(_components.td,{children:`No such token on your program’s contract`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`409`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`TOKEN_NOT_LIVE`})}),_jsx(_components.td,{children:`A token isn’t minted yet, or was already burned`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,children:_jsx(_components.code,{children:`503`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`CHAIN_UNAVAILABLE`})}),_jsx(_components.td,{children:`We couldn’t read the tokens’ owner from the chain; retry shortly`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Estimate a shipment","api":"POST /api/partner/v2/shipments/estimate","description":"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.","href":"/partner-api/v2/endpoints/estimate-shipment"}}},"mdxSourceWithNoJs":null,"noJsSplices":[[205,223,"pre:`pre`,span:`span`,tbody:`tbody`,td:`"],[303,369,"CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,ResponseField,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if("],[531,543,"questExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)"],[8967,9395,",`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://catchbackcards.com/api/partner/v2/shipments/estimate`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$CATCHBACK_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"token_ids\": [\"81264573985362058461377125337283195667\", \"90311820476190023716442901288201455\"],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"holder\": \"0x8f3c...e21a\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"address\": { \"name\": \"Alice Tester\", \"address1\": \"1 Market St\", \"address2\": null, \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"US\", \"phone\": \"4155550100\" },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"cover_amount\": null`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200`,numberOfLines:`5`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"rates\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"carrier\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"USPS\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"service\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Priority Mail\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"token\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"usps_priority\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"amount\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`9.85`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"estimated_days\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`3`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:`\"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`9.85`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}"]]},"mdxExtracts":{"tableOfContents":[{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Errors","slug":"errors","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> https://catchbackcards.com/api/partner/v2/shipments/estimate\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Authorization: Bearer \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#9CDCFE\">$CATCHBACK_KEY\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"token_ids\": [\"81264573985362058461377125337283195667\", \"90311820476190023716442901288201455\"],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"holder\": \"0x8f3c...e21a\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"address\": { \"name\": \"Alice Tester\", \"address1\": \"1 Market St\", \"address2\": null, \"city\": \"San Francisco\", \"state\": \"CA\", \"zip\": \"94105\", \"country\": \"US\", \"phone\": \"4155550100\" },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"cover_amount\": null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"5\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"rates\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> { \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"carrier\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"USPS\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"service\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Priority Mail\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"token\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"usps_priority\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"amount\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">9.85\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"estimated_days\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">3\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">, \u003c/span>\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\">\"total\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">9.85\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Estimate a shipment","path":"/api/partner/v2/shipments/estimate","servers":[{"url":"https://catchbackcards.com"}],"method":"post","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"token_ids":[{"type":"array","items":[{"type":"string"}],"description":"1-25 distinct decimal token ids of your program, all held by `holder` . Send them as strings.","required":true}],"holder":[{"type":"string","description":"The wallet that holds every token now. Checked on chain.","required":true}],"address":[{"type":"object","properties":{},"description":"`name` , `address1` , `city` and `country` (ISO 3166 alpha-2) are required; `address2` is optional; `state` and `zip` where the country uses them; `phone` is required outside the US. `name` , `address1` , `address2` , `city` and `state` take up to 100 characters, `zip` and `phone` up to 20.","required":true}],"cover_amount":[{"type":"object","properties":{},"description":"Shipping insurance cover in dollars, within the range the items allow (a `400 COVER_NOT_ALLOWED` gives the range)."}]}}],"examples":{"example":{"value":{"token_ids":["\u003cstring>"],"holder":"\u003cstring>","address":{},"cover_amount":{}}}}}}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"rates":[{"type":"array","items":[{"type":"object","properties":{"carrier":[{"type":"string"}],"service":[{"type":"string"}],"token":[{"type":"string","description":"Pass `carrier` and `token` as `rate` to Create a shipment ."}],"amount":[{"type":"number","description":"The carrier rate."}],"estimated_days":[{"type":"object","properties":{}}],"total":[{"type":"number","description":"What the holder pays: the rate plus any cover premium. Pass it as `max_cost` ."}]}}]}]}}],"examples":{"example":{"value":{"rates":[{"carrier":"\u003cstring>","service":"\u003cstring>","token":"\u003cstring>","amount":123,"estimated_days":{},"total":123}]}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"catchbackcards","siteName":"CatchBack Documentation","title":"Estimate a shipment - CatchBack Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-18T00:04:41.668Z","originalFileLocation":"partner-api/v2/endpoints/estimate-shipment.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=\"dark\"}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=\"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.\">\u003cmeta data-mint-head name=\"application-name\" content=\"CatchBack Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_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/catchbackcards/mlIgZutg782HIdAn/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Estimate a shipment - CatchBack Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"CatchBack Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://catchbackcards.mintlify.site/_mintlify/api/og/v2?division=Shipments\u0026amp;title=Estimate+a+shipment\u0026amp;description=Carrier+rates+to+ship+1-25+tokens+held+by+one+wallet+in+one+box.+Charges+nothing+and+stores+nothing.\u0026amp;theme=779a40f3f67beacb233f5a4b\u0026amp;signature=4ac521fbc53fb50dc4af921a8670e27412dc9dc6ee40757ae6a37b646c82242d\">\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=\"Estimate a shipment - CatchBack Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://catchbackcards.mintlify.site/_mintlify/api/og/v2?division=Shipments\u0026amp;title=Estimate+a+shipment\u0026amp;description=Carrier+rates+to+ship+1-25+tokens+held+by+one+wallet+in+one+box.+Charges+nothing+and+stores+nothing.\u0026amp;theme=779a40f3f67beacb233f5a4b\u0026amp;signature=4ac521fbc53fb50dc4af921a8670e27412dc9dc6ee40757ae6a37b646c82242d\">\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/catchbackcards/mlIgZutg782HIdAn/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"CatchBack Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/partner-api/v2/endpoints/estimate-shipment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://catchbackcards.mintlify.app/#organization\",\"name\":\"CatchBack Documentation\",\"url\":\"https://catchbackcards.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/catchbackcards/t6yI8GaEaBqQQEpE/logo/catchback_logo_dark.png?fit=max\u0026auto=format\u0026n=t6yI8GaEaBqQQEpE\u0026q=85\u0026s=c0a46c19893e31a50cd0f4716d47686b\"}},{\"@type\":\"WebSite\",\"@id\":\"https://catchbackcards.mintlify.app#website\",\"name\":\"CatchBack Documentation\",\"url\":\"https://catchbackcards.mintlify.app\",\"publisher\":{\"@id\":\"https://catchbackcards.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment#webpage\",\"url\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment\",\"name\":\"Estimate a shipment\",\"description\":\"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.\",\"dateModified\":\"2026-11-18T00:04:41.668Z\",\"isPartOf\":{\"@id\":\"https://catchbackcards.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"CatchBack Documentation\",\"item\":\"https://catchbackcards.mintlify.app\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Estimate a shipment\",\"item\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment#apireference\",\"headline\":\"Estimate a shipment\",\"name\":\"Estimate a shipment\",\"description\":\"Carrier rates to ship 1-25 tokens held by one wallet in one box. Charges nothing and stores nothing.\",\"url\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment\",\"mainEntityOfPage\":{\"@id\":\"https://catchbackcards.mintlify.app/partner-api/v2/endpoints/estimate-shipment#webpage\"},\"dateModified\":\"2026-11-18T00:04:41.668Z\",\"publisher\":{\"@id\":\"https://catchbackcards.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://catchbackcards.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"CatchBack Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"CatchBack Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/partner-api/v2/endpoints/estimate-shipment.md","siteName":"CatchBack Documentation","nav":{"global":{"anchors":[{"anchor":"CatchBack Website","icon":"globe","href":"https://catchbackcards.com"}]},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/about-catchback/overview"}]},{"tab":"Partner API","groups":[{"group":"Get started","pages":[{"title":"Partner API v2","sidebarTitle":"Overview","href":"/partner-api/v2/overview"},{"title":"MCP server","href":"/partner-api/v2/mcp"},{"title":"Sandbox","href":"/partner-api/v2/quickstart"},{"title":"Authentication and keys","href":"/partner-api/v2/authentication"}]},{"group":"Concepts","pages":[{"title":"Orders and statuses","href":"/partner-api/v2/orders"},{"title":"Verify a pull","href":"/partner-api/v2/verify-a-pull"},{"title":"Odds","href":"/partner-api/v2/odds"},{"title":"Payments","href":"/partner-api/v2/payments"},{"title":"Sell-back","href":"/partner-api/v2/sell-back"},{"title":"Shipping","href":"/partner-api/v2/shipping"},{"title":"Webhooks","href":"/partner-api/v2/webhooks"},{"title":"Chains, tokens and metadata","href":"/partner-api/v2/chains-and-metadata"},{"title":"Idempotency","href":"/partner-api/v2/idempotency"},{"title":"Errors","href":"/partner-api/v2/errors"},{"title":"Limits and compliance","href":"/partner-api/v2/limits-and-compliance"}]},{"group":"Packs \u0026 orders","pages":[{"title":"List packs","api":"GET /api/partner/v2/catalog/packs","href":"/partner-api/v2/endpoints/list-packs"},{"title":"Get a pack's odds and pool","api":"GET /api/partner/v2/catalog/packs/pool","href":"/partner-api/v2/endpoints/get-pack-pool"},{"title":"Create an order","api":"POST /api/partner/v2/orders","href":"/partner-api/v2/endpoints/create-order"},{"title":"List orders","api":"GET /api/partner/v2/orders","href":"/partner-api/v2/endpoints/list-orders"},{"title":"Get an order","api":"GET /api/partner/v2/orders/{id}","href":"/partner-api/v2/endpoints/get-order"},{"title":"Verify an order's pull","api":"GET /api/partner/v2/orders/{id}/verification","href":"/partner-api/v2/endpoints/get-order-verification"}]},{"group":"Tokens \u0026 sell-back","pages":[{"title":"List a wallet's tokens","api":"GET /api/partner/v2/wallets/{address}/tokens","href":"/partner-api/v2/endpoints/list-wallet-tokens"},{"title":"Get a token","api":"GET /api/partner/v2/tokens/{tokenId}","href":"/partner-api/v2/endpoints/get-token"},{"title":"Quote a sell-back","api":"POST /api/partner/v2/tokens/{tokenId}/quote","href":"/partner-api/v2/endpoints/create-sellback-quote"},{"title":"List sell-back quotes","sidebarTitle":"List quotes","api":"GET /api/partner/v2/quotes","href":"/partner-api/v2/endpoints/list-quotes"},{"title":"Get a quote","api":"GET /api/partner/v2/quotes/{quoteId}","href":"/partner-api/v2/endpoints/get-quote"},{"title":"Token metadata","api":"GET /api/partner-nfts/metadata/{chainId}/{tokenId}","description":"A token's standard NFT metadata, which wallets and marketplaces read with no key. No prices.","href":"/partner-api/v2/endpoints/get-token-metadata"}]},{"group":"Shipments","pages":[{"title":"Estimate a shipment","api":"POST /api/partner/v2/shipments/estimate","href":"/partner-api/v2/endpoints/estimate-shipment"},{"title":"Create a shipment","api":"POST /api/partner/v2/shipments","description":"Create and pay for one box carrying 1-25 tokens held by one wallet.","href":"/partner-api/v2/endpoints/create-shipment"},{"title":"Estimate a one-token shipment","api":"POST /api/partner/v2/tokens/{tokenId}/shipment/estimate","href":"/partner-api/v2/endpoints/estimate-token-shipment"},{"title":"Create a one-token shipment","api":"POST /api/partner/v2/tokens/{tokenId}/shipment","href":"/partner-api/v2/endpoints/create-token-shipment"},{"title":"List shipments","api":"GET /api/partner/v2/shipments","href":"/partner-api/v2/endpoints/list-shipments"},{"title":"Get a shipment","api":"GET /api/partner/v2/shipments/{id}","href":"/partner-api/v2/endpoints/get-shipment"},{"title":"Renew a shipment","api":"POST /api/partner/v2/shipments/{id}/renew","href":"/partner-api/v2/endpoints/renew-shipment"}]},{"group":"Webhook endpoints","pages":[{"title":"Register a webhook","api":"POST /api/partner/v2/webhooks","href":"/partner-api/v2/endpoints/register-webhook"},{"title":"Get your webhook","api":"GET /api/partner/v2/webhooks","href":"/partner-api/v2/endpoints/list-webhooks"},{"title":"Delete a webhook","api":"DELETE /api/partner/v2/webhooks/{id}","href":"/partner-api/v2/endpoints/delete-webhook"},{"title":"Test a webhook","api":"POST /api/partner/v2/webhooks/{id}/test","href":"/partner-api/v2/endpoints/test-webhook"}]},{"group":"Keys \u0026 revenue","pages":[{"title":"Get your key","api":"GET /api/partner/v2/keys","href":"/partner-api/v2/endpoints/get-key"},{"title":"Rotate your key","api":"POST /api/partner/v2/keys/rotate","href":"/partner-api/v2/endpoints/rotate-key"},{"title":"Revoke the previous key","api":"POST /api/partner/v2/keys/revoke-previous","href":"/partner-api/v2/endpoints/revoke-previous-key"},{"title":"Get your revenue statement","api":"GET /api/partner/v2/revenue","href":"/partner-api/v2/endpoints/get-revenue"}]},{"group":"Sandbox","pages":[{"title":"Simulate a payment","api":"POST /api/partner/v2/sandbox/payments/{intentId}","href":"/partner-api/v2/endpoints/sandbox-pay"},{"title":"Run the background work","api":"POST /api/partner/v2/sandbox/tick","href":"/partner-api/v2/endpoints/sandbox-tick"},{"title":"Mark a shipment shipped or delivered","sidebarTitle":"Simulate shipping","api":"POST /api/partner/v2/sandbox/shipments/{id}","href":"/partner-api/v2/endpoints/sandbox-ship"}]},{"group":"Going live","pages":[{"title":"Go-live checklist","href":"/partner-api/v2/go-live-checklist"},{"title":"Changelog","href":"/partner-api/v2/changelog"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/packs/list-packs"}]}]},"basePath":"","title":"Estimate a shipment - CatchBack Documentation","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js"]}