You are here:
    Home > API Documentation

API Documentation


The API can be used to access your account programmatically. You will be able to do things such as downloading and processing orders or synchronising your inventory with your own website.

To access the API you first need to create an account. Once you have an account, you can generate an API key from the page in your account. Once you have the API key you can make a request to any of the methods listed below that your key has permission for. The API is rated limited to 600 requests per minute for most requests, or 200 requests per minute for bulk/batch.

For GET request the key and any parameters should be added as parameters onto the request, for example https://api.stamp-store.com/v1/order/view?key=KEY&order_id=100.
For POST requests, the key and any parameters should be in the body of the request and have a content type of application/x-www-form-urlencoded


Affiliate Stores

This API is for use by our affiliate partners, stores that have opted in can have their details retrieved through this API

Stores

GET https://api.stamp-store.com/v1/affiliate/stores

Get a list of all the stores that have opted in to your affiliate scheme

Lots

GET https://api.stamp-store.com/v1/affiliate/lots

Retrieve the stores lots

Arguments
  • store_id - The stores unique ID
  • type (Optional) - Filter by item type
    • Stamp
    • Set
    • Series
    • Block
    • Sheet
    • Booklet
    • Equipment

Lots by ID

GET https://api.stamp-store.com/v1/affiliate/item_lots

Retrieve lots for an item identified by an id

Arguments
  • type - Filter by item type
    • Stamp
    • Set
    • Series
    • Block
    • Sheet
    • Booklet
    • Equipment
  • id - ID
  • id_type - Specify the ID Type

Bulk

Batch multiple requests together into one bulk request to save on request overhead

Batch

POST https://api.stamp-store.com/v1/bulk/batch

Batch up to 50 requests in one go

Arguments
  • requests - JSON Array of endpoints with arguments in the format {"requests": [{"endpoint":"catalog/search","request_method":"GET","params":[{"query":"Vendor"}]}, {"endpoint":"catalog/search","request_method":"GET","params":[{"query":"Laser"}]}]}. Or for POST {"requests": [{"endpoint":"inventory/update","request_method":"POST","params":[{"lot_id":"IDHERE","absolute_quantity":2}]}]}

Catalog

The catalog API allows you to retrieve information about items in the catalog. To access this API contact us

List

GET https://api.stamp-store.com/v1/catalog/list

Get a list of all the items in the catalog

Arguments
  • type (Optional) - Filter by item type
    • Stamp
    • Set
    • Series
    • Block
    • Sheet
    • Booklet
    • Equipment
  • brand (Optional) - Filter by brand

Lookup

GET https://api.stamp-store.com/v1/catalog/lookup

Retrieve details about an item in the catalog by SID

Arguments
  • sid - A SID

Availability

GET https://api.stamp-store.com/v1/catalog/availability

Retrieve pricing and availability information for an item in the catalog by SID

Arguments
  • sid - A SID
  • quantity (Optional) - The minimum quantity required, greater than 0
  • country - 2 digit country code for shipping destination

ID Lookup

GET https://api.stamp-store.com/v1/catalog/id_lookup

Retrieve the possible SIDs for another ID such as a set number or design ID

Arguments
  • id - ID
  • type - Filter by item type
    • Stamp
    • Set
    • Series
    • Block
    • Sheet
    • Booklet
    • Equipment
  • id_type (Optional) - Filter by ID type. For example, use item_no, design_id, bl_item_no or set_number

Bulk

GET https://api.stamp-store.com/v1/catalog/bulk

Retrieve bulk catalog dumps. This API should only be used when instructed to do so

Arguments
  • type - Bulk type

Lookup (Bulk)

GET https://api.stamp-store.com/v1/catalog/bulk_lookup

Retrieve details about multiple items in the catalog at once

Arguments
  • sids - A comma separated list of SIDs. Maximum amount: 100

Inventory

GET https://api.stamp-store.com/v1/catalog/inventory

