What parameters does POST /V1/carts/mine/billing-address accept?

This endpoint accepts 3 parameters: cartId (int) required; address (Magento\Quote\Api\Data\AddressInterface) required; useForShipping (bool).

Does POST /V1/carts/mine/billing-address require authentication?

This endpoint requires a Bearer token. The `self` ACL means a customer token (when the caller owns the resource) or an admin token both work.

MageSmith

POSTQuote · Magento 2.4.9 Self (customer or admin)

POST /V1/carts/mine/billing-address

Q: What does the POST /V1/carts/mine/billing-address endpoint do in Magento 2?

POST /V1/carts/mine/billing-address is a Magento 2 REST endpoint in the Quote module. Assigns a specified billing address to a specified cart. Requires a customer or admin Bearer token (whichever owns the resource).

POST /V1/carts/mine/billing-address is a Magento 2 REST endpoint in the Quote module. Assigns a specified billing address to a specified cart. Requires a customer or admin Bearer token (whichever owns the resource).

Last verified: 2026-05-23 against Magento 2.4.9.

Returns

int

Address ID.

Service contract

Magento\Quote\Api\BillingAddressManagementInterface::assign

Authorization

Self — a customer Bearer token (when the caller owns the resource) or an admin token both work.

Body parameters

cartId int Required

The cart ID.

address Magento\Quote\Api\Data\AddressInterface Required

Billing address data.

useForShipping bool default: false

Example request

Auto-generated from the service contract — paste-ready against your store's /rest/default base. Replace the host, store code, ACL token, and any required values before running.

Headers

application/json

Content-Type

application/json

Authorization

Bearer <ACCESS_TOKEN> customer or admin token (whoever owns the resource)

Path

/V1/carts/mine/billing-address

Body

{
  "address": {
    "city": "",
    "company": "",
    "country_id": "",
    "custom_attributes": [
      {
        "attribute_code": "",
        "value": ""
      }
    ],
    "customer_address_id": 0,
    "customer_id": 0,
    "email": "",
    "extension_attributes": {},
    "fax": "",
    "firstname": "",
    "id": 0,
    "lastname": "",
    "middlename": "",
    "postcode": "",
    "prefix": "",
    "region": "",
    "region_code": "",
    "region_id": 0,
    "same_as_billing": 0,
    "save_in_address_book": 0,
    "street": [
      {}
    ],
    "suffix": "",
    "telephone": "",
    "vat_id": ""
  },
  "cartId": 0,
  "useForShipping": false
}