> ## Documentation Index
> Fetch the complete documentation index at: https://developers.unbridaled.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Merchant Addresses

> List all shipping addresses associated with a merchant.

## Returns

An object with a `merchant_addresses` array of address objects and a `total` count.



## OpenAPI

````yaml get /api/v2/merchant_addresses/list
openapi: 3.1.0
info:
  title: Unbridaled Marketplace Merchant API
  description: Developer API to integrate with Unbridaled Marketplace
  version: 1.0.0
servers:
  - url: https://api-staging.unbridaled.ai
    description: Sandbox API
  - description: Production API
    url: https://api.unbridaled.ai
security:
  - apikeyAuth: []
tags:
  - name: Diamonds
  - name: Inventory
  - name: Orders
  - name: Merchant Templates
  - name: Profit Margins
  - name: Defaults
  - name: Merchant Addresses
paths:
  /api/v2/merchant_addresses/list:
    get:
      tags:
        - Merchant Addresses
      summary: List Merchant Addresses
      description: >-
        List all shipping addresses associated with a merchant.


        ## Returns


        An object with a `merchant_addresses` array of address objects and a
        `total` count.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  merchant_addresses:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          format: uuid
                          description: Unique identifier for the merchant address.
                        name:
                          type: string
                          nullable: true
                          description: Display name for the address.
                        merchant_uuid:
                          type: string
                          format: uuid
                          description: UUID of the merchant this address belongs to.
                        phone:
                          type: string
                          nullable: true
                          description: Phone number associated with the address.
                        address_1:
                          type: string
                          nullable: true
                          description: Primary street address line.
                        address_2:
                          type: string
                          nullable: true
                          description: Secondary address line (suite, unit, etc.).
                        city:
                          type: string
                          nullable: true
                          description: City.
                        postal_code:
                          type: string
                          nullable: true
                          description: Postal or ZIP code.
                        country_code:
                          type: string
                          nullable: true
                          description: ISO 3166-1 alpha-2 country code (e.g. "US").
                        region:
                          type: string
                          nullable: true
                          description: State or province.
                        address_type:
                          type: string
                          enum:
                            - shipping
                            - billing
                          nullable: true
                          description: Type of address.
                        is_default:
                          type: boolean
                          default: false
                          description: Whether this is the merchant's default address.
                  total:
                    type: integer
                    description: Total number of addresses returned.
              example:
                merchant_addresses:
                  - uuid: a1b2c3d4-e5f6-7890-abcd-ef1234567890
                    name: HQ Shipping
                    merchant_uuid: f1e2d3c4-b5a6-7890-1234-abcdef567890
                    phone: '+12125550100'
                    address_1: 123 Main St
                    address_2: Suite 400
                    city: New York
                    postal_code: '10001'
                    country_code: US
                    region: NY
                    address_type: shipping
                    is_default: true
                total: 1
components:
  securitySchemes:
    apikeyAuth:
      type: http
      scheme: bearer

````