Retrieve an items inventory

Arguments
  • sid - SID

Condition List

GET https://api.stamp-store.com/v1/catalog/condition_list

Retrieve a list of the conditions a lot can have

Field Options List

GET https://api.stamp-store.com/v1/catalog/field_option_list

Retrieve a list of the options a catalog field can have

Arguments
  • type - Field type
    • category_0 - Category 0
    • category_1 - Category 1
    • category_2 - Category 2
    • colors - Colors
    • edition_type_id - Edition Type Id
    • face_value_currency_id - Face Value Currency Id
    • gum_id - Gum Id
    • issue_day - Issue Day
    • issue_month - Issue Month
    • paper_type_id - Paper Type Id
    • perforation_id - Perforation Id
    • postal_authority_id - Postal Authority Id
    • printing_type_id - Printing Type Id
    • remove_image - Remove Image
    • separation_id - Separation Id
    • sides_printed - Sides Printed
    • stamp_type_id - Stamp Type Id
    • theme_0 - Theme 0
    • theme_1 - Theme 1
    • theme_2 - Theme 2
    • theme_3 - Theme 3
    • theme_4 - Theme 4
    • theme_5 - Theme 5
    • theme_6 - Theme 6
    • theme_7 - Theme 7
    • theme_8 - Theme 8
    • type - Type
  • language (Optional) - Language of the response
    • en - English
    • de - German
    • nl - Dutch
    • fr - French

Catalog Edit

Submit changes to the catalog

Edit (Basic)

POST https://api.stamp-store.com/v1/catalog_edit/basic_edit

Submit a change request for an item. Some fields are item or user specific, all fields will return appropriate error information

