Amazon order ID format validator.

What the 3-7-7 format is

Amazon’s Selling Partner API Orders model describes an order identifier as “an Amazon-defined order identifier, in 3-7-7 format”, and its examples look like 902-3159896-1390916. Read it as three groups of digits separated by two hyphens: three digits, seven digits, seven digits, 17 digits in all and 19 characters with the hyphens.

That sentence is the whole of Amazon’s published rule. Amazon does not document what the first three digits mean, whether the last group has a check digit, or how the numbers are issued, and this page does not guess. The examples in Amazon’s model are documentation samples, so treat them as shape illustrations rather than real orders.

How the check works, variable by variable

The validator trims spaces, then tests for exactly three digits, a hyphen, seven digits, a hyphen and seven digits. It reports the three groups when they match. When the value is 17 digits with no hyphens, it says the digit count is right and shows the hyphenated form to try, because order numbers copied from a spreadsheet often lose their hyphens.

When there are three groups of the wrong lengths, it prints the lengths it found (for example 3-7-8) so you can see which group is off. When the value contains letters or symbols it says so. It also recognises a TBA-style tracking number and a ten-character ASIN or FNSKU shape, since those are the numbers most often pasted by mistake. No check digit is applied because none is published.

Worked example (hypothetical numbers)

123-4567890-1234567 splits as 123, 4567890, 1234567: lengths 3, 7, 7, so it matches. 12345678901234567 is the same 17 digits without hyphens; the tool reports the right count and suggests 123-4567890-1234567. 123-456789-12345678 has three groups but lengths 3, 6 and 8, so it fails and says exactly that. B07FZ8S74R is ten characters with no hyphens, and the tool points out it looks like an ASIN instead.

None of these is a real order. Use your own number only if you are comfortable pasting it; the check runs in your browser inside an isolated frame and nothing is sent anywhere.

Order ID, tracking ID, shipment ID and fulfillment order ID

Four numbers get confused. The order ID is the Amazon-defined 3-7-7 identifier for the customer order. The tracking ID belongs to a parcel (see the TBA tracking number decoder); one order can have several parcels. An FBA inbound shipment ID such as FBA15DJ9S3J5 belongs to stock you are sending to Amazon, not to a customer order (see the FBA shipment ID guide).

The fourth is a seller fulfillment order ID. In Amazon’s Fulfillment Outbound API (multi-channel fulfillment), sellerFulfillmentOrderId is “a fulfillment order identifier that the seller creates”, must be unique per fulfillment order, and has a maximum length of 40 characters. Because the seller creates it, it need not look like a 3-7-7 number; Amazon suggests that if your system already creates unique order identifiers, those might be good values to use. So a value that fails this check may still be a perfectly good seller-created ID in that API.

Where to find an order ID

Buyers find it in Your Orders, next to the order. Sellers get the same identifier from Seller Central and from the Orders API, where it is the AmazonOrderId field. Amazon’s tracking help also starts from Your Orders. If a spreadsheet or helpdesk form rejects your value, check first for a leading apostrophe, a trailing space or a number that has been turned into scientific notation, which is a common spreadsheet side effect for 17-digit values.

Common mistakes, and a regular expression

The format has no letters, so any letter in the value (an O for a zero, an l for a one) is a typo or a different kind of ID. Other frequent slips are pasting the words “Order #” along with the number, copying a trailing space, keeping a tracking ID or ASIN in the order column of an export, and typing a seller-created fulfillment order ID where an Amazon order ID is expected.

If you are writing a form or import rule, the documented shape translates to ^\d{3}-\d{7}-\d{7}$. Keep the anchors, otherwise a longer string that merely contains an order number passes. Do not tighten it further: Amazon documents no other rule, so a stricter pattern would reject values Amazon accepts.

Who this is for

Sellers and support staff cleaning order exports, anyone writing a form or import rule that must accept Amazon order numbers, and buyers who want to know whether the number on a message looks like a real order number or a tracking ID.

What this does not cover

• It does not look an order up, show its status or contact Amazon.
• It does not say what the digits mean or in which marketplace the order was placed.
• It does not validate seller-created fulfillment order IDs, digital-content order numbers or other marketplaces’ formats that Amazon has not documented here.
• It does not store, send or log what you type.