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

© 2019 Hip eCommerce, Inc. version: 48ec4689