{"templateId":"markdown","versions":[{"version":"shipstation-v2","label":"ShipStation V2 API","link":"/apis/shipstation-v2/docs/carriers/add-funds","default":true,"active":false,"folderId":"58c9a61d"},{"version":"shipengine","label":"ShipStation API (formerly ShipEngine)","link":"/apis/shipengine/docs/carriers/add-funds","default":false,"active":true,"folderId":"58c9a61d"},{"version":"shipstation-v1","label":"ShipStation V1 API","link":"/apis/shipstation-v1/docs/carriers/add-funds","default":false,"active":false,"folderId":"58c9a61d"}],"sharedDataIds":{"sidebar":"sidebar-apis/@shipengine/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Fund Your Account Balance","keywords":"shipping, labels, shipstation, documentation, api","siteUrl":"https://docs.shipstation.com","lang":"en-US","llmstxt":{"hide":false,"title":"ShipStation API LLM Docs","description":"Find links and references to all markdown documentation for use with LLMs","excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"fund-your-account-balance","__idx":0},"children":["Fund Your Account Balance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you’ve ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/carriers/setup"},"children":["activated ShipStation Carriers"]},", you’ll need to add funds to your account balance to start purchasing labels."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article explains how to add funds to your ShipStation API account balance programmatically using the PUT method with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add_funds"]}," endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn how to add funds to your account balance via the ShipStation API dashboard, see the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add Funds"]}," section of our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/articles/19992783066267"},"children":["ShipStation Carriers help article"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requirements","__idx":1},"children":["Requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," property for one of your ShipStation carriers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amount"]}," properties. Currently, all ShipStation API transactions are in US Dollars (USD) or British Pounds (GBP) only."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["add_funds"]}," endpoint must first be enabled by the ShipStation API Support team. If you'd like to add funds via this endpoint, ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/requests/new"},"children":["submit a request with our support team"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-funds","__idx":2},"children":["Add Funds"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["IMPORTANT:"]}," ","This request is a live transaction that charges your payment method!"," ","There is no test mode for adding funds. You will be charged when making this request."," ","Credit card processing fees may apply."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request--response","__idx":3},"children":["Example Request & Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PUT /v1/carriers/:carrier_id/add_funds"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"PUT /v1/carriers/se-123890/add_funds HTTP/1.1\nHost: api.shipengine.com\nAPI-Key: __YOUR_API_KEY_HERE__\nContent-Type: application/json\n\n{\n  \"currency\": \"usd\",\n  \"amount\": 10.0\n}\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example Response"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"balance\": {\n    \"currency\": \"usd\",\n    \"amount\": 50.00\n  }\n}\n\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"check-your-balance","__idx":4},"children":["Check Your Balance"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can check your balance for a particular carrier using the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/shipengine/docs/reference/list-carriers"},"children":["List Carriers"]}," endpoint. For any carrier account where ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requires_funded_amount"]}," is set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},", you can add funds."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fund-balances-for-stampscom-or-endicia-standalone-accounts","__idx":5},"children":["Fund Balances for Stamps.com or Endicia Standalone Accounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you have connected a standalone ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/articles/4406871553819"},"children":["Stamps.com"]}," or ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.shipengine.com/hc/en-us/articles/7679625277595"},"children":["Endicia"]}," account, you can use the same endpoint to fund those account balances as well. Simply use the corresponding ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["carrier_id"]}," to indicate which balance you want to fund."]}]},"headings":[{"value":"Fund Your Account Balance","id":"fund-your-account-balance","depth":1},{"value":"Requirements","id":"requirements","depth":2},{"value":"Add Funds","id":"add-funds","depth":2},{"value":"Example Request & Response","id":"example-request--response","depth":3},{"value":"Check Your Balance","id":"check-your-balance","depth":2},{"value":"Fund Balances for Stamps.com or Endicia Standalone Accounts","id":"fund-balances-for-stampscom-or-endicia-standalone-accounts","depth":2}],"frontmatter":{"seo":{"title":"Fund Your Account Balance"}},"lastModified":"2026-04-08T10:47:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/apis/shipengine/docs/carriers/add-funds","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}