Arguments
  • sid - SID
  • type - Submission type
    • base_name - Base Name (string)
    • category_0 - Category 0 (option)
    • category_1 - Category 1 (option)
    • category_2 - Category 2 (option)
    • colors - Colors (option - Multiple CSV)
    • delete - Delete (binary)
    • delete_scheduled - Delete Scheduled (binary)
    • description - Description (string)
    • designer - Designer (string)
    • edition_issued - Edition Issued (number)
    • edition_sold - Edition Sold (number)
    • edition_type_id - Edition Type Id (option)
    • engraver - Engraver (string)
    • face_value - Face Value (number)
    • face_value_addition - Face Value Addition (string)
    • face_value_currency_id - Face Value Currency Id (option)
    • face_value_description - Face Value Description (string)
    • first_available - First Available (number)
    • gum_id - Gum Id (option)
    • height - Height (number)
    • our_afa - ID - AFA number (string)
    • our_ank - ID - ANK (string)
    • our_afi - ID - Afinsa (string)
    • our_austrian_net - ID - Austrian Net ID (string)
    • our_blr - ID - Belarus post Inc. (string)
    • our_bel - ID - Belgium (string)
    • our_bol - ID - Bolaffi (string)
    • our_chronological_chapter - ID - Chronological Chapter (string)
    • our_chronological - ID - Chronological Issue Number (string)
    • our_colnect - ID - Colnect (string)
    • our_col - ID - Colnect codes (string)
    • our_cro - ID - Croatian post Inc. (string)
    • our_dai - ID - Dai Nippon (string)
    • our_edi - ID - Edifil (string)
    • our_fac - ID - Facit (string)
    • our_gz - ID - Gz (Cefiloza) (string)
    • our_got - ID - Götig and Jalil (string)
    • our_isr - ID - Israel Philatelic Federation (string)
    • our_lt - ID - Leo Temprano (string)
    • our_li_store - ID - Liechtenstein Store (string)
    • our_mi - ID - Michel ID (string)
    • our_nvp - ID - NVPH (string)
    • our_pm - ID - PMRstamps.org (string)
    • our_pof - ID - POFIS (string)
    • our_pol - ID - Polish Stamps Catalog (Fischer) (string)
    • our_rhm - ID - RHM (string)
    • our_rom - ID - Romfilatelia (string)
    • our_sak - ID - Sakura (string)
    • our_sas - ID - Sassone (string)
    • our_con - ID - Scott (string)
    • our_seriesnumber - ID - Series Number (string)
    • our_setnumber - ID - Set Number (string)
    • our_sev - ID - Seven Seas Stamps (string)
    • our_sid - ID - Siddiqui Catalogue (string)
    • our_sg - ID - Stanley Gibbons (string)
    • our_un - ID - Unificato (string)
    • our_wad - ID - WADP Numbering System - WNS (string)
    • our_yt - ID - Yvert et Tellier (string)
    • our_zon - ID - Zonnebloem (string)
    • our_zum - ID - Zumstein (string)
    • is_issued - Is Issued (binary)
    • issue_day - Issue Day (option)
    • issue_month - Issue Month (option)
    • length - Length (number)
    • paper_type_id - Paper Type Id (option)
    • perforation_id - Perforation Id (option)
    • postal_authority_id - Postal Authority Id (option)
    • postal_authority_number - Postal Authority Number (string)
    • printing_company - Printing Company (string)
    • printing_type_id - Printing Type Id (option)
    • reference_price_mm - Reference Price Mm (number)
    • reference_price_o - Reference Price O (number)
    • reference_price_source - Reference Price Source (string)
    • reference_price_time - Reference Price Time (number)
    • reference_price_um - Reference Price Um (number)
    • remove_id_our_afa - Remove ID - AFA number (string)
    • remove_id_our_ank - Remove ID - ANK (string)
    • remove_id_our_afi - Remove ID - Afinsa (string)
    • remove_id_our_austrian_net - Remove ID - Austrian Net ID (string)
    • remove_id_our_blr - Remove ID - Belarus post Inc. (string)
    • remove_id_our_bel - Remove ID - Belgium (string)
    • remove_id_our_bol - Remove ID - Bolaffi (string)
    • remove_id_our_chronological_chapter - Remove ID - Chronological Chapter (string)
    • remove_id_our_chronological - Remove ID - Chronological Issue Number (string)
    • remove_id_our_colnect - Remove ID - Colnect (string)
    • remove_id_our_col - Remove ID - Colnect codes (string)
    • remove_id_our_cro - Remove ID - Croatian post Inc. (string)
    • remove_id_our_dai - Remove ID - Dai Nippon (string)
    • remove_id_our_edi - Remove ID - Edifil (string)
    • remove_id_our_fac - Remove ID - Facit (string)
    • remove_id_our_gz - Remove ID - Gz (Cefiloza) (string)
    • remove_id_our_got - Remove ID - Götig and Jalil (string)
    • remove_id_our_isr - Remove ID - Israel Philatelic Federation (string)
    • remove_id_our_lt - Remove ID - Leo Temprano (string)
    • remove_id_our_li_store - Remove ID - Liechtenstein Store (string)
    • remove_id_our_mi - Remove ID - Michel ID (string)
    • remove_id_our_nvp - Remove ID - NVPH (string)
    • remove_id_our_pm - Remove ID - PMRstamps.org (string)
    • remove_id_our_pof - Remove ID - POFIS (string)
    • remove_id_our_pol - Remove ID - Polish Stamps Catalog (Fischer) (string)
    • remove_id_our_rhm - Remove ID - RHM (string)
    • remove_id_our_rom - Remove ID - Romfilatelia (string)
    • remove_id_our_sak - Remove ID - Sakura (string)
    • remove_id_our_sas - Remove ID - Sassone (string)
    • remove_id_our_con - Remove ID - Scott (string)
    • remove_id_our_seriesnumber - Remove ID - Series Number (string)
    • remove_id_our_setnumber - Remove ID - Set Number (string)
    • remove_id_our_sev - Remove ID - Seven Seas Stamps (string)
    • remove_id_our_sid - Remove ID - Siddiqui Catalogue (string)
    • remove_id_our_sg - Remove ID - Stanley Gibbons (string)
    • remove_id_our_un - Remove ID - Unificato (string)
    • remove_id_our_wad - Remove ID - WADP Numbering System - WNS (string)
    • remove_id_our_yt - Remove ID - Yvert et Tellier (string)
    • remove_id_our_zon - Remove ID - Zonnebloem (string)
    • remove_id_our_zum - Remove ID - Zumstein (string)
    • remove_image - Remove Image (option)
    • separation_id - Separation Id (option)
    • sides_printed - Sides Printed (option)
    • sources - Sources (string)
    • stamp_subject - Stamp Subject (string)
    • stamp_type_id - Stamp Type Id (option)
    • theme_0 - Theme 0 (option)
    • theme_1 - Theme 1 (option)
    • theme_2 - Theme 2 (option)
    • theme_3 - Theme 3 (option)
    • theme_4 - Theme 4 (option)
    • theme_5 - Theme 5 (option)
    • theme_6 - Theme 6 (option)
    • theme_7 - Theme 7 (option)
    • theme_8 - Theme 8 (option)
    • type - Type (option)
    • variant_desc - Variant Desc (string)
    • weight - Weight (number)
    • width - Width (number)
  • value - Submission value
  • auto_approve (Optional) - Auto-approve submission if your account has permission
    • 0
    • 1

