Address

The authenticated user’s shipping address (for product samples). At most one per user.

Operations

Operation	Method + path	Token scope	Role	Notes
Show address	GET /me/address.json	read or write	Authenticated user	Returns 404 if no address exists yet
Create or update address	PATCH /me/address.json	write	Authenticated user	Same endpoint upserts
Delete address	DELETE /me/address.json	write	Authenticated user	Returns 204 No Content

Resource shape

{
  "id": "wDcVbN",
  "address_one": "1 Infinite Loop",
  "address_two": null,
  "city": "Cupertino",
  "state": "CA",
  "postal_code": "95014",
  "country_code": "US",
  "created_at": "2026-04-01T10:00:00Z",
  "updated_at": "2026-04-01T10:00:00Z"
}

Show

GET /me/address.json

Returns the user’s address, or 404 Not Found if the user hasn’t set one.

Create / Update

PATCH /me/address.json

{
  "address": {
    "address_one": "1 Infinite Loop",
    "city": "Cupertino",
    "state": "CA",
    "postal_code": "95014",
    "country_code": "US"
  }
}

Same endpoint creates the address if missing, updates it otherwise. Requires a write-scoped token. Returns 200 OK with the address.

Delete

DELETE /me/address.json

Removes the address. Returns 204 No Content. The user can later re-create it.

Errors

Code	When
401	Missing token, or read token attempting a write
404	No address has been set yet (on GET)
422	Validation failed