added

Launch Announcement: Verified Address Program - India Marketplace

What is changing?

Verified Address is a new included benefit that enables shippers to receive delivery confidence signals for customer addresses through Amazon Shipping APIs.

With this launch, you'll be able to:

  • Receive Verification Status: Get a "[DESTINATION_ADDRESS_VERIFIED]" flag in Get Rates API responses, indicating high deliverability confidence for customer addresses
  • Improve Carrier Allocation: Use verification signals to make better multi-carrier allocation decisions based on address quality
  • Reduce Delivery Failures: Leverages high confidence delivery data and past history to improve delivery success rates

Which marketplaces are affected?

This change applies to IN marketplace only . The feature will be available starting on 9th Feb 2026 for India for limited shippers.

What action is required?

If you have an application that integrates with Amazon Shipping APIs, be sure to:

  • Update your integration to handle the new includedBenefits array in GetRates API responses
  • Ensure phone number is included in destination address for optimal verification
  • Review the technical implementation details below
  • Test your implementation in the sandbox environment before using in production

Technical Implementation Details

Sample API Request:

// No change to your existing API request.
{
  "shipTo": {
    "name": "TEST ",
    "addressLine1": "Building 123, Street Name",
    "city": "Bangalore",
    "stateOrRegion": "Karnataka",
    "postalCode": "560001",
    "countryCode": "IN"
  },
  "shipFrom": {
    "name": "TEST Seller",
    "addressLine1": "XX XXXX",
    "city": "Bangalore",
    "countryCode": "IN",
    "postalCode": "XXX XXX",
    "email": "[email protected]"
  },
  "packages": [{
        "dimensions": {
            "length": 10,
            "width": 10,
            "height": 10,
            "unit": "CENTIMETER"
        },
        "weight": {
            "value": 1,
            "unit": "KILOGRAM"
        },
        "items": [{
            "description": "Test Item",
            "itemValue": {
                "unit": "INR",
                "value": 100
            },
            "quantity": 1,
            "weight": {
                "value": 1,
                "unit": "KILOGRAM"
            },
            "isHazmat": false,
            
        }],
        "isHazmat": false,
        "insuredValue": {
            "unit": "INR",
            "value": 100
        },
        "packageClientReferenceId": "ORDER-123"
    }],
     "channelDetails": {
        "channelType": "EXTERNAL"
    }  
}  
{
  "payload": {
    "rates": [
      {
        "benefits": {
          "includedBenefits": [
            "DESTINATION_ADDRESS_VERIFIED"                    // New benefit value
          ],
          "excludedBenefits":[]
        },
        "billedWeight": {
          "unit": "KILOGRAM",
          "value": 1.0
        },
        "carrierId": "ATS",
        "carrierName": "Amazon Shipping",
        "creditItemList": null,
        "paymentType": null,
        "promise": {
          "deliveryWindow": {
            "end": "2025-06-04T19:00:00Z",
            "start": "2025-06-04T19:00:00Z"
          },
          "pickupWindow": {
            "end": "2025-06-02T19:00:00Z",
            "start": "2025-06-02T17:30:00Z"
          }
        },
        "rateId": "0435f7f9b784afc1a56ce39e78760ae780c3f9c78fXX02968",
        "rateItemList": [],
        "requiresAdditionalInputs": false,
        "serviceId": "SWA-IN-OA",
        "serviceName": "Amazon Shipping Standard",
        "supportedDocumentSpecifications": [
          {
            "format": "PNG",
            "printOptions": [
              {
                "supportedDPIs": [
                  300,
                  203
                ],
                "supportedDocumentDetails": [
                  {
                    "isMandatory": true,
                    "name": "LABEL"
                  }
                ],
                "supportedFileJoiningOptions": [
                  false
                ],
                "supportedPageLayouts": [
                  "DEFAULT"
                ]
              }
            ],
            "size": {
              "length": 6.0,
              "unit": "INCH",
              "width": 4.0
            }
          },
          {
            "format": "ZPL",
            "printOptions": [
              {
                "supportedDPIs": [
                  300,
                  203
                ],
                "supportedDocumentDetails": [
                  {
                    "isMandatory": true,
                    "name": "LABEL"
                  }
                ],
                "supportedFileJoiningOptions": [
                  false
                ],
                "supportedPageLayouts": [
                  "DEFAULT"
                ]
              }
            ],
            "size": {
              "length": 6.0,
              "unit": "INCH",
              "width": 4.0
            }
          },
          {
            "format": "PDF",
            "printOptions": [
              {
                "supportedDPIs": [
                  300,
                  203
                ],
                "supportedDocumentDetails": [
                  {
                    "isMandatory": true,
                    "name": "LABEL"
                  }
                ],
                "supportedFileJoiningOptions": [
                  false
                ],
                "supportedPageLayouts": [
                  "DEFAULT"
                ]
              }
            ],
            "size": {
              "length": 6.0,
              "unit": "INCH",
              "width": 4.0
            }
          }
        ],
        "totalCharge": {
          "unit": "INR",
          "value": 51
        }
      }
    ],
    "ineligibleRates": [],
    "requestToken": "amzn1.rq.87283887737561.100"
  }
}

Note: The includedBenefits array will contain "DESTINATION_ADDRESS_VERIFIED" when the address meets verification criteria.

Schema Details:

Field NameRequired/OptionalDescriptionSchema
benefits.includedBenefits required[Array of benefits included with the shipping offer][< string > array]
benefits.excludedBenefits required[Array of benefits excluded from the shipping offer ][< string > array]

Error Handling:

When implementing this feature, be prepared to handle these potential error responses:
When address verification service is unavailable or returns errors:

{
  "payload": {
    "ineligibleRates": [],
    "rates": [
      {
        // Existing fields
      "rateId": "rate_12345",
      "benefits": {
          "includedBenefits": [],
          "excludedBenefits": [
            {
             "benefit": "DESTINATION_ADDRESS_VERIFIED"
            }
          ]
       }
    }
  ]
}

FAQs:

  1. Why is this feature only available in India?
    Verified address is currently only deployed in India. Geographic expansion will be evaluated based on business demand and technical feasibility.

  2. Will this feature impact my existing API integration?
    No. The feature is fully backward compatible. The includedBenefits field is optional in the response. Existing integrations continue working without changes.

  3. Is there a cost for this benefit?
    No. Verified Address is an included benefit provided at no additional charge. It is automatically evaluated for all eligible shipments.

  4. How does this affect API latency?
    You may experience a minor increase in latency. The system uses circuit breaker patterns to ensure graceful degradation if verification service is unavailable.

  5. What if the verification service is down?
    The system gracefully degrades. Your request completes successfully with the original address, and the verification benefit will appear in excludedBenefits.

  6. Will I see verification status for all addresses I submit?
    No. Only addresses that meet our quality and confidence thresholds will show as verified.

  7. Can I filter or sort shipments by verification status in my system?
    Yes. You can use the includedBenefits array in your business logic to priorities verified addresses.

  8. Do I need to opt-in to use this feature?
    Yes. Verified Address is available through a controlled rollout. Contact your Amazon Shipping Account Manager to enable this capability for your account.