API

Get products of an artist

get

/stores/{userIdentifier}/items

Path parameters

userIdentifierone ofrequired

The public key or user id of the user

Example: {"value":"BjjSsEQPb8V8V2xv91CYN6Tv4vztETJn9uRiKbMwgKe4","summary":"by public key"}

Query parameters

fulfillmentstring · enum

foster fulfilled products are created and shipped by foster, user fulfilled products are shipped and managed by the user

Options: user, foster

editionboolean

return products linked with a master edition

edition_assignedboolean

return products that can be linked with a master edition but haven't been linked yet has no effect unless include_inactive=true

include_inactiveboolean

if true, return products that cannot be bought reasons may be: not active, expired, supply sold out, master edition not linked

per_pageone of

number of products to return in one page use all to return all products

pageinteger

page number, ignored if per_page=all

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.fostermarketplace.app/v1/stores/{userIdentifier}/items'

200

400

404

500

200

[
  {
    "id": 138,
    "user_id": 220,
    "name": "SuperteamDAO Hoodie",
    "description": "Premium Superteam hoodie, deep black, with a front pouch pocket and sleek flat drawstrings.\n-\tCrafted from 100% cotton for that unbeatable soft touch.\n-\tMedium weight for all-day comfort.\n-\tBold embroidery on the chest\n",
    "fulfillment_type": "user",
    "product_type_id": 24,
    "selling_price": 6900,
    "foster_amount": 345,
    "current_supply": 0,
    "supply": null,
    "master_edition_address": null,
    "listed_master_edition": {
      "id": 138,
      "mintAddress": "CFGEMjfnxH5mWKrHzVqZq8bz4BMF4UkudJuJfpwjm9TV",
      "price": 200000000,
      "startTime": "2024-08-06T18:48:10",
      "endTime": null,
      "buyLimit": 1,
      "authorityPublicKey": "4XVb4cLRFygiAiEm4kaMcfsmVJJ8gxUaosFpi4zsYb2E",
      "createdAt": "2024-08-06T18:48:23.486055"
    },
    "sale_start_at": "2024-08-06T18:09:36",
    "sale_end_at": null,
    "options": {
      "product_images": [
        "https://foster-marketplace-dev.s3.us-east-2.amazonaws.com/SuperteamDAOHoodie-1front1722967869233.png",
        "https://foster-marketplace-dev.s3.us-east-2.amazonaws.com/SuperteamDAOHoodie-1back1722967876429.png",
        "https://foster-marketplace-dev.s3.us-east-2.amazonaws.com/SuperteamDAOHoodie-1right1722967878464.png",
        "https://foster-marketplace-dev.s3.us-east-2.amazonaws.com/SuperteamDAOHoodie-1left1722967879655.png"
      ],
      "shipping_responsibility": "di_seller"
    },
    "created_at": "2024-08-06T18:11:23.717961",
    "updated_at": null,
    "deleted_at": null
  }
]

Successful response