Inventory

POST https://api.stamp-store.com/v1/catalog_edit/inventory

Submit a change/create request for the inventory of an item

Arguments
  • parent_sid - Parent item SID
  • child_sid - Child item SID
  • quantity - Quantity of child in parent
  • sequence_id (Optional) - Sequence ID, optional, >= 0
  • auto_approve (Optional) - Auto-approve submission if your account has permission
    • 0
    • 1

Create Item

POST https://api.stamp-store.com/v1/catalog_edit/create

Submit an item creation request

Arguments
  • type - Item type
    • Stamp
    • Set
    • Series
    • Block
    • Sheet
    • Booklet
    • Equipment
  • name - Item name
  • auto_approve (Optional) - Auto-approve submission if your account has permission
    • 0
    • 1

Edit (File)

POST https://api.stamp-store.com/v1/catalog_edit/file

Submit a change request for an item that needs a file

Arguments
  • sid - SID
  • type - Submission type
    • primary_image - Primary Image
  • data - Base64 Encoded raw file data
  • content_type - Content type of the file
    • image/png
    • image/x-png
    • image/jpeg
    • image/jpg
    • image/gif
  • auto_approve (Optional) - Auto-approve submission if your account has permission
    • 0
    • 1

Create Taxonomy

POST https://api.stamp-store.com/v1/catalog_edit/create_taxonomy

Create a taxonomy such as a category or theme

Arguments
  • name
  • description (Optional)
  • parent_taxonomy_id (Optional) - ID of the parent taxonomy, for hierarchical structures
  • taxonomy_type - Taxonomy type
    • theme - Theme
    • category - Category
  • auto_approve (Optional) - Auto-approve submission if your account has permission
    • 0
    • 1

Create Postal Authority

POST https://api.stamp-store.com/v1/catalog_edit/create_postal_authority
Arguments
  • name - Postal Authority

Delete Postal Authority

POST https://api.stamp-store.com/v1/catalog_edit/delete_postal_authority
Arguments
  • id - ID of Postal Authority

Create Gum

POST https://api.stamp-store.com/v1/catalog_edit/create_gum
Arguments
  • name - Gum

Delete Gum

POST https://api.stamp-store.com/v1/catalog_edit/delete_gum
Arguments
  • id - ID of Gum

Create Stamp Currency

POST https://api.stamp-store.com/v1/catalog_edit/create_stamp_currency
Arguments
  • name - Stamp Currency

Delete Stamp Currency

