Address Management

Saved addresses are the destinations Tradepost ships to. An outtake references one by id rather than carrying an address, so you set them up once and reuse them.

Every address belongs to your account. Ids from another account are never visible and never resolve.

Queries

getSavedAddresses

query {
  getSavedAddresses(input: { pagination: { limit: 20 } }) {
    savedAddresses {
      id
      nickname
      name
      street1
      street2
      city
      state
      zip
      country
      isDefault
      isValidated
    }
    pagination { totalCount hasNextPage }
    error { message code }
  }
}

getSavedAddress

Look up a single address by id or by nickname — provide one.

query {
  getSavedAddress(input: { nickname: "main-warehouse" }) {
    savedAddress { id nickname city state }
    error { message code }
  }
}

Mutations

createSavedAddress

mutation {
  createSavedAddress(input: {
    nickname: "main-warehouse"
    isDefault: true
    address: {
      name: "Acme Receiving"
      street1: "123 Main St"
      city: "Austin"
      state: "TX"
      zip: "78701"
      country: "US"
      phone: "5125550100"
    }
  }) {
    savedAddress { id nickname isDefault }
    error { message code }
  }
}

nickname is your own label and is how you look the address up later without storing the id.

setDefaultSavedAddress

mutation {
  setDefaultSavedAddress(input: { id: "9f8e…" }) {
    savedAddress { id isDefault }
    error { message code }
  }
}

Per-asset-type recipients

You can nominate a default destination per asset type, so cards and sealed product route to different addresses without specifying one on every request.

mutation {
  setRecipientAddress(input: {
    savedAddressId: "9f8e…"
    assetType: "SEALED_TCG"
  }) {
    error { message code }
  }
}

Pass savedAddressId: null to clear the assignment. getRecipientAddresses returns the current mapping, optionally filtered by asset type.