‹ Contents
PGA Field Guide
U.S. postal informal entries (type 13)
Many products need data for another U.S. agency besides Customs. These agencies are called PGAs (Partner Government Agencies). When the PGA API classifies an item, it returns the agencies that care about it as flags. This guide explains each agency, the products that usually trigger it, and the fields you must send us so the parcel clears.
Flags come in pairs. A "may be required" flag (for example FD3) can be disclaimed when the item is truly not regulated. A "required" flag (for example FD4) cannot be disclaimed: the agency data must be sent. Disclaiming a required flag refuses the whole parcel.
Rules as of 7 October 2026
Translations are a first pass and have not had a native-speaker review. If a translation and the English differ, the English is the authority. Codes and examples stay in English because they are filed in English.
All agencies at a glance
| Agency | "May be required" flags | "Required" flags | |
|---|---|---|---|
| FDAFood and Drug Administration | FD1 FD3 | FD2 FD4 | Send agency data |
| APHISUSDA Animal and Plant Health Inspection Service | AQ1 AQX | AQ2 | Send agency data |
| Lacey ActUSDA APHIS Lacey Act (plants and wood) | AL1 | AL2 | Send agency data |
| AMSUSDA Agricultural Marketing Service | AM1 AM3 AM7 | AM2 AM4 AM6 AM8 | Send agency data |
| CPSCConsumer Product Safety Commission | CP1 | CP2 | Send agency data |
| FWSU.S. Fish and Wildlife Service | FW1 FW3 | FW2 | Send agency data |
| NMFSNOAA Fisheries (National Marine Fisheries Service) | NM1 NM3 NM5 | NM2 NM4 NM6 NM8 | Send agency data |
| NHTSANational Highway Traffic Safety Administration | DT1 | DT2 | Send agency data |
| EPAEnvironmental Protection Agency | EP1 EP3 EP5 EP7 EH1 | EP2 EP4 EP6 EP8 EH2 | Disclaim only |
| DEADrug Enforcement Administration | DE1 DE3 | — | Disclaim only |
| FSISUSDA Food Safety and Inspection Service | FS3 | FS4 | Formal entry only |
| State DeptState Department Office of Marine Conservation | OM1 | OM2 | Formal entry only |
| TTBAlcohol and Tobacco Tax and Trade Bureau | TB1 TB3 | TB2 | Formal entry only |
FDA
Food and Drug Administration
Send agency data"May be required" flags: FD1 FD3"Required" flags: FD2 FD4
What it is
FDA regulates food, dietary supplements, drugs, medical devices, cosmetics, tobacco and e-cigarettes, radiation-emitting products and veterinary products.
FD1 / FD2 cover admissibility. FD2 cannot be disclaimed. The product type (food, cosmetic, device, drug, tobacco and so on) decides which fields are mandatory.
FD3 / FD4 cover food prior notice. Food must have FDA prior notice filed and confirmed BEFORE it is mailed, and the 12-digit confirmation number must be on the CN22/CN23. Without it, CBP holds the parcel up to 72 hours and FDA may refuse it: returned or destroyed.
Homemade food that a person sends as a gift does not need prior notice.
Common products
| Honey, 500 g jar | 0409.00.0010 | FD4 required |
| Dried shiitake mushrooms | 0712.34.1000 | FD4 required |
| Potato crisps | 2005.20.0020 | FD4 required |
| Dry dog food | 2309.10.0090 | FD4 required (animal food) |
| Vitamin C supplement | 2106.90.9993 | FD3 disclaimed by default. Wrong: a supplement is food. Send the data. |
| Sunscreen SPF 50 | 3304.99.5000 | FD2 required (cosmetic or drug) |
| Clinical thermometer | 9025.19.8020 | FD2 required (device) |
| E-cigarette with nicotine | 8543.40.0030 | FD2 required (tobacco) |
Also typical: Tea, coffee, snacks, sauces, spices, candy, skincare and make-up, contact lenses, massagers, laser pointers, ceramic tableware.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | GREEN TEA LEAVES, DRIED, RETAIL BOX 250 G |
| Product type (food, cosmetic, device, drug...) | Mandatory | Post gives facts, JFS codes them | Processed food |
| Country where it was grown or made | Mandatory | Post / seller | CN |
| Common or usual name | Mandatory | Post / seller | DRIED GREEN TEA LEAVES |
| Manufacturer name and address (the real maker, not the seller or platform) | Mandatory | Post / seller | ACME FOODS CO, 1 EXAMPLE ROAD, HANGZHOU, CN |
| Shipper name and address | Mandatory | Post / seller | Who handed over the parcel |
| U.S. addressee name, address, state and ZIP | Mandatory | Post / seller | LOS ANGELES, CA 90012 |
| Expected arrival date and time | Mandatory | Post gives facts, JFS codes them | 2026-10-30 10:15 |
| Prior notice confirmation number (food) | If it applies | Post / seller | 12 digits. Only FDA can issue it. |
| Intended use (for non-food) | If it applies | Post gives facts, JFS codes them | Personal use |
| Registration, listing or canned-food numbers | If it applies | Post gives facts, JFS codes them | FDA registration number |
| Packaging levels (quantity and unit) | If it applies | Post / seller | 1 BOX of 10 PCS (devices, drugs) |
| Brand name | If it applies | Post / seller | Required for tobacco and some devices |
Full field list · FD2(36)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description of the line as sold (OI record).fda[].commercialDescription | OI | Mandatory | Post / seller | DIGITAL THERMOMETER, ORAL, HOUSEHOLDMax length: 70 |
| Government agency processing codeSub-type: BIO ALG/BBA/BDP/BLD/BLO/CGT/HCT/PVE/VAC/XEN; DEV NED/RED; DRU PRE/OTC/RND/INV/PHN/804; FOO NSF/PRO/FEE/ADD/DSU/CCW; RAD REP; TOB CSU/FFM/INV; VME ADR/ADE. Cosmetics have no processing code.fda[].governmentAgencyProcessingCode | PG01 | Mandatory | Post gives facts, JFS codes them | NEDMax length: 3 |
| Intended use codeWhy the article is imported (CBP Appendix R). Mandatory for every non-food program; optional for food except CCW. Personal use: 100.000 (BIO, COS, DRU, DEV, RAD, VME), 210.000 (human food); tobacco has no personal-use code, so consumer tobacco is 130.000. The post states the purpose; JFS maps it to the code.fda[].intendedUseCode | PG01 | If it applies | Post gives facts, JFS codes them | 100.000Max length: 16 |
| Constituent element (active ingredient) nameOptional PG04 for biologics, drugs and animal drugs.fda[].constituentElements[].name | PG04 | If it applies | Post / seller | EXAMPLE INGREDIENTMax length: 51 |
| Country of productionWhere the article was produced (grown or harvested for food) - not necessarily the country of export.fda[].originInfo.countryCode | PG06 | Mandatory | Post / seller | XXMax length: 2 |
| Trade / brand nameBIO: must be sent if it exists (optional for HCT). DEV: optional for NED, mandatory for RED subject to Form 2877. RAD: mandatory when Form 2877 applies. TOB: mandatory for CSU (consumer use). Optional otherwise.fda[].tradeBrand.name | PG07 | If it applies | Post / seller | EXAMPLE BRANDMax length: 35 |
| Product description (common or usual name)Common, market or usual name / invoice description; PG10 is mandatory in every 801(a) chapter.fda[].commodityCharacteristics[].description | PG10 | Mandatory | Post / seller | ORAL DIGITAL THERMOMETERMax length: 57 |
| Prior notice confirmation number (food)Food sent by mail is subject to prior notice; the 12-digit confirmation goes in PG14 with type PNC (not for CCW).fda[].lpcoIssuers[].lpcos[].number | PG14 | If it applies | Post / seller | NNNNNNNNNNNN (12 digits)Max length: 33 |
| Manufacturer - nameName of the manufacturer. Overflow goes to PG60 qualifier ENA. The actual maker, not the seller or platform.fda[].entities[].name | PG19 | Mandatory | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Manufacturer - address line 1Street address; overflow to PG60 qualifier AD1.fda[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Manufacturer - cityCity (mandatory on PG20).fda[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| Manufacturer - state/provinceAppendix B state/province code; required for US and Canada based entities.fda[].entities[].locations[].stateProvince | PG20 | If it applies | Post / seller | XXMax length: 3 |
| Manufacturer - countryISO country code (mandatory on PG20).fda[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| Manufacturer - postal codeRequired only for US or Canada based entities (a foreign postal code is optional).fda[].entities[].locations[].postalCode | PG20 | If it applies | Post / seller | 12345Max length: 9 |
| Manufacturer - entity identification code (FEI/DUNS)Optional FEI (47) or DUNS (16); code and number travel together. Registration and listing are separate PG23 affirmations, not this field. Applies to any role.fda[].entities[].identificationCode | PG19 | If it applies | Post / seller | 47Max length: 3 |
| Manufacturer - FEI or DUNS numberOptional; must be real if sent.fda[].entities[].number | PG19 | If it applies | Post / seller | NNNNNNNNNMax length: 15 |
| Shipper - nameName of the shipper. Overflow goes to PG60 qualifier ENA.fda[].entities[].name | PG19 | Mandatory | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Shipper - address line 1Street address; overflow to PG60 qualifier AD1.fda[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Shipper - cityCity (mandatory on PG20).fda[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| Shipper - state/provinceAppendix B state/province code; required for US and Canada based entities.fda[].entities[].locations[].stateProvince | PG20 | If it applies | Post / seller | XXMax length: 3 |
| Shipper - countryISO country code (mandatory on PG20).fda[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| Shipper - postal codeRequired only for US or Canada based entities (a foreign postal code is optional).fda[].entities[].locations[].postalCode | PG20 | If it applies | Post / seller | 12345Max length: 9 |
| Deliver-to party - nameName of the deliver-to party. Overflow goes to PG60 qualifier ENA. The US addressee.fda[].entities[].name | PG19 | Mandatory | Post / seller | ADDRESSEE NAMEMax length: 32 |
| Deliver-to party - address line 1Street address; overflow to PG60 qualifier AD1.fda[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Deliver-to party - cityCity (mandatory on PG20).fda[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| Deliver-to party - state/provinceAppendix B state code; the deliver-to party is the US addressee, so it is always required.fda[].entities[].locations[].stateProvince | PG20 | Mandatory | Post / seller | XXMax length: 3 |
| Deliver-to party - countryISO country code (mandatory on PG20).fda[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| Deliver-to party - postal codeUS ZIP code; the deliver-to party is the US addressee, so it is always required.fda[].entities[].locations[].postalCode | PG20 | Mandatory | Post / seller | 12345Max length: 9 |
| Affirmation of compliance codeProgram-specific: drugs REG (registration), DLS (listing), DA (application) by processing and intended use code (personal use 100.000 and import-for-export 970.000 need none); devices LST/DEV/DFE/PM#/DI by intended use; animal drugs REG/VNA/VAN/VIN; food FCE/SID for LACF/AF; optional for cosmetics and tobacco.fda[].affirmationsOfCompliance[].complianceCode | PG23 | If it applies | Post gives facts, JFS codes them | REGMax length: 5 |
| Affirmation of compliance qualifierValue for the AoC code (blank for indicator-only codes); must follow Appendix PGA syntax.fda[].affirmationsOfCompliance[].complianceDescription | PG23 | If it applies | Post gives facts, JFS codes them | Max length: 30 |
| PGA line value (USD)Optional whole-dollar value (conditional PG25 for drugs).fda[].lotNumbers[].pgaLineValue | PG25 | If it applies | Post / seller | 25 |
| Packaging levelOptional for BIO, COS, FOO, TOB and VME; conditional for DRU, DEV and RAD. When sent, qualifier, quantity and UOM are all required, last level a base unit.fda[].packagingDetails[].qualifier | PG26 | If it applies | Post / seller | 1 |
| Packaging quantitySee packaging-qualifier.fda[].packagingDetails[].quantity | PG26 | If it applies | Post / seller | 1 |
| Packaging unit of measureSee packaging-qualifier.fda[].packagingDetails[].unitOfMeasure | PG26 | If it applies | Post / seller | BXMax length: 5 |
| Anticipated arrival dateMandatory with status A.fda[].laboratoryTests[].eventDate | PG30 | Mandatory | Post gives facts, JFS codes them | 2026-10-30 |
| Anticipated arrival timeMandatory with status A.fda[].laboratoryTests[].eventTime | PG30 | Mandatory | Post gives facts, JFS codes them | 10:15 |
Full field list · FD4(37)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 1
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description of the line as sold (OI record).fda[].commercialDescription | OI | Mandatory | Post / seller | GREEN TEA LEAVES, DRIED, RETAIL BOX 250 GMax length: 70 |
| Government agency processing codeFood sub-type: NSF natural state, PRO processed, FEE animal food, ADD additives/colors, DSU dietary supplement, CCW ceramicware/food contact. The post describes the article; JFS picks the code.fda[].governmentAgencyProcessingCode | PG01 | Mandatory | Post gives facts, JFS codes them | PROMax length: 3 |
| Intended use codeOptional for NSF, PRO, FEE, ADD and DSU; required only for CCW (130.029, 970.000 or 980.000 - 980.000 is ceramicware/food-contact only). Personal use as human food is 210.000. The post states the purpose; JFS maps it.fda[].intendedUseCode | PG01 | If it applies | Post gives facts, JFS codes them | 210.000Max length: 16 |
| Country of production / growthWhere the food was harvested or produced - not necessarily the country of export.fda[].originInfo.countryCode | PG06 | Mandatory | Post / seller | XXMax length: 2 |
| Trade / brand nameOptional brand name; overflow to PG60 qualifier TBN.fda[].tradeBrand.name | PG07 | If it applies | Post / seller | EXAMPLE BRANDMax length: 35 |
| Product description (common or usual name)Common, market or usual name / invoice description - not the product-code description.fda[].commodityCharacteristics[].description | PG10 | Mandatory | Post / seller | DRIED GREEN TEA LEAVESMax length: 57 |
| Prior notice confirmation numberThe 12-digit confirmation FDA issues for the prior notice, which must be submitted and confirmed before the parcel is mailed. Nothing downstream can create it. Required for mailed food subject to prior notice; not for CCW or for food outside prior notice (21 CFR 1.277(b), e.g. homemade food sent as a personal gift).fda[].lpcoIssuers[].lpcos[].number | PG14 | If it applies | Post / seller | NNNNNNNNNNNN (12 digits)Max length: 33 |
| Manufacturer - nameName of the manufacturer. Overflow goes to PG60 qualifier ENA. The actual maker or grower, not the seller or platform.fda[].entities[].name | PG19 | Mandatory | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Manufacturer - address line 1Street address; overflow to PG60 qualifier AD1.fda[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Manufacturer - cityCity (mandatory on PG20).fda[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| Manufacturer - state/provinceAppendix B state/province code; required for US and Canada based entities.fda[].entities[].locations[].stateProvince | PG20 | If it applies | Post / seller | XXMax length: 3 |
| Manufacturer - countryISO country code (mandatory on PG20).fda[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| Manufacturer - postal codeRequired only for US or Canada based entities (a foreign postal code is optional).fda[].entities[].locations[].postalCode | PG20 | If it applies | Post / seller | 12345Max length: 9 |
| Manufacturer - entity identification code (FEI/DUNS)Optional: 47 (FEI, 1-10 digits) or 16 (DUNS, 9 digits). If either the code or the number is sent, both are required. Applies to any role.fda[].entities[].identificationCode | PG19 | If it applies | Post / seller | 47Max length: 3 |
| Manufacturer - FEI or DUNS numberOptional; must be real if sent (validated against FDA/D&B tables).fda[].entities[].number | PG19 | If it applies | Post / seller | NNNNNNNNNMax length: 15 |
| Shipper - nameName of the shipper. Overflow goes to PG60 qualifier ENA. The party that tendered the parcel.fda[].entities[].name | PG19 | Mandatory | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Shipper - address line 1Street address; overflow to PG60 qualifier AD1.fda[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Shipper - cityCity (mandatory on PG20).fda[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| Shipper - state/provinceAppendix B state/province code; required for US and Canada based entities.fda[].entities[].locations[].stateProvince | PG20 | If it applies | Post / seller | XXMax length: 3 |
| Shipper - countryISO country code (mandatory on PG20).fda[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| Shipper - postal codeRequired only for US or Canada based entities (a foreign postal code is optional).fda[].entities[].locations[].postalCode | PG20 | If it applies | Post / seller | 12345Max length: 9 |
| Deliver-to party - nameName of the deliver-to party. Overflow goes to PG60 qualifier ENA. The US addressee.fda[].entities[].name | PG19 | Mandatory | Post / seller | ADDRESSEE NAMEMax length: 32 |
| Deliver-to party - address line 1Street address; overflow to PG60 qualifier AD1.fda[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Deliver-to party - cityCity (mandatory on PG20).fda[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| Deliver-to party - state/provinceAppendix B state code; the deliver-to party is the US addressee, so it is always required.fda[].entities[].locations[].stateProvince | PG20 | Mandatory | Post / seller | XXMax length: 3 |
| Deliver-to party - countryISO country code (mandatory on PG20).fda[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| Deliver-to party - postal codeUS ZIP code; the deliver-to party is the US addressee, so it is always required.fda[].entities[].locations[].postalCode | PG20 | Mandatory | Post / seller | 12345Max length: 9 |
| Affirmation of compliance codeConditional: FCE + SID (and VOL or PG28) for low-acid canned or acidified food; FSX/RNE FSVP exemption indicators; others optional.fda[].affirmationsOfCompliance[].complianceCode | PG23 | If it applies | Post gives facts, JFS codes them | FSXMax length: 5 |
| Affirmation of compliance qualifierValue for the AoC code; blank for indicator-only codes.fda[].affirmationsOfCompliance[].complianceDescription | PG23 | If it applies | Post gives facts, JFS codes them | Max length: 30 |
| PGA line value (USD)Optional whole-dollar value; speeds review.fda[].lotNumbers[].pgaLineValue | PG25 | If it applies | Post / seller | 25 |
| Lot numberOptional lot or code number.fda[].lotNumbers[].number | PG25 | If it applies | Post / seller | TESTONLYMax length: 25 |
| Packaging levelOptional on this chapter; if sent, qualifier, quantity and UOM are all required, outermost (1) to innermost, last level a base unit.fda[].packagingDetails[].qualifier | PG26 | If it applies | Post / seller | 1 |
| Packaging quantitySee packaging-qualifier.fda[].packagingDetails[].quantity | PG26 | If it applies | Post / seller | 1 |
| Packaging unit of measureContainer code (Table 10-25) or base unit for the last level (Table 10-26).fda[].packagingDetails[].unitOfMeasure | PG26 | If it applies | Post / seller | BXMax length: 5 |
| Container dimensions (LACF/AF)Low-acid canned and acidified food only, when VOL is not given in PG23. PayCBP v4 has no PG28 field, so use PG23 VOL instead. | PG28 | If it applies | Post / seller | |
| Anticipated arrival date at port of entryMandatory with status A.fda[].laboratoryTests[].eventDate | PG30 | Mandatory | Post gives facts, JFS codes them | 2026-10-30 |
| Anticipated arrival time at port of entryMandatory with status A (HHMM; midnight is 2400).fda[].laboratoryTests[].eventTime | PG30 | Mandatory | Post gives facts, JFS codes them | 10:15 |
APHIS
USDA Animal and Plant Health Inspection Service
Send agency data"May be required" flags: AQ1 AQX"Required" flags: AQ2
What it is
APHIS keeps plant pests and animal diseases out of the U.S. It covers plants, seeds, soil, plant products, animal products and veterinary biologics.
AQ1 can be disclaimed only when no permit or certificate is needed: A = not regulated by APHIS, B = regulated but no data or permit needed. Tell us whether the item is plant-based or animal-based.
If a health or meat certificate is needed, the original paper must travel with the parcel. For a phytosanitary certificate, send the original with the parcel and give us a copy.
Common products
| Tomato seeds for planting | 1209.91.8070 | AQ2 required |
| Dried flower arrangement | 0604.90 | Typical AQ2 item |
| Honey, crisps, dog food, supplements, sunscreen | various | AQ1 disclaimed by default (A) |
Also typical: Live plants and cuttings, bulbs, fresh fruit and vegetables, straw and wicker goods, animal hides, wool, feathers, pet treats with animal content.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | DRIED FLOWER ARRANGEMENT, DECORATIVE |
| Purpose of import | Mandatory | Post gives facts, JFS codes them | Personal use / resale |
| Country where grown, produced or caught | Mandatory | Post / seller | Not always the country of origin |
| Common name of each product and component | Mandatory | Post / seller | DRIED ROSE |
| Parties: name, address, city, country | Mandatory | Post gives facts, JFS codes them | ACME TRADING CO, 1 EXAMPLE ROAD |
| Net quantity and unit | Mandatory | Post / seller | 0.5 KG |
| Expected arrival date and port | Mandatory | Post gives facts, JFS codes them | 2026-10-30, LAX |
| Country where the trip to the U.S. began | Mandatory | Post / seller | TH |
| Scientific name (genus and species) | If it applies | Post / seller | ROSA CHINENSIS |
| Permit or certificate: type, number, date, issuing country | If it applies | Post gives facts, JFS codes them | Phytosanitary certificate. Must be real. |
Full field list · AQ2(21)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 3
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionCBP-mandated line description.aphis[].commercialDescription | OI | Mandatory | Post / seller | DRIED FLOWER ARRANGEMENT, DECORATIVEMax length: 70 |
| Intended use codeAPHIS mandatory (missing code rejects under APH_GLOBAL_002). The post states the purpose; JFS maps it.aphis[].intendedUseCode | PG01 | Mandatory | Post gives facts, JFS codes them | 210.000Max length: 16 |
| Scientific genusMandatory for category types AP0100, AP0400, AP0500, AP0600, AP0800, AP1000 and AP0700 codes 705, 708, 709, 712, 713, 714, 720, 723, 724, or when stated on the LPCO.aphis[].scientificOrigins[].scientificName.genus | PG05 | If it applies | Post / seller | EXAMPLEGENUSMax length: 22 |
| Scientific speciesSame condition as genus.aphis[].scientificOrigins[].scientificName.species | PG05 | If it applies | Post / seller | EXAMPLESPECIESMax length: 22 |
| Source countryCountry where the harvest, growth, production, processing or catch took place, per the source type code; not necessarily the CBP country of origin.aphis[].scientificOrigins[].originInfo.countryCode | PG06 | Mandatory | Post / seller | XXMax length: 2 |
| LPCO issuer locationRequired with any LPCO (e.g. a foreign phytosanitary certificate): issuer geographic qualifier and location.aphis[].lpcoIssuers[].issuerLocation | PG13 | If it applies | Post / seller | XXMax length: 3 |
| LPCO typeCertificate or permit type when the commodity needs one. E.g. A01 phytosanitary certificate (foreign).aphis[].lpcoIssuers[].lpcos[].type | PG14 | If it applies | Post gives facts, JFS codes them | A01Max length: 3 |
| LPCO numberCertificate or permit number - must be real.aphis[].lpcoIssuers[].lpcos[].number | PG14 | If it applies | Post / seller | TESTONLYMax length: 33 |
| LPCO date and qualifierDate with its qualifier (dateQualifier).aphis[].lpcoIssuers[].lpcos[].date | PG14 | If it applies | Post / seller | 2026-09-20 |
| Common name (specific)APHIS mandatory; one per product and per component.aphis[].scientificOrigins[].commonName.specific | PG17 | Mandatory | Post / seller | DRIED ROSEMax length: 30 |
| Entity role codeAlways required: UC (ultimate consignee) and CB (broker), or IM when no broker is used. LAP when any LPCO is reported in PG13/14; APD for veterinary biologics A6A; DFI for AP0800 cut flowers; AG1 for OGCP plant cuttings. Producer/grower/manufacturer or consolidator (AG1, DFI, RCH, MF, GD, PCK, CR, PRO) for AP0400/AP0500/AP0600 and AP0700 705/708/709/712/713/714/723/724 (warning level). DEQ and SLA also allowed.aphis[].entities[].roleCode | PG19 | Mandatory | Post gives facts, JFS codes them | MFMax length: 3 |
| APHIS grower (AG1)Required only for AP0400 plant cuttings (404) in the Offshore Greenhouse Certification Program.aphis[].entities[].name | PG19 | If it applies | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Entity nameAPHIS mandatory.aphis[].entities[].name | PG19 | Mandatory | Post gives facts, JFS codes them | ACME MANUFACTURING COMax length: 32 |
| Entity address line 1APHIS mandatory.aphis[].entities[].address1 | PG19 | Mandatory | Post gives facts, JFS codes them | 1 EXAMPLE ROADMax length: 23 |
| Entity cityAPHIS mandatory.aphis[].entities[].locations[].city | PG20 | Mandatory | Post gives facts, JFS codes them | EXAMPLE CITYMax length: 21 |
| Entity countryAPHIS mandatory.aphis[].entities[].locations[].country | PG20 | Mandatory | Post gives facts, JFS codes them | XXMax length: 2 |
| Net quantity (packaging record)APHIS mandatory PG26: up to three quantity/UOM pairs of total net quantity; UOM rules depend on the PG10 category.aphis[].packagingDetails[].quantity | PG26 | Mandatory | Post / seller | 0.5 |
| Unit of measure (packaging record)See packaging-quantity.aphis[].packagingDetails[].unitOfMeasure | PG26 | Mandatory | Post / seller | KGMax length: 5 |
| Inspection status, arrival date and locationAPHIS mandatory PG30: status A (anticipated arrival) with arrival date and Schedule D port code, always; add I (Plant Inspection Station location) for AP0400 propagative material going to a PIS, or P for a precleared shipment (UN/LOCODE). Only A, P, I are accepted. PayCBP v4 aphis has no PG30 (laboratoryTests) field. | PG30 | Mandatory | Post gives facts, JFS codes them | A |
| Commodity routing (type 198 + country)APHIS mandatory: the country where routing to the US began (code 198), plus transit countries when the LPCO shows them. PayCBP v4 aphis has no PG32 (commodityRoutes) field. | PG32 | Mandatory | Post / seller | 198 |
| Original paper certificateHealth (A02) and meat/sanitary (A03) certificates: original paper required at arrival. Phytosanitary certificate (A01): filer uploads it to ACE DIS; the original may still be requested. Ship the original with the parcel and give the filer a copy. Not a data field. | doc | If it applies | Post / seller |
Lacey Act
USDA APHIS Lacey Act (plants and wood)
Send agency data"May be required" flags: AL1"Required" flags: AL2
What it is
The Lacey Act bans trade in illegally harvested plants and wood. Importers must declare the species and the country where the plant was harvested.
AL1 can be disclaimed. G (de minimis) is allowed only when plant material is at most 5% of the item's weight and at most 2.9 kg per line, and never for protected species.
Customs does not reject a type 13 entry for a missing Lacey declaration, but the legal duty to declare still applies.
Common products
| Wooden chopsticks | 4419.12.0000 | AL2 required |
| Acoustic guitar, spruce top | 9202.90.4000 | AL1 disclaimed by default (A) |
| Solid wood cutting board | 4419.90 | Typical AL2 item |
Also typical: Wooden kitchen tools, furniture, picture frames, wooden toys, bamboo and rattan goods, paper products, musical instruments, charcoal.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | SOLID WOOD CUTTING BOARD |
| Detailed description | Mandatory | Post / seller | CUTTING BOARD, SOLID WOOD, 30 CM |
| Name of each part made of plant material | Mandatory | Post / seller | WOOD BOARD |
| Quantity of plant material in the whole shipment | Mandatory | Post / seller | 0.8 |
| Unit: weight, area or volume. Never pieces. | Mandatory | Post / seller | KG |
| Scientific genus (Latin, not a trade name) | Mandatory | Post / seller | QUERCUS |
| Scientific species (no "spp.") | Mandatory | Post / seller | RUBRA |
| Country of harvest (where the tree was cut, not where the item was made) | Mandatory | Post / seller | If unknown, list every possible country |
| Value of the wood or plant products, whole USD | Mandatory | Post / seller | 32 |
| Percent recycled | If it applies | Post / seller | Paper products only |
Full field list · AL2(12)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description of the customs line (not the HTS text).aphis[].commercialDescription | OI | Mandatory | Post / seller | SOLID WOOD CUTTING BOARDMax length: 70 |
| PGA line descriptionMore detailed description of the product than the OI.aphis[].commodityCharacteristics[].description | PG10 | Mandatory | Post / seller | CUTTING BOARD, SOLID WOOD, 30 CMMax length: 57 |
| Name of the constituent element (plant component)Name of the article or component containing plant material; PG04 repeats per component.aphis[].constituentElements[].name | PG04 | Mandatory | Post / seller | WOOD BOARDMax length: 51 |
| Quantity of plant materialTotal quantity of plant material in the shipment (not per item), for each genus/species/country-of-harvest combination. PG14 is deprecated for Lacey - quantity goes here.aphis[].constituentElements[].quantity | PG04 | Mandatory | Post / seller | 0.8 |
| Unit of measure (plant material)Weight, area or volume unit (G, KG, M2, M3, L ...); piece, number, count and board feet are not accepted.aphis[].constituentElements[].unitOfMeasure | PG04 | Mandatory | Post / seller | KGMax length: 5 |
| Unknown species/source flagY when the species or country of harvest is unknown and several PG05/PG06 are listed.aphis[].constituentElements[].activeIngredientQualifier | PG04 | If it applies | Post / seller | YMax length: 1 |
| Percent recycled materialPaper and paperboard only (4 implied decimals).aphis[].constituentElements[].percent | PG04 | If it applies | Post / seller | 0500000Max length: 7 |
| Scientific genusFirst word of the Latin name (GRIN taxonomy), or SPECIAL with a special use designation. Not a trade name. Repeat PG05/PG06 for each species and country of harvest.aphis[].scientificOrigins[].scientificName.genus | PG05 | Mandatory | Post / seller | QUERCUSMax length: 22 |
| Scientific speciesSecond word of the Latin name, or the SUD (e.g. SPF, COMPOSITE, RECYCLED). Abbreviations and "spp." are not accepted.aphis[].scientificOrigins[].scientificName.species | PG05 | Mandatory | Post / seller | RUBRAMax length: 22 |
| Country of harvestWhere the plant was taken, cut or logged - not the country of origin or manufacture. If unknown, list every possible country (XZ after five).aphis[].scientificOrigins[].originInfo.countryCode | PG06 | Mandatory | Post / seller | XXMax length: 2 |
| PGA line value (USD)Value of the Lacey-regulated products on the HTS line, whole US dollars.aphis[].lotNumbers[].pgaLineValue | PG25 | Mandatory | Post / seller | 32 |
| Lacey product component (PayCBP program record)Name of the plant component; PayCBP's LaceyAct record requires it whenever aphis[].laceyAct is sent (not a CATAIR element).aphis[].laceyAct.productComponent | v4 | Mandatory | Post / seller | WOOD BOARD |
AMS
USDA Agricultural Marketing Service
Send agency data"May be required" flags: AM1 AM3 AM7"Required" flags: AM2 AM4 AM6 AM8
What it is
AMS enforces quality and marketing rules for farm products: organic certification, marketing orders (nuts, dried fruit, some fresh produce), peanuts and eggs.
AM7 (organic) appears on almost every food. The API disclaims it by default with A, which means "not sold as USDA Organic". If the product IS sold as organic, it needs an organic import certificate, which this mail route cannot carry today: contact JFS.
Marketing orders and peanuts cannot be disclaimed. A small quantity can be reported as exempt.
Common products
| Honey, mushrooms, crisps, dog food, seeds | various | AM7 disclaimed by default (A) |
| Shelled hazelnuts | 0802.22 | Typical marketing order item (AM4) |
| Roasted peanuts | 2008.11 | Typical peanut item (AM6) |
Also typical: Walnuts, almonds, pistachios, raisins, dates, prunes, olives, onions, potatoes, citrus, kiwifruit, anything labelled "organic".
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | SHELLED HAZELNUTS, RETAIL PACK |
| Is it sold as organic? If yes: organic import certificate number | If it applies | Post / seller | NOP certificate number |
| Net weight | Mandatory | Post / seller | 0.5 KG |
| Purpose (human food or processing) | If it applies | Post gives facts, JFS codes them | Human food |
| Peanuts: where the goods will be stored after release | If it applies | Post gives facts, JFS codes them | Warehouse name and address |
Full field list · AM4(7)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 3
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.ams[].commercialDescription | OI | Mandatory | Post / seller | SHELLED HAZELNUTS, RETAIL PACKMax length: 70 |
| Processing code (message number)The message use case as a digit "1"-"8": 1 inspection request, 2 previously inspected, 3 exempt per SC-6, 4 exemption request, 5 pistachio aflatoxin, 6 exempt type/variety, 7 seasonal exemption, 8 minimum-weight exemption (typical for a parcel). No disclaimer is accepted.ams[].governmentAgencyProcessingCode | PG01 | Mandatory | Post gives facts, JFS codes them | 8Max length: 3 |
| Intended use codeMandatory for MO1, MO3, MO4 and MO5 (230.000 consumer use as human food, 250.000 commercial processing).ams[].intendedUseCode | PG01 | If it applies | Post gives facts, JFS codes them | 230.000Max length: 16 |
| UNSPSC product classificationQualifier UNS + 8-digit UNSPSC; mandatory for MO1, MO4, MO6. PayCBP v4 ams has no PG02 (products) field. | PG02 | If it applies | Post gives facts, JFS codes them | TESTONLY |
| Commodity descriptionUsed by the inspection message sets.ams[].commodityCharacteristics[].description | PG10 | If it applies | Post / seller | SHELLED HAZELNUTSMax length: 57 |
| Net weight and unitMandatory for MO8 (net weight at or below the minimum-quantity exemption, KG or LB, two decimals) and used by MO1, MO2, MO5, MO6. PayCBP v4 ams has no PG29 field. | PG29 | If it applies | Post / seller | 0.5 KG |
| Estimated arrival dateNeeded for seasonal (MO7) determinations. PayCBP v4 ams has no PG30 field. | PG30 | If it applies | Post gives facts, JFS codes them |
Full field list · AM6(7)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 1
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.ams[].commercialDescription | OI | Mandatory | Post / seller | ROASTED PEANUTS, RETAIL PACKMax length: 70 |
| Intended use code230.000 for consumer use as human food.ams[].intendedUseCode | PG01 | Mandatory | Post gives facts, JFS codes them | 230.000Max length: 16 |
| Commodity descriptionCommercial description of the product.ams[].commodityCharacteristics[].description | PG10 | Mandatory | Post / seller | ROASTED IN-SHELL PEANUTSMax length: 57 |
| Location of goods name (LG)Name of the company or facility holding the product after release (LG); required with the LG address.ams[].entities[].name | PG19 | Mandatory | Post gives facts, JFS codes them | EXAMPLE WAREHOUSEMax length: 32 |
| Product location after release (LG)Where the product will be before it enters the supply chain.ams[].entities[].address1 | PG19 | Mandatory | Post gives facts, JFS codes them | 1 EXAMPLE ROADMax length: 23 |
| City, state, postal code for AP1 and LGOne PG20 for each of AP1 and LG: city (entities[].locations[].city), state (.stateProvince) and postal code (.postalCode), all mandatory.ams[].entities[].locations[].city | PG20 | Mandatory | Post gives facts, JFS codes them | EXAMPLE CITYMax length: 21 |
| Net weight and unitTotal net weight, two implied decimals. PayCBP v4 ams has no PG29 field. | PG29 | Mandatory | Post / seller | 0.5 KG |
Full field list · AM8(4)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 2
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.ams[].commercialDescription | OI | Mandatory | Post / seller | CERTIFIED ORGANIC BLACK TEA, RETAIL PACKMax length: 70 |
| NOP import certificate number (or special code)Electronic NOP import certificate issued before the shipment leaves the port of export, or the OR2 special code for personal goods/e-commerce. PayCBP v4 ams has no lpcoIssuers field, so this cannot be transmitted today. | PG14 | Mandatory | Post / seller | NNN-NNNNNNNNNN-NNNNNNMax length: 33 |
| Lot numberShipment lot numbers (OR2).ams[].lotNumbers[].number | PG25 | If it applies | Post / seller | TESTONLYMax length: 25 |
| Net weight (KG)Mandatory for OR message sets. PayCBP v4 ams has no PG29 field. | PG29 | Mandatory | Post / seller | 0.25 KG |
CPSC
Consumer Product Safety Commission
Send agency data"May be required" flags: CP1"Required" flags: CP2
What it is
CPSC sets safety rules for consumer products, especially products for children under 12.
From 22 October 2026, a regulated product sent by mail needs an electronic safety certificate. The certifier must also enter it in CPSC's Product Registry before the parcel arrives.
The short route is a reference to a certificate already in the Product Registry. The long route sends the full certificate data.
Common products
| Plastic baby rattle | 9503.00.0071 | CP2 required |
| Bicycle helmet | 6506.10 | Typical CP2 item |
Also typical: Toys, children's clothing and sleepwear, cribs, strollers, ride-ons, bicycles, children's jewellery, mattresses, lighters, products with button batteries.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | PLASTIC BUILDING BLOCK TOY SET |
| Short route: Product Registry product ID, certificate version and certifier ID | If it applies | Post gives facts, JFS codes them | From the Product Registry |
| Long route: product ID (barcode, SKU or model number) | If it applies | Post / seller | GTIN 0012345678905 |
| Product name (max 15 characters, not the SKU) | If it applies | Post / seller | BLOCK SET |
| Month and year made | If it applies | Post / seller | 06 2026 |
| Is it certified? Yes / no | If it applies | Post gives facts, JFS codes them | Yes |
| Lab testing: tested or not, and the test date | If it applies | Post / seller | Tested 2026-06-15 |
| Manufacturer, certifier, lab and records contact: name, address, phone, email | If it applies | Post gives facts, JFS codes them | Lab: 4-digit CPSC lab ID |
| Safety rules the product is certified to | If it applies | Post gives facts, JFS codes them | Toy safety standard |
Full field list · CP2(38)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial DescriptionClear English description of the line (IG examples: BICYCLE HELMETS, CHILDRENS PUZZLE).cpsc[].commercialDescription | OI | Mandatory | Post / seller | PLASTIC BUILDING BLOCK TOY SETMax length: 70 |
| Globally Unique Product Identification Code QualifierSRV (GTIN) or AI (UPC). Product identification route A; one of routes A (PG01 GTIN/UPC), B (PG02 SKU) or C (PG07 item identity number) is required on a full set.cpsc[].productIdentifierQualifier | PG01 | If it applies | Post / seller | SRVMax length: 4 |
| Globally Unique Product Identification CodeThe GTIN or UPC itself, paired with the qualifier.cpsc[].productIdentifier | PG01 | If it applies | Post / seller | NNNNNNNNNNNNNNMax length: 19 |
| Intended Use CodeMandatory on a disclaim; optional on REF and full sets. Disclaim B: 130.006 only. Disclaim A: CPSC's list is 081.XXX, 090.XXX, 100.XXX, 130.XXX except 130.001-.005, 155.XXX, 940.XXX, 970.XXX, or 980.000 with a description (other Appendix R codes may be used). Full sets: consumer products use 130.000-130.006.cpsc[].intendedUseCode | PG01 | If it applies | Post / seller | 130.006Max length: 16 |
| Intended Use DescriptionRequired with intended use code 980.000 (on a disclaim too). 21 characters (PG01 positions 58-78; CATAIR 21X - CATAIR's change log corrected a stale 22X); IG v2.5's 22X on pp.12/15 conflicts with its own positions.cpsc[].intendedUseDescription | PG01 | If it applies | Post / seller | EXAMPLE OTHER USEMax length: 21 |
| DisclaimerDisclaim path only: A (no applicable CPSC rule, outside CPSC jurisdiction, component part, upholstered furniture under part 1640 only, personal-use item reimported after repair, consumer-to-consumer gift) or B (CPSC enforcement discretion; intended use 130.006). CATAIR generally bars disclaimers on 'Must Be' (R) flags and CPSC names no CP2 exception, so PayCBP offers it for CP1 only. The post's declaration - never defaulted.cpsc[].disclaimerCode | PG01 | If it applies | Post / seller | A |
| Product Code Number (1st)REF: the Product Registry product ID. Full sets: the SKU.cpsc[].products[].productCode1.number | PG02 | If it applies | Post / seller | TESTONLYMax length: 19 |
| Product Code Number (2nd)REF only: the certificate version in the Product Registry.cpsc[].products[].productCode2.number | PG02 | If it applies | Post / seller | TESTONLYMax length: 19 |
| Certifier ID (LPCO Number (or Name))Mandatory on REF: the Certifier ID the importer sets when it creates its Product Registry Business Account (generally cannot be changed once set); it must be the account that holds the PRI/PRIV certificate. For mail the importer is a party eligible to make entry (owner, purchaser, consignee or authorized broker); CPSC will not typically treat a consumer receiving goods for personal use as the importer. PayCBP carries it as cpsc[].certifierId.cpsc[].certifierId | PG14 | If it applies | Post gives facts, JFS codes them | TESTONLYMax length: 33 |
| Trade Name/Brand NameOptional brand name; overflow to PG60 TBN.cpsc[].tradeBrand.name | PG07 | If it applies | Post / seller | EXAMPLE BRANDMax length: 35 |
| Product Name (Model)Mandatory product name (max 15), e.g. a short marketing name - not the SKU or model number. Overflow to PG60 PMN.cpsc[].tradeBrand.model | PG07 | If it applies | Post / seller | BLOCK SETMax length: 15 |
| Manufacture Month and YearMandatory MMCCYY on the flat file; in v4 tradeBrand.month and tradeBrand.year (this row points at year; month is required with it).cpsc[].tradeBrand.year | PG07 | If it applies | Post / seller | 2026 |
| Item Identity Number QualifierMN model number, SE serial, RN registered number or ALT alternate identifier (route C).cpsc[].tradeBrand.qualifier | PG07 | If it applies | Post / seller | MNMax length: 3 |
| Item Identity NumberThe identifier for the qualifier above.cpsc[].tradeBrand.number | PG07 | If it applies | Post / seller | TESTONLYMax length: 17 |
| Commodity Characteristic QualifierOptional: MC model colour, MD model description, MS model style.cpsc[].commodityCharacteristics[].qualifier | PG10 | If it applies | Post / seller | MDMax length: 4 |
| Commodity Characteristic DescriptionRequired when a characteristic qualifier is sent.cpsc[].commodityCharacteristics[].description | PG10 | If it applies | Post / seller | BUILDING BLOCK SETMax length: 57 |
| Entity Role CodeCE certifying entity (only if the IOR is not certifying), MF manufacturer, ITL CPSC-accepted lab, LAB other lab, NOL no lab testing required, PK records contact (only if not the IOR). A full set needs an MF and at least one lab option; FCP admits ITL only.cpsc[].entities[].roleCode | PG19 | If it applies | Post gives facts, JFS codes them | MFMax length: 3 |
| Entity Identification CodeSBM only, and only for a manufacturer with a small batch manufacturer testing exclusion.cpsc[].entities[].identificationCode | PG19 | If it applies | Post / seller | SBMMax length: 3 |
| CPSC Lab ID or Small Batch Manufacturer Registry ID (Entity Number)Mandatory 4-digit CPSC Lab ID for ITL; SBM registry ID for MF with SBM; blank otherwise.cpsc[].entities[].number | PG19 | If it applies | Post / seller | NNNNMax length: 15 |
| Entity NameMandatory for CE, LAB, MF and PK; overflow to PG60 ENA.cpsc[].entities[].name | PG19 | If it applies | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Entity Address 1Mandatory for CE, LAB, MF and PK unless "GPS" is sent with PG60 LAT/LON; blank for ITL and NOL. 23 characters (PG19 positions 58-80; CATAIR 23X) - IG v2.5's printed '24X' conflicts with its own positions. Overflow to PG60 AD1.cpsc[].entities[].address1 | PG19 | If it applies | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Entity Address 2Optional address line 2.cpsc[].entities[].locations[].address2 | PG20 | If it applies | Post / seller | BUILDING 4Max length: 32 |
| Entity Apartment Number/Suite NumberOptional apartment/suite.cpsc[].entities[].locations[].apartmentSuiteNumber | PG20 | If it applies | Post / seller | 301Max length: 5 |
| Entity CityRequired with PG20 (CE, LAB, MF, PK); overflow to PG60 ECI.cpsc[].entities[].locations[].city | PG20 | If it applies | Post / seller | EXAMPLE CITYMax length: 21 |
| Entity State/ProvinceMandatory for US, Canada and Mexico; optional otherwise.cpsc[].entities[].locations[].stateProvince | PG20 | If it applies | Post / seller | XXMax length: 3 |
| Entity CountryISO country code.cpsc[].entities[].locations[].country | PG20 | If it applies | Post / seller | XXMax length: 2 |
| Entity Zip/Postal CodeMandatory for US and Canada; optional otherwise.cpsc[].entities[].locations[].postalCode | PG20 | If it applies | Post / seller | 12345Max length: 9 |
| Telephone Number of the EntityPhone of the CE, LAB, MF or PK; overflow to PG60 TEL.cpsc[].entities[].contacts[].phoneNumber | PG21 | If it applies | Post / seller | +00 0000 0000Max length: 15 |
| Email Address for the EntityEmail of the CE, LAB, MF or PK; overflow to PG60 EMA.cpsc[].entities[].contacts[].emailOrFax | PG21 | If it applies | Post / seller | contact@example.comMax length: 35 |
| Product Certificate Indicator (Declaration Code)Mandatory: CPY (yes) or CPN (no) - the certifying entity's certification. Every other PG22 element is not applicable.cpsc[].conformanceDeclarations[].declarationCode | PG22 | If it applies | Post gives facts, JFS codes them | CPYMax length: 4 |
| Lot Number QualifierOptional: 1 manufacturer, 2 seller.cpsc[].lotNumbers[].qualifier | PG25 | If it applies | Post / seller | 1 |
| Lot NumberRequired if a lot qualifier is sent.cpsc[].lotNumbers[].number | PG25 | If it applies | Post / seller | TESTONLYMax length: 25 |
| Production Start Date of the LotOptional.cpsc[].lotNumbers[].productionStartDate | PG25 | If it applies | Post / seller | 2026-06-01 |
| Production End Date of the LotOptional.cpsc[].lotNumbers[].productionEndDate | PG25 | If it applies | Post / seller | 2026-06-10 |
| Inspection/Laboratory Testing StatusMandatory: L lab testing previously performed, N no laboratory testing performed. Sent before all PG19s; latest test date when several labs.cpsc[].laboratoryTests[].laboratoryTestingStatus | PG30 | If it applies | Post / seller | L |
| Date of Previous Inspection/Laboratory TestingRequired with status L.cpsc[].laboratoryTests[].eventDate | PG30 | If it applies | Post / seller | 2026-06-15 |
| Additional Information Qualifier CodeCIT citation (mandatory after each ITL/LAB/NOL PG19, one per rule certified to or excluded from); CP1-CP4 lab report ID/URL/access key/component part (PG60 qualifiers, unrelated to the ACE flags); LAT/LON; overflow codes.cpsc[].additionalInformation[].qualifierCode | PG60 | If it applies | Post gives facts, JFS codes them | CITMax length: 3 |
| Additional InformationWith CIT, the rule from CPSC's Citation Codes table.cpsc[].additionalInformation[].description | PG60 | If it applies | Post / seller | (CPSC citation code)Max length: 73 |
FWS
U.S. Fish and Wildlife Service
Send agency data"May be required" flags: FW1 FW3"Required" flags: FW2
What it is
FWS clears every import of wildlife: live animals, and parts or products made from them. It enforces CITES and the U.S. Endangered Species Act.
FW1 can be disclaimed with E, which means "contains no fish or wildlife". The importer must be able to prove it.
FW3 always needs FWS clearance. E is not allowed on FW3 and refuses the parcel.
Common products
| Python-skin handbag | 4202.21.3000 | FW3 required |
| Sunscreen SPF 50 | 3304.99.5000 | FW1 disclaimed by default (E) |
| Seashell and coral jewellery | 7117.90 | Typical FWS item |
Also typical: Snake, crocodile and ostrich leather, feathers, bone or horn carvings, furs, taxidermy, cosmetics with snail or fish ingredients.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | HANDBAG, PYTHON SKIN LEATHER |
| Purpose of import | Mandatory | Post gives facts, JFS codes them | Personal / commercial |
| Scientific genus and species | Mandatory | Post / seller | PYTHON RETICULATUS |
| Type of wildlife product | Mandatory | Post gives facts, JFS codes them | Leather product |
| Country where the animal was taken or born | Mandatory | Post / seller | ID (high seas = ZZ) |
| Source: wild, captive-bred or ranched | Mandatory | Post / seller | Captive-bred |
| Common name | Mandatory | Post / seller | RETICULATED PYTHON |
| Number of cartons containing wildlife | Mandatory | Post / seller | 1 |
| Foreign exporter name and address | Mandatory | Post / seller | Outside the U.S. |
| Value, whole USD | Mandatory | Post / seller | 300 |
| Quantity and unit | Mandatory | Post / seller | 1 piece |
| CITES permit number | If it applies | Post / seller | The original must also go to FWS |
Full field list · FW2(20)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 3
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.fws[].commercialDescription | OI | Mandatory | Post / seller | LEATHER BELT, BOVINEMax length: 70 |
| Intended use code (FWS purpose)Only the codes aligned to a Form 3-177 purpose code; one per entry. Commercial (010.000, 130.035, 230.000, 250.000, 920.003), biomedical and traveling-exhibition codes also need the FWL licence.fws[].intendedUseCode | PG01 | Mandatory | Post gives facts, JFS codes them | 100.008Max length: 16 |
| Scientific genusGenus of the animal or part/product; repeated only for hybrids.fws[].scientificOrigins[].scientificName.genus | PG05 | Mandatory | Post / seller | BOSMax length: 22 |
| Scientific speciesSpecies.fws[].scientificOrigins[].scientificName.species | PG05 | Mandatory | Post / seller | TAURUSMax length: 22 |
| Scientific subspeciesWhen needed to tell whether the taxon is protected.fws[].scientificOrigins[].scientificName.subSpecies | PG05 | If it applies | Post / seller | Max length: 18 |
| FWS description codeFWS wildlife description code (Appendix PGA); hybrid suffixes A100/A103.fws[].scientificOrigins[].scientificName.fwsDescriptionCode | PG05 | Mandatory | Post gives facts, JFS codes them | Max length: 7 |
| Species country of originWhere the animal was taken from the wild or born (ZZ for high seas) - may differ from the goods' country of origin.fws[].scientificOrigins[].originInfo.countryCode | PG06 | Mandatory | Post / seller | XXMax length: 2 |
| FWS source codeW wild, R ranched, F, C captive-bred, P-2 pre-convention, U-6 unknown, I, D, X. PayCBP v4 fws has no PG10 field. | PG10 | Mandatory | Post / seller | C |
| Foreign CITES document (FWF)Conditional on species/CITES listing; the original must still go to FWS. U.S. permits (FWP, FWU) and port exception (DPE) are also PG14 types.fws[].lpcoIssuers[].lpcos[].type | PG14 | If it applies | Post / seller | FWFMax length: 3 |
| Common name (general)General common name.fws[].scientificOrigins[].commonName.general | PG17 | Mandatory | Post / seller | CATTLEMax length: 30 |
| Common name (specific)Specific common name.fws[].scientificOrigins[].commonName.specific | PG17 | If it applies | Post / seller | DOMESTICMax length: 30 |
| Live venomous wildlifeLive wildlife (description code LIV) only.fws[].scientificOrigins[].commonName.venomous | PG17 | If it applies | Post / seller | false |
| Cartons containing wildlifeTotal per entry.fws[].scientificOrigins[].commonName.cartonsContainingWildlife | PG17 | Mandatory | Post / seller | 1 |
| FWS foreign exporter (FWE)One FWE per entry with a non-US address (name, address1, city, country).fws[].entities[].name | PG19 | Mandatory | Post / seller | ACME MANUFACTURING COMax length: 32 |
| FWS foreign exporter address line 1Outside the US.fws[].entities[].address1 | PG19 | Mandatory | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| FWS foreign exporter cityOutside the US.fws[].entities[].locations[].city | PG20 | Mandatory | Post / seller | EXAMPLE CITYMax length: 21 |
| FWS foreign exporter countryNot US.fws[].entities[].locations[].country | PG20 | Mandatory | Post / seller | XXMax length: 2 |
| PGA line value (USD)Whole dollars.fws[].lotNumbers[].pgaLineValue | PG25 | Mandatory | Post / seller | 45 |
| Net quantity and unitUnit (NO, CM, G, KG, L, ...) and quantity of the FWS line. PayCBP v4 fws has no PG29 field. | PG29 | Mandatory | Post / seller | 1 NO |
| Arrival date and inspection locationStatus I, arrival date and bonded inspection location. PayCBP v4 fws has no PG30 field. | PG30 | Mandatory | Post gives facts, JFS codes them |
NMFS
NOAA Fisheries (National Marine Fisheries Service)
Send agency data"May be required" flags: NM1 NM3 NM5"Required" flags: NM2 NM4 NM6 NM8
What it is
NMFS traces seafood to stop illegal and mislabelled fishing and to protect dolphins and endangered species.
Every NMFS program needs the U.S. importer's International Fisheries Trade Permit, which is rare for mail. Most seafood parcels need a formal entry in practice.
Programs: tuna tracking, Antarctic toothfish, highly migratory species (bluefin tuna, swordfish), and the Seafood Import Monitoring Program (SIMP).
Common products
| Frozen peeled shrimp, 1 kg | 0306.17.0041 | NM8 required. Also refused because of the State Dept shrimp rule. |
| Canned tuna | 1604.14 | Typical tuna tracking item |
| Frozen fish fillet | 0304 | Typical SIMP item |
Also typical: Cod, crab, sea cucumber, abalone, red snapper, swordfish, Chilean sea bass.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | FROZEN FISH FILLET, RETAIL PACK |
| Species code (FAO 3-letter code) | Mandatory | Post / seller | COD |
| Wild-caught or farmed | If it applies | Post gives facts, JFS codes them | Wild capture |
| Harvest country and ocean area | If it applies | Post / seller | ZZ = high seas |
| Fishing gear type | If it applies | Post / seller | Longline |
| Vessel flag and name, landing date, product form | If it applies | Post / seller | Fishing vessel's country |
| Catch document numbers | If it applies | Post gives facts, JFS codes them | Tuna, toothfish, bluefin |
Full field list · NM2(9)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 2
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.nmfs[].commercialDescription | OI | Mandatory | Post / seller | FROZEN FISH FILLET, RETAIL PACKMax length: 70 |
| Processing code370: YFT if the product contains yellowfin tuna, else NOT. AMR: fresh or frozen indicator.nmfs[].governmentAgencyProcessingCode | PG01 | If it applies | Post gives facts, JFS codes them | NOTMax length: 3 |
| Harvest source type370/HMS: HRV. SIM: HCF wild capture, HBA aquaculture, SVH small-vessel aggregated harvest (one PG06 per SIM line).nmfs[].scientificOrigins[].originInfo.sourceTypeCode | PG06 | Mandatory | Post gives facts, JFS codes them | HCFMax length: 3 |
| Harvest country (ZZ for high seas)Country (or its waters) where the harvest took place; ZZ for international waters.nmfs[].scientificOrigins[].originInfo.countryCode | PG06 | If it applies | Post / seller | ZZMax length: 2 |
| Geographic location of harvestOcean area code (Appendix PGA) or a more specific FAO area.nmfs[].scientificOrigins[].originInfo.geographicLocation | PG06 | If it applies | Post / seller | TESTONLYMax length: 20 |
| Fishing gear typeGear code (PS, PL, LL, GN, DN, ...) for wild capture.nmfs[].scientificOrigins[].originInfo.processingTypeCode | PG06 | If it applies | Post / seller | LLMax length: 5 |
| Yellowfin / fresh-frozen category370: category NM1 + YFT/NOT; AMR: commodity qualifier FRZ/FRE, mandatory for all toothfish. PayCBP v4 nmfs has no PG10 field. | PG10 | If it applies | Post gives facts, JFS codes them | YFT |
| Documents (370 form, catch documents)370: document 877 (NOAA Form 370) and section 5 box; HMS/AMR: catch or statistical document identifiers. Images go to DIS. PayCBP v4 nmfs has no PG22 field. | PG22 | If it applies | Post / seller | 877 |
| Harvesting vessel flag (VCR)Characteristic type VCR with the ISO flag country; SIM wild-capture also VNM (vessel name) and weight.nmfs[].harvestVessels[].characteristic | PG31 | Mandatory | Post / seller | XXMax length: 35 |
Full field list · NM4(5)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 2
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.nmfs[].commercialDescription | OI | Mandatory | Post / seller | FROZEN FISH FILLET, RETAIL PACKMax length: 70 |
| Processing code370: YFT if the product contains yellowfin tuna, else NOT. AMR: fresh or frozen indicator.nmfs[].governmentAgencyProcessingCode | PG01 | If it applies | Post gives facts, JFS codes them | NOTMax length: 3 |
| Catch / statistical document (NM5, NM2)HMS: NM5 = ICCAT eBCD / eBCD re-export number, Atlantic bluefin only (transaction type 1); other HMS catch/statistical/re-export documents go in PG22 with the document number in Compliance Description. AMR: NM2 frozen-toothfish pre-approval (transaction 1, quantity KG).nmfs[].lpcoIssuers[].lpcos[].number | PG14 | If it applies | Post gives facts, JFS codes them | TESTONLYMax length: 33 |
| Yellowfin / fresh-frozen category370: category NM1 + YFT/NOT; AMR: commodity qualifier FRZ/FRE, mandatory for all toothfish. PayCBP v4 nmfs has no PG10 field. | PG10 | Mandatory | Post gives facts, JFS codes them | YFT |
| Documents (370 form, catch documents)370: document 877 (NOAA Form 370) and section 5 box; HMS/AMR: catch or statistical document identifiers. Images go to DIS. PayCBP v4 nmfs has no PG22 field. | PG22 | If it applies | Post / seller | 877 |
Full field list · NM6(8)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 1
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.nmfs[].commercialDescription | OI | Mandatory | Post / seller | FROZEN FISH FILLET, RETAIL PACKMax length: 70 |
| Catch / statistical document (NM5, NM2)HMS: NM5 = ICCAT eBCD / eBCD re-export number, Atlantic bluefin only (transaction type 1); other HMS catch/statistical/re-export documents go in PG22 with the document number in Compliance Description. AMR: NM2 frozen-toothfish pre-approval (transaction 1, quantity KG).nmfs[].lpcoIssuers[].lpcos[].number | PG14 | If it applies | Post gives facts, JFS codes them | TESTONLYMax length: 33 |
| Harvest source type370/HMS: HRV. SIM: HCF wild capture, HBA aquaculture, SVH small-vessel aggregated harvest (one PG06 per SIM line).nmfs[].scientificOrigins[].originInfo.sourceTypeCode | PG06 | Mandatory | Post gives facts, JFS codes them | HCFMax length: 3 |
| Harvest country (ZZ for high seas)Country (or its waters) where the harvest took place; ZZ for international waters.nmfs[].scientificOrigins[].originInfo.countryCode | PG06 | If it applies | Post / seller | ZZMax length: 2 |
| Geographic location of harvestOcean area code (Appendix PGA) or a more specific FAO area.nmfs[].scientificOrigins[].originInfo.geographicLocation | PG06 | If it applies | Post / seller | TESTONLYMax length: 20 |
| Fishing gear typeGear code (PS, PL, LL, GN, DN, ...) for wild capture.nmfs[].scientificOrigins[].originInfo.processingTypeCode | PG06 | If it applies | Post / seller | LLMax length: 5 |
| Documents (370 form, catch documents)370: document 877 (NOAA Form 370) and section 5 box; HMS/AMR: catch or statistical document identifiers. Images go to DIS. PayCBP v4 nmfs has no PG22 field. | PG22 | If it applies | Post / seller | 877 |
| Harvesting vessel flag (VCR)Characteristic type VCR with the ISO flag country; SIM wild-capture also VNM (vessel name) and weight.nmfs[].harvestVessels[].characteristic | PG31 | Mandatory | Post / seller | XXMax length: 35 |
Full field list · NM8(17)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 2
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionClear English description.nmfs[].commercialDescription | OI | Mandatory | Post / seller | FROZEN FISH FILLET, RETAIL PACKMax length: 70 |
| Other authorization to fish (NM6)Optional additional LPCO under which the fish was legally harvested (license, RFMO number).nmfs[].lpcoIssuers[].lpcos[].type | PG14 | If it applies | Post gives facts, JFS codes them | NM6Max length: 3 |
| Species 3-alpha code (FAO ASFIS)SIM: mandatory PG05 with the FAO 3-alpha species code; codes on the NMFS list need the full SIM message set.nmfs[].scientificOrigins[].scientificName.speciesCode | PG05 | Mandatory | Post / seller | XXXMax length: 7 |
| Harvest source type370/HMS: HRV. SIM: HCF wild capture, HBA aquaculture, SVH small-vessel aggregated harvest (one PG06 per SIM line).nmfs[].scientificOrigins[].originInfo.sourceTypeCode | PG06 | If it applies | Post gives facts, JFS codes them | HCFMax length: 3 |
| Harvest country (ZZ for high seas)Country (or its waters) where the harvest took place; ZZ for international waters.nmfs[].scientificOrigins[].originInfo.countryCode | PG06 | If it applies | Post / seller | ZZMax length: 2 |
| Geographic location of harvestOcean area code (Appendix PGA) or a more specific FAO area.nmfs[].scientificOrigins[].originInfo.geographicLocation | PG06 | If it applies | Post / seller | TESTONLYMax length: 20 |
| Landing / first transfer dateSIM: date first offloaded (HCF), first transferred from the facility (HBA) or landed at shore (SVH).nmfs[].scientificOrigins[].originInfo.processingStartDate | PG06 | If it applies | Post / seller | 2026-08-15 |
| Fishing gear typeGear code (PS, PL, LL, GN, DN, ...) for wild capture.nmfs[].scientificOrigins[].originInfo.processingTypeCode | PG06 | If it applies | Post / seller | LLMax length: 5 |
| Product form at landingSIM: NDR, NFL, NGG, NOT, NRD, NST, NRS, RND, HSO or PD.nmfs[].scientificOrigins[].originInfo.processingDescription | PG06 | If it applies | Post / seller | NFLMax length: 30 |
| Harvest / landing entity nameSIM: entity receiving the first landing (HCF), the aquaculture facility (HBA) or the collector at shore (SVH); role per IG list.nmfs[].entities[].name | PG19 | If it applies | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Harvest / landing entity city or regionCity or region and country.nmfs[].entities[].locations[].city | PG20 | If it applies | Post / seller | EXAMPLE CITYMax length: 21 |
| Individual qualifier + name, and phone or emailListed for all three SIM scenarios (HBA, HCF, SVH) when the species is on the 3-alpha list; qualifier and name M, phone or email one required. Name at entities[].contacts[].individualName, qualifier .individualQualifier, phone .phoneNumber, email .emailOrFax.nmfs[].entities[].contacts[].individualName | PG21 | If it applies | Post / seller | COMPLIANCE MANAGERMax length: 23 |
| Remarks text: number of small vesselsMandatory when PG06 source type is SVH. PayCBP v4 nmfs has no PG24 (remarks) field. | PG24 | If it applies | Post / seller | Max length: 68 |
| Harvesting vessel flag (VCR)Characteristic type VCR with the ISO flag country; SIM wild-capture also VNM (vessel name) and weight.nmfs[].harvestVessels[].characteristic | PG31 | If it applies | Post / seller | XXMax length: 35 |
| Harvest weight and unitSIM wild capture.nmfs[].harvestVessels[].netWeight | PG31 | If it applies | Post / seller | 1.5 |
| Routing (type 11 or 13 + country)SIM wild capture and SVH: where the fish was landed/offloaded.nmfs[].commodityRoutes[].typeCode | PG32 | If it applies | Post / seller | 11Max length: 3 |
| Quantity (aquaculture / SVH)SIM HBA and SVH scenarios. PayCBP v4 nmfs has no PG29 field. | PG29 | If it applies | Post / seller |
NHTSA
National Highway Traffic Safety Administration
Send agency data"May be required" flags: DT1"Required" flags: DT2
What it is
NHTSA makes sure vehicles and vehicle equipment meet U.S. safety standards (FMVSS). Its data is the HS-7 declaration.
DT1 can be disclaimed only when the item is not vehicle equipment at all. DT2 cannot be disclaimed.
13 equipment items are tightly regulated, including tires, helmets, brake hoses, glass, lights, seat belts and child car seats. They must carry the U.S. DOT safety marking.
Common products
| New radial car tire | 4011.10.1040 | DT2 required |
| Motorcycle helmet | 6506.10 | Typical DT2 item |
| Car headlamp | 8512.20 | Typical DT2 item |
Also typical: Brake hoses and fluid, windshields, seat belts, child car seats, wheel rims, warning triangles.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Commercial description | Mandatory | Post / seller | MOTORCYCLE HELMET, DOT MARKED |
| Type of equipment | Mandatory | Post gives facts, JFS codes them | Helmet |
| Does it carry the U.S. DOT / FMVSS safety label? | Mandatory | Post gives facts, JFS codes them | Yes |
| Brand and manufacturer name and address | If it applies | Post / seller | Required for the 13 regulated items |
| Tire or glass manufacturer code | If it applies | Post / seller | Code on the tire sidewall |
| Contact phone | If it applies | Post gives facts, JFS codes them | +66 2 000 0000 |
Full field list · DT2(17)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 3
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Commercial descriptionDescribe the article clearly.nhtsa[].commercialDescription | OI | Mandatory | Post / seller | MOTORCYCLE HELMET, DOT MARKEDMax length: 70 |
| Government agency program codeMVS motor vehicle, REI FMVSS equipment, TPE theft-prevention replacement equipment, OEI other equipment. OFF = not under NHTSA jurisdiction: full filing with HS-7 Box 8 (+871 statement), or (DT1 only) disclaimer A.nhtsa[].governmentAgencyProgramCode | PG01 | Mandatory | Post gives facts, JFS codes them | REIMax length: 3 |
| Trade name / makeMake of a vehicle, and fabricating manufacturer or brand for the 13 FMVSS equipment items (REI); optional for OEI, TPE.nhtsa[].tradeBrand.name | PG07 | If it applies | Post / seller | EXAMPLE MAKEMax length: 35 |
| ModelMandatory for motor vehicles only; optional for equipment.nhtsa[].tradeBrand.model | PG07 | If it applies | Post / seller | TESTONLYMax length: 15 |
| Manufacture yearMonth and year of manufacture; mandatory for vehicles under HS-7 box 1. (Model year is PG10 V06, not this field.)nhtsa[].tradeBrand.year | PG07 | If it applies | Post / seller | 2026 |
| Manufacture monthSee manufacture-year.nhtsa[].tradeBrand.month | PG07 | If it applies | Post / seller | 6 |
| Item identity number qualifierAKG (VIN, mandatory for vehicles), MN model number, SE serial, ENN engine number.nhtsa[].tradeBrand.qualifier | PG07 | If it applies | Post / seller | SEMax length: 3 |
| Item identity numberVIN for vehicles; optional for equipment.nhtsa[].tradeBrand.number | PG07 | If it applies | Post / seller | TESTONLYMax length: 17 |
| Category codeCode under the category type (e.g. the REI equipment item; OFF1 under OFFTYP). PayCBP v4 has no field. | PG10 | Mandatory | Post gives facts, JFS codes them | TESTONLY |
| Model year (commodity qualifier V06)Mandatory for all vehicles, as PG10 qualifier V06 (CCYY). PayCBP v4 has no field. | PG10 | If it applies | Post / seller | 2026 |
| Drive side (V01)Vehicles under HS-7 box 2B or 3 only. PayCBP v4 has no field. | PG10 | If it applies | Post / seller | L |
| Fabricating manufacturer nameMandatory for vehicles and the 13 FMVSS equipment items; name and address mandatory when no identification code is given.nhtsa[].entities[].name | PG19 | If it applies | Post / seller | ACME MANUFACTURING COMax length: 32 |
| Fabricating manufacturer address line 1See fm-name.nhtsa[].entities[].address1 | PG19 | If it applies | Post / seller | 1 EXAMPLE ROADMax length: 23 |
| Fabricating manufacturer city / countryRemainder of the address (city, country, postal) on PG20.nhtsa[].entities[].locations[].country | PG20 | If it applies | Post / seller | XXMax length: 2 |
| Tire / glazing manufacturer codeTMC (tire) or GMC (glazing) with the NHTSA-assigned code in the entity number - mandatory for tires and glazing.nhtsa[].entities[].identificationCode | PG19 | If it applies | Post / seller | TMCMax length: 3 |
| Contact telephoneAlways provide when known.nhtsa[].entities[].contacts[].phoneNumber | PG21 | If it applies | Post gives facts, JFS codes them | +00 0000 0000Max length: 15 |
| HS-7 box numberBox checked on the HS-7: 1, 2A, 2B, 3-13 (no leading zero). The post supplies the facts (e.g. whether the item bears the FMVSS certification label); the declarant picks the box.nhtsa[].conformanceDeclarations[].number | PG22 | Mandatory | Post gives facts, JFS codes them | 2BMax length: 5 |
EPA
Environmental Protection Agency
Disclaim only"May be required" flags: EP1 EP3 EP5 EP7 EH1"Required" flags: EP2 EP4 EP6 EP8 EH2
What it is
EPA regulates chemicals, pesticides, ozone-depleting substances, refrigerants and engine emissions.
On this mail route EPA can only be disclaimed. If the item really is a pesticide, a regulated chemical, a refrigerant or an engine, it needs a formal entry.
Insect repellents and disinfectants count as pesticides. A pesticide needs an EPA Notice of Arrival before import.
Common products
| DEET insect repellent spray | 3808.91.2501 | Disclaimed by default. Wrong: a repellent is a pesticide. Formal entry. |
| E-cigarette | 8543.40.0030 | Disclaimed by default (A) |
| Plastic baby rattle | 9503.00.0071 | Disclaimed by default (A) |
Also typical: Disinfectant wipes, mosquito coils, flea collars, air-conditioning refrigerant, small engines, composite-wood furniture.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Confirm the item is not regulated by EPA | Mandatory | Post / seller | Disclaimer A |
DEA
Drug Enforcement Administration
Disclaim only"May be required" flags: DE1 DE3
What it is
DEA controls controlled substances, chemicals used to make drugs, and tablet or capsule machines.
On this mail route DEA can only be disclaimed. Anything actually controlled cannot be mailed on an informal entry.
Common products
| Tablet press machine | 8479.89 | Needs DEA form 15 days before import |
Also typical: Acetone, iodine, products with ephedrine, some solvents, capsule-filling machines.
The essentials
| Field | Required | Who supplies | Example |
|---|---|---|---|
| Confirm the item is not a controlled substance, listed chemical or pill machine | Mandatory | Post / seller | Disclaimer A |
FSIS
USDA Food Safety and Inspection Service
Formal entry only"May be required" flags: FS3"Required" flags: FS4
What it is
FSIS inspects imported meat, poultry and egg products.
This mail route has no FSIS data at all, not even a disclaimer. Any parcel with an FSIS flag is refused and needs a formal entry.
Common products
| Beef jerky | 1602.50 | Refused: formal entry |
Also typical: Sausages, canned meat, instant noodles or soups with meat, dried egg.
Full field list · FS4(1)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 1
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| Official foreign inspection certificateWhat FSIS would need: the official inspection certificate (PG13/PG14), establishment numbers (PG19), species/process/product category (PG10), net weight (PG29) and arrival/inspection establishment (PG30). None of it can be sent: v4 has no FSIS block. | PG14 | Mandatory | Post / seller |
State Dept
State Department Office of Marine Conservation
Formal entry only"May be required" flags: OM1"Required" flags: OM2
What it is
Protects sea turtles: imported shrimp must come from a certified country or be caught in a turtle-safe way (form DS-2031).
This mail route cannot carry the data. Shrimp parcels are refused and need a formal entry.
Common products
| Frozen peeled shrimp | 0306.17.0041 | Refused: formal entry |
Also typical: All shrimp and shrimp products.
Full field list · OM2(1)
Every field the API asks for, taken from its own field tables. Pick a product type to see exactly what that type needs, or compare all types side by side.
PayCBP v4 cannot carry this field yet. JFS files it another way.: 1
| Field | CBP record | Required | Who supplies | Example |
|---|---|---|---|---|
| DS-2031 declaration (PG22 conformance declaration)What OMC would need: the DS-2031 box selected (an image of the form is required unless 7B), harvesting nation and export date (PG06), and the declaring entity (PG19-21). None of it can be sent: v4 has no OMC block. | PG22 | Mandatory | Post / seller |
TTB
Alcohol and Tobacco Tax and Trade Bureau
Formal entry only"May be required" flags: TB1 TB3"Required" flags: TB2
What it is
TTB taxes and regulates alcohol and tobacco.
U.S. law does not allow alcohol or tobacco on an informal mail entry. These parcels need a formal entry.
Common products
| Bottle of wine | 2204.21 | Refused: formal entry |
| Cigarettes | 2402.20 | Refused: formal entry |
Also typical: Beer, spirits, cigars, rolling papers, pipe and chewing tobacco.
Descriptions
The API picks agencies from the item description. A clear description gets the right flags; a vague one gets wrong flags or a refusal. Say what it is made of, what it is for, its form and its pack size. For wood, leather and plants, name the species.
Chips
Potato crisps made from sliced fresh potatoes, fried, salted, 150 g bag
Bag
Handbag made of python skin leather
Cream
Sunscreen lotion SPF 50, 100 ml tube
Toy
Plastic baby rattle toy for infants
Chopsticks
Bamboo chopsticks, set of 10 pairs
Common mistakes
| Disclaiming a "required" flag | The whole parcel is refused | Send the agency data, or use a formal entry |
| Disclaiming FDA on real food, supplements or cosmetics | FDA hold up to 72 hours, possible refusal | Send the FDA data. For food, file prior notice before mailing |
| No prior notice number on food | Nobody downstream can create it | Seller files prior notice before mailing and writes the number on the CN22/CN23 |
| Giving the seller or platform as the manufacturer | FDA and CPSC data are wrong | Name the company that actually made or grew it |
| Giving the country of origin as the country of harvest | Wrong Lacey, FWS or APHIS declaration | Give where the tree was cut or the animal was taken |
| Trade names instead of Latin names ("oak", "spp.") | Lacey and FWS data rejected | Genus and species, for example QUERCUS RUBRA |
| Lacey quantity in pieces | Unit rejected | Use KG, M2, M3 or L |
| Made-up permit, certificate or registration numbers | Agencies check them against their records | Leave blank if unknown. Never invent a number |
| Shrimp, meat, alcohol or tobacco in a mail parcel | Refused | Formal entry |
Real API result