POST https://api.stamp-store.com/v1/catalog_edit/delete_stamp_currency
Arguments
  • id - ID of Stamp Currency

Create Perforation

POST https://api.stamp-store.com/v1/catalog_edit/create_perforation
Arguments
  • name - Perforation

Delete Perforation

POST https://api.stamp-store.com/v1/catalog_edit/delete_perforation
Arguments
  • id - ID of Perforation

Create Separation

POST https://api.stamp-store.com/v1/catalog_edit/create_separation
Arguments
  • name - Separation

Delete Separation

POST https://api.stamp-store.com/v1/catalog_edit/delete_separation
Arguments
  • id - ID of Separation

Create Paper

POST https://api.stamp-store.com/v1/catalog_edit/create_paper
Arguments
  • name - Paper

Delete Paper

POST https://api.stamp-store.com/v1/catalog_edit/delete_paper
Arguments
  • id - ID of Paper

Create Printing Type

POST https://api.stamp-store.com/v1/catalog_edit/create_printing_type
Arguments
  • name - Printing Type

Delete Printing Type

POST https://api.stamp-store.com/v1/catalog_edit/delete_printing_type
Arguments
  • id - ID of Printing Type

Create Edition Type

POST https://api.stamp-store.com/v1/catalog_edit/create_edition_type
Arguments
  • name - Edition Type

Delete Edition Type

POST https://api.stamp-store.com/v1/catalog_edit/delete_edition_type
Arguments
  • id - ID of Edition Type

Create Stamp Type

POST https://api.stamp-store.com/v1/catalog_edit/create_stamp_type
Arguments
  • name - Stamp Type

Delete Stamp Type

POST https://api.stamp-store.com/v1/catalog_edit/delete_stamp_type
Arguments
  • id - ID of Stamp Type

Create Stamp Color

POST https://api.stamp-store.com/v1/catalog_edit/create_stamp_color
Arguments
  • name - Stamp Color

Delete Stamp Color

POST https://api.stamp-store.com/v1/catalog_edit/delete_stamp_color
Arguments
  • id - ID of Stamp Color

Collection

The collection API allows you to view and update your collection

Lots

GET https://api.stamp-store.com/v1/collection/lots

Get a list of lots with details

Update Lot

POST https://api.stamp-store.com/v1/collection/update

Update a lots data. You must pass at least one update field

Arguments
  • lot_id - Lot ID
  • quantity (Optional) - The minimum quantity required, greater than 0
  • price (Optional) - The price of the item. It must be a positive number or blank, it will be rounded to 3 digits of precision
  • note (Optional) - Note
  • condition (Optional) - Condition ID
    • new - New
    • um - Unmounted Mint **
    • mm - Mounted Mint *
    • o - Used

Delete Lot

POST https://api.stamp-store.com/v1/collection/delete_lot

Deletes a collection lot

Arguments
  • lot_id - Lot ID

Create Lot

POST https://api.stamp-store.com/v1/collection/create_lot

Create a new lot. You must pass an item identifier

Arguments
  • sid - A SID

Store Inventory

The store inventory API allows you to download and update your store inventory

List

GET https://api.stamp-store.com/v1/inventory/list

Get a list of your lots with details

Arguments
  • type (Optional) - Filter by item type
    • Stamp
    • Set
    • Series
    • Block
    • Sheet
    • Booklet
    • Equipment
  • active_only (Optional) - Include only items that are for sale and have a quantity > 0. 0 or 1. Default: 1
  • external_id_1 (Optional) - Optional external lot identifier to return one lot
  • lot_id (Optional) - Optional Stamp-Store lot ID to return one lot

Update

POST https://api.stamp-store.com/v1/inventory/update

Update a lots data. You must pass only one identifier and at least one update field

