API

Get products of an artist

GEThttps://dev-api.fostermarketplace.app/v1/stores/{userIdentifier}/items

Path parameters

userIdentifier*one of

The public key or user id of the user

Example: "BjjSsEQPb8V8V2xv91CYN6Tv4vztETJn9uRiKbMwgKe4"

stringinteger

Query parameters

Response

200400404500

Successful response

Body

application/json

id*number

product id

Example: 138

user_id*number

user id of the artist

Example: 220

name*string

product name

Example: "SuperteamDAO Hoodie"

description*string

product description

Example: "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*FulfillmentType (enum)

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

userfoster

product_type_id*number

id of product class (eg shirt, hoodie, etc)

Example: 24

selling_price*number

selling price of product in US cents

Example: 6900

foster_amount*number

foster's cut in US cents

Example: 345

current_supply*number

number of items sold

Example: 0

supplynumber

max number of items available for sale, null means no limit

master_edition_addressstring

if the product is linked to prints of an edition, it's address will be here

listed_master_editionListedMasterEditionResponse (object)

sale_start_atstring (date-time)

Example: "2024-08-06T18:09:36"

sale_end_atstring (date-time)

options*any

additional options specific to the product

created_at*string (date-time)

Example: "2024-08-06T18:11:23.717961"

updated_atstring (date-time)

deleted_atstring (date-time)

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://dev-api.fostermarketplace.app/v1/stores/{userIdentifier}/items', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

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
  }
]