API Field Values
Note: "Allowed Values" for Item Specifics may be keys to display values, but where any non alphanumeric characters are replaced with dashes. This may appear confusing when, for example, a display value is "9.6 NM+", as the key would be "9-6-nm-". However, buyers will only see the display values, and not the keys.
Note: Certain Item Specifics fields are only available for Listings in the designated categories, and their sub-categories, as noted below.
| Column Name | Type | Allowed Values | Notes |
|---|---|---|---|
| listing_type | string | auction, product |
Listing Type Choose the listing type you wish to create. |
| currency | string | ARS, AUD, BRL, CLP, CNY, COP, CZK, DKK, EUR, FJD, GBP, HKD, ISK, INR, IDR, ILS, JPY, MYR, MXN, MAD, NZD, NOK, PKR, PAB, PEN, PHP, PLN, RUB, SGD, SKK, SIT, ZAR, KRW, LKR, SEK, CHF, TWD, THB, TND, TRL, USD, VEB, RON, CAD |
Currency Select your item's currency. |
| item_specifics_01_country | string |
Country Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals |
|
| item_specifics_02_catalog_number | string |
Catalog Number Except for Scott, prefix by Catalog abbreviation, ie: SG45, Mi710, YT15, etc. Separate multiples with a comma or dash (for ranges). Applicable in the following categories, and their sub-categories:Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals |
|
| item_specifics_03_stamp_type | string | general-issue, air-mail, air-mail-officials, air-mail-parcel-post, air-mail-registration, air-mail-semi-official, air-mail-semi-postal, air-mail-semi-postal-official, air-mail-special-delivery, booklets, booklets-air-mail, booklets-cover, duck-stamps-federal, duck-stamps-state, locals-carriers, locals-carriers-acknowledgement-of-receipt, locals-carriers-air-mail, locals-carriers-newspaper-stamps, locals-carriers-occupation, locals-carriers-occupation-air-mail, locals-carriers-occupation-special-delivery, locals-carriers-officials, locals-carriers-parcel-post, locals-carriers-postage-due, locals-carriers-postal-stationery, locals-carriers-registration, locals-carriers-semi-official, locals-carriers-semi-postal, locals-carriers-special-delivery, locals-carriers-special-delivery-semi-postal, locals-carriers-wrapper, military, military-air-mail, military-air-mail-special-delivery, military-newspaper, military-parcel-post, military-semi-postal, military-special-delivery, newspaper-stamps, occupation, occupation-air-mail, occupation-air-mail-semi-postal, occupation-air-mail-special-delivery, occupation-newspaper-stamps, occupation-official, occupation-official-card, occupation-postage-due, occupation-postal-cards, occupation-postal-stationery, occupation-postal-tax, occupation-postal-tax-due, occupation-rural-delivery, occupation-semi-postal, occupation-special-delivery, offices-abroad, offices-abroad-forerunner, offices-abroad-semi-postal, officials, officials-air-mail, officials-air-mail-perfin, officials-air-mail-perfin-special-delivery, officials-departmental, officials-locals-carriers, officials-perfin, officials-perfin-air-mail, officials-perfin-special-delivery, officials-special-delivery-perfin, parcel-post, parcel-post-authorized-delivery, parcel-post-official, parcel-post-postal-tax, postage-due, postage-due-parcel-post, postal-cards, postal-cards-air-mail, postal-cards-air-mail-military, postal-cards-official, postal-cards-paid-reply, postal-stationery, postal-stationery-air-mail, postal-stationery-air-mail-military, postal-stationery-official, postal-stationery-registration-stamps, postal-stationery-savings, postal-stationery-special-delivery, revenues, revenues-beer, revenues-boating, revenues-camping, revenues-cigarettes, revenues-consular-service-fee, revenues-cordials-wines-etc-, revenues-customs-fee, revenues-distilled-spirits, revenues-embossed-stamped-paper, revenues-firearms-transfer, revenues-future-delivery, revenues-motor-vehicles, revenues-narcotic-tax, revenues-playing-cards, revenues-postal-tax, revenues-postal-tax-air-mail, revenues-postal-tax-due, revenues-postal-tax-semi-postal, revenues-potato-tax, revenues-private-die-canned-fruit, revenues-private-die-medicine, revenues-private-die-perfumery, revenues-private-die-playing-cards, revenues-private-die-proprietary-match, revenues-proprietary, revenues-rectification, revenues-silver-tax, revenues-stamped-paper, revenues-stock-transfer, revenues-trailer-permit, revenues-unemployment-insurance, semi-postal, special-delivery, special-delivery-authorized-delivery, special-delivery-official, special-delivery-personal-delivery, special-delivery-semi-postal, special-delivery-tax, special-handling, back-of-book-other-, back-of-book-other-acknowledgment-of-receipt, back-of-book-other-certified-mail, back-of-book-other-computer-vended, back-of-book-other-computer-vended-postal-cards, back-of-book-other-encased-postage, back-of-book-other-flat-plate-imperforate-coil, back-of-book-other-insured, back-of-book-other-insured-marine, back-of-book-other-international-reply-coupon, back-of-book-other-late-fee, back-of-book-other-life-insurance, back-of-book-other-machin-head, back-of-book-other-numismatic-souvenir-card, back-of-book-other-pneumatic-post, back-of-book-other-postage-currency, back-of-book-other-postal-fiscal-revenues, back-of-book-other-postal-insurance, back-of-book-other-postal-note, back-of-book-other-postmasters-provisional, back-of-book-other-postmasters-provisional-handstamped, back-of-book-other-prefecture, back-of-book-other-prefecture-semi-postal, back-of-book-other-proofs-essays, back-of-book-other-proofs-essays-essays, back-of-book-other-proofs-essays-proofs, back-of-book-other-proofs-essays-proofs-trial-color, back-of-book-other-rf-overprint, back-of-book-other-registration-stamps, back-of-book-other-revolutionary-government, back-of-book-other-revolutionary-government-newspaper, back-of-book-other-revolutionary-government-registration, back-of-book-other-sanitary-fair, back-of-book-other-savings, back-of-book-other-savings-treasury, back-of-book-other-savings-war, back-of-book-other-seals, back-of-book-other-seals-christmas, back-of-book-other-seals-postage-stamp-agency, back-of-book-other-seals-registry, back-of-book-other-seals-typeset-post-office, back-of-book-other-seaport, back-of-book-other-souvenir-card, back-of-book-other-souvenir-page, back-of-book-other-specimen, back-of-book-other-telegraph-stamps, back-of-book-other-telegraph-stamps-officials, back-of-book-other-test-stamps, back-of-book-other-war-tax, back-of-book-other-wrapper, back-of-book-other-wrapper-official, not-specified |
Stamp Type Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_04_condition | string | mint-nh-, unused, used, first-day-cover, cover-postal-history-, not-specified |
Condition Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_08_centering | string | superb, xf-superb, xf, vf-xf, vf, f-vf, fine, vg-below, not-specified |
Centering Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_05_stamp_format | string | single, block, error, full-sheet, miniature-sheet, multiple, pair, plate-block, plate-number-coil, souvenir-sheet |
Stamp Format Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_09_has_a_certificate | string | no, yes |
Has a Certificate Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_10_certificate_grade | string | 100, 98, 95, 90, 85, 80, 75, 70, 65-below, not-graded, not-specified |
Certificate Grade Only select, if the item has a third-party graded certificate Applicable in the following categories, and their sub-categories:Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_06_topic | string | animals-birds, animals-dinosaurs-prehistorics, animals-insects-spiders, animals-mammals, animals-marine-life, animals-reptiles-amphibians, animals-other, animation-cartoons, architecture-buildings, art, awards-medals, cultural-heritages-american-indian, cultural-heritages-asian, cultural-heritages-black-heritage, cultural-heritages-egyptian, cultural-heritages-greek-roman, cultural-heritages-other, environment-nature, europa, flags-coats-of-arms, flowers-trees, fruits-vegetables, geography-places, health-medicine, christmas-other-holidays, military, music, olympics, organizations-freemasonry, organizations-ilo-international-labor-, organizations-itu-international-telecommunications-union-, organizations-nato, organizations-red-cross, organizations-rotary-international-lions-, organizations-scouts, organizations-unesco, organizations-unicef, organizations-upu-universal-postal-union-, organizations-who-world-health-organization-, organizations-wwf-world-wildlife-fund-, organizations-other, famous-people-actors-actresses, famous-people-athletes, famous-people-inventors, famous-people-nobel-prize-winners, famous-people-politicians, famous-people-royalty, famous-people-singers, famous-people-writers, famous-people-other, religion, sciences, space, sports, stamps-coins-coins-on-stamps, stamps-coins-philatelic-exhibitions, stamps-coins-stamp-day, stamps-coins-stamps-on-stamps, stamps-coins-other, transport-aircrafts-aviation, transport-bicycles, transport-buses, transport-cars, transport-hot-air-balloons, transport-motorcycles, transport-ships, transport-stage-coaches, transport-submarines, transport-trains, transport-trams-trolleys, transport-zeppelins, transport-other, not-specified |
Topic Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Topicals Values must be from the "Allowed Values" column, or they will be ignored. Note that if a value is displayed to the left as captain-america, it is also acceptable to enter the value as "Captain America" in your file. |
| item_specifics_07_year_of_issue | string |
Year of Issue Applicable in the following categories, and their sub-categories: Africa; Asia; Australia & Oceania; British Commonwealth; Canada; Caribbean; Europe; Great Britain; Central & South America; Middle East; Worldwide; United States; Specialty Philately; Topicals |