Arguments
  • external_id (Optional) - External lot identifier
  • lot_id (Optional) - Stamp-Store lot ID
  • absolute_quantity (Optional) - The absolute new quantity
  • relative_quantity (Optional) - A positive or negative amount to adjust the existing quantity by
  • for_sale (Optional) - 0 or 1 specifying if an item should be available for sale or not. This works independently of the quantity field, it is usually used for in stock items that you don't want to sell at the moment
  • price (Optional) - The price of the item. It must be a positive number, it will be rounded to 3 digits of precision
  • sale_percent (Optional) - The sale percentage of the item. It must be a whole number between -95 and 95
  • my_cost (Optional) - The price you paid for the item for your own records. It must be a positive number, it will be rounded to 3 digits of precision
  • lot_weight (Optional) - A custom lot weight, set in grams. It must be a positive number, it will be rounded to 3 digits of precision
  • personal_note (Optional) - Personal note
  • public_note (Optional) - Public note
  • bulk_qty (Optional) - Bulk Quantity. A positive number greater than one
  • tier_price (Optional) - Tier prices. Maximum of three tier prices, in the following format 'tier1quantity:tier1price,tier2quantity:tier2price,tier3quantity:tier3price'. For example '100:0.05,200:0.04'. To remove tier pricing, use the value 'remove'
  • condition (Optional) - Condition ID
    • new - New
    • um - Unmounted Mint **
    • mm - Mounted Mint *
    • o - Used
  • update_external_id_1 (Optional) - Change the first external ID associated with the lot

Delete

POST https://api.stamp-store.com/v1/inventory/delete

Deletes a lot. Please note this will remove the lot from customer carts and quotes

Arguments
  • external_id (Optional) - External lot identifier
  • lot_id (Optional) - Stamp-Store lot ID

Create

POST https://api.stamp-store.com/v1/inventory/create

Create a new lot. You must pass an item identifier

Arguments
  • sid - A SID
  • quantity - The quantity of the lot, a whole number greater than zero
  • price - The price of the lot. It must be a positive number, it will be rounded to 3 digits of precision
  • condition - Condition ID
    • new - New
    • um - Unmounted Mint **
    • mm - Mounted Mint *
    • o - Used
  • external_id (Optional) - An optional external ID for reference

Invoice

The invoices API is to retieve information about invoices paid by an account

Transactions

GET https://api.stamp-store.com/v1/invoice/transactions

Retrieve a list of the invoice transactions

Arguments
  • invoice_id - The invoice ID
  • id_type - Type of invoice ID
    • public_invoice_id
    • stripe_charge_id

Order

The orders API allows you to download and process your stores orders and orders you have placed in stores

List

GET https://api.stamp-store.com/v1/order/list

Get a list of your orders

Arguments
  • status (Optional) - Order status filter, use the formatted name or the numeric ID
    • 0 - Pending
    • 1 - Payment Submitted
    • 2 - Payment Received
    • 3 - Processing
    • 4 - Processed
    • 5 - Shipped
    • 6 - Received
    • 7 - On Hold
    • 8 - Cancelled
  • order_time (Optional) - Unix Timestamp to limit the orders returned to those with a timestamp greater than or equal to the one provided
  • limit (Optional) - Limit the amount of results returned, defaults to 500
  • list_type (Optional) - Order list type
    • store - Store orders
    • customer - Orders you have placed

View

GET https://api.stamp-store.com/v1/order/view

Retrieve full order details

Arguments
  • order_id - The order ID

Items

GET https://api.stamp-store.com/v1/order/items

Retrieve order items

Arguments
  • order_id - The order ID

Tracking

POST https://api.stamp-store.com/v1/order/tracking

Attach a shipping tracking information to the order

Arguments
  • order_id - The order ID
  • tracking_id - Tracking ID / URL

Note

POST https://api.stamp-store.com/v1/order/note

Edit the seller note on an order

Arguments
  • order_id - The order ID
  • note - Seller note

Tax Schemes

GET https://api.stamp-store.com/v1/order/tax_schemes

Get a list of possible tax schemes that can be applied to orders

Notify

