Address

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

Resource shape

{
  "id": 9,
  "address_one": "1 Infinite Loop",
  "address_two": null,
  "city": "Cupertino",
  "state": "CA",
  "postal_code": "95014",
  "country_code": "US",
  "latitude": "37.331820",
  "longitude": "-122.030189",
  "google_place_id": "ChIJ...",
  "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.

latitude, longitude, and google_place_id are optional but recommended for verified addresses.

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