POST https://api.stamp-store.com/v1/order/notify

You can set an IP address to be notified instantly when an order is placed via a HTTP request. The request will be placed to http://IP_ADDR:42500/stamp-store_order_notify. You will need to setup an appropriate webserver to receive the request. This service is not guaranteed, so you will also need to check at an interval. The request will contain GET parameters of order_id and store_id. It does not contain order data. To remove the notification, submit an empty string for the ip parameter.

Arguments
  • ip - The IP address to be notified

Leave Feedback

POST https://api.stamp-store.com/v1/order/feedback

Leave feedback for an order

Arguments
  • order_id - The order ID
  • comment (Optional) - The feedback comment. Maximum of 120 characters long
  • rating - The feedback rating
    • 1 - Positive
    • 0 - Neutral
    • -1 - Negative

Set Status

POST https://api.stamp-store.com/v1/order/set_status

Change the status of the order

Arguments
  • order_id - The order ID
  • status_id - Order Status ID
    • 1 - Payment Submitted
    • 2 - Payment Received
    • 3 - Processing
    • 4 - Processed
    • 5 - Shipped
    • 6 - Received

Token (Deprecated)

This is for accessing details about a token

Details

GET https://api.stamp-store.com/v1/token/details

Retrieve details about the user who the API key belongs to. This will include store details if they have one

User

This is for accessing information about the user associated with the API key.

Get Token

POST https://api.stamp-store.com/v1/user/get_token

Get a users API token for wishlist edit. This API is only available on request.

Arguments
  • username - Username
  • application_name - Application Name

Details

GET https://api.stamp-store.com/v1/user/details

Retrieve details about the user who the API key belongs to. This will include store details if they have one

Addresses

GET https://api.stamp-store.com/v1/user/addresses

Retrieve the addresses associated with the user account

Wishlist Lookup

GET https://api.stamp-store.com/v1/user/wishlist_lookup

Retrieve a list of wishlist IDs for an item id. This API is only available on request.

Arguments
  • sid - SID

Wishlist

The wishlist API allows you to view and update your wishlists

Lists

GET https://api.stamp-store.com/v1/wishlist/lists

Get a list of your wishlists

Lots

GET https://api.stamp-store.com/v1/wishlist/lots

Get a list of a specific wishlists lots with details

Arguments
  • wishlist_id - The wishlists unique ID

Update Lot

POST https://api.stamp-store.com/v1/wishlist/update

Update a lots data. You must pass at least one update field

Arguments
  • wishlist_id - The wishlists unique ID
  • lot_id - Wishlist lot ID
  • minimum_quantity (Optional) - The minimum quantity required, greater than 0
  • maximum_price (Optional) - The price of the item. It must be a positive number or blank, it will be rounded to 3 digits of precision
  • note (Optional) - Note
  • minimum_condition (Optional) - Condition ID
    • new - New
    • um - Unmounted Mint **
    • mm - Mounted Mint *
    • o - Used

Delete Lot

POST https://api.stamp-store.com/v1/wishlist/delete_lot

Deletes a wishlist lot

Arguments
  • wishlist_id - The wishlists unique ID
  • lot_id - Wishlist lot ID

Create List

POST https://api.stamp-store.com/v1/wishlist/create_list

Create a new wishlist

Arguments
  • name - A unique name for the wishlist
  • description (Optional) - An optional description

Update List

POST https://api.stamp-store.com/v1/wishlist/update_list

Update a wishlist

Arguments
  • wishlist_id - The wishlists unique ID
  • name - A unique name for the wishlist

Delete List

POST https://api.stamp-store.com/v1/wishlist/delete_list

Delete a wishlist

Arguments
  • wishlist_id - The wishlists unique ID

Create Lot

POST https://api.stamp-store.com/v1/wishlist/create_lot

Create a new lot. You must pass an item identifier

Arguments
  • wishlist_id - The wishlists unique ID
  • sid - A SID