About broker & importer of record

International shipments typically require an importer of record and customs broker. An importer of record (IOR) is the entity responsible for ensuring that imported goods comply with all relevant regulations and laws of the importing country. This typically includes the owner or purchaser of the goods but can also be a designated individual or customs broker. The IOR is responsible for ensuring compliance with customs regulations and paying applicable duties and taxes. A customs broker is a licensed professional who assists importers with the customs clearance process. While the broker assists the IOR, they are not the entity responsible for compliance and payment of duties.

Your organization may need to designate a broker and importer of record other than the shipment carrier in your calls to Shipium's APIs. This document provides guidance for including brokers and importers of record in your API call. Other guidance related to customs can be found in Customs Info for Shipments.

Specifying tax identification for importer of record

When providing tax identification for the importer of record in international shipments, Shipium supports two methods.

Primary method: Using payorAccounts (recommended)

The recommended approach is to specify the importer of record's tax identification using the registrationInformation object within payorAccounts. This method is particularly useful for EORI numbers and provides clear association between the party and their tax identification. For complete documentation including detailed examples, carrier-specific requirements, and all available fields, see the Specifying Payors documentation.

"payorAccounts": [
  {
    "accountType": "consignee",
    "registrationInformation": {
      "typeCode": "EOR",
      "issuerCountryCode": "GB",
      "registrationNumber": "GB123456789000"
    }
  }
]

Alternative method: Using customsInfo.importerOfRecord

You can also specify importer of record tax identification using the customsInfo.importerOfRecord object. This method may be appropriate when you need to provide multiple tax identification numbers or when integrating with systems that use this structure.

"customsInfo": {
  "importerOfRecord": {
    "taxIdentificationNumbers": [
      {
        "tinType": "EIN",
        "tinNumber": "12-3456789",
        "tinIssuingCountry": "US"
      }
    ]
  }
}

Which method should I use?

UsepayorAccounts.registrationInformation when:
- You're providing EORI numbers for EU/UK customs clearance.
- You want a clear, straightforward association between party and tax ID.
- You're setting up new integrations (recommended for new implementations).
UsecustomsInfo.importerOfRecord when:
- You need to provide multiple different tax ID types for the same party.
- Your existing integration already uses this structure.
- You have specific requirements that necessitate the alternative method.

Specify broker & importer of record in shipments

This is a sample API call including an array of brokers and an importer of record in the shipmentParameters of the call request. This information also can be included in the multiParcelShipmentParameters for a multi-parcel shipment. Request fields for this sample call are defined in the table that follows the code example.

{
    "shipmentParameters": {
        "customsInfo": {
          "importerOfRecord": {
                "importerAddress": {
                    "name": "J. Jetson",
                    "phoneNumber": "888-867-5309",
                    "phoneNumberCountryCode": "+1",
                    "emailAddress": "[email protected]",
                    "company": "SHIPPING CO",
                    "street1": "80 Future Drive",
                    "city": "Albuquerque",
                    "state": "NM",
                    "countryCode": "US",
                    "postalCode": "87121",
                    "addressType": "commercial"
                },
                "accountNumber": "6578439201",
                "taxIdentificationNumbers": [
                    {
                        "number": "864357",
                        "tinType": "FEDERAL"
                    }
                ]
            },  
          "brokers": [
              {
               "brokerAddress": {
                    "name": "Rod Runner",
                    "phoneNumber": "865-433-9999",
                    "phoneNumberCountryCode": "+1",
                    "emailAddress": "[email protected]",
                    "company": "ACME",
                    "street1": "456 Main St.",
                    "street2": "Suite 8",
                    "city": "Albuquerque",
                    "state": "NM",
                    "countryCode": "US",
                    "postalCode": "87121",
                    "addressType": "commercial"
                },
                "accountNumber": "0864213579",
                "taxIdentificationNumbers": [
                    {
                        "number": "123567",
                        "tinType": "FEDERAL"
                    }
                ],
                 "deliveryInstructions": "deliveryInstructions",
                 "type": "IMPORT"
            },
                    {
                "brokerAddress": {
                    "name": "Wile E. Coyote",
                    "phoneNumber": "888-555-1234",
                    "phoneNumberCountryCode": "+1",
                    "emailAddress": "",
                    "company": "",
                    "street1": "123 Main St.",
                    "street2": "Suite 42",
                    "city": "Albuquerque",
                    "state": "NM",
                    "countryCode": "US",
                    "postalCode": "87121",
                    "addressType": "commercial"
                  },
                  "accountNumber": "9753124680",
                  "taxIdentificationNumbers": [
                      {
                          "number": "246801",
                          "tinType": "FEDERAL"
                      }
                  ],
                  "deliveryInstructions": "deliveryInstructions",
                  "type": "IMPORT"
              }
          ]
        },
    }
}

Request fields for including brokers and an importer of record are defined in the following table. They are all included in either the shipmentParameters or multiParcelShipmentParameters of the API call. While these fields are optional for making an API call, those flagged as required must be included to designate a broker and importer of record.

Request field	Required/Optional	Field properties	Description
`customsInfo.importerOfRecord .importerAddress.name`	Optional	String	The name of the importer of record
`customsInfo.importerOfRecord .importerAddress .phoneNumber`	Optional	String	The importer of record's phone number
`customsInfo.importerOfRecord .importerAddress .phoneNumberCountryCode`	Optional	String	The importer of record's phone number country code
`customsInfo.importerOfRecord .importerAddress .emailAddress`	Optional	String	The importer of record's email address
`customsInfo.importerOfRecord .importerAddress.company`	Optional	String	The importer of record's company name
`customsInfo.importerOfRecord .importerAddress.street1`	Optional	String	The first address line of the importer of record
`customsInfo.importerOfRecord .importerAddress.street2`	Optional	String	The first address line of the importer of record
`customsInfo.importerOfRecord .importerAddress.city`	Optional	String	The name of the city for the importer of record's address
`customsInfo.importerOfRecord .importerAddress.state`	Optional	String	The postal abbreviation of the state for the importer of record's address
`customsInfo.importerOfRecord .importerAddress .countryCode`	Required	String	The ISO 3166-1 country code for the importer of record's address
`customsInfo.importerOfRecord .importerAddress .postalCode`	Required	String	A country-code-appropriate postal code for the importer of record's address
`customsInfo.importerOfRecord .importerAddress .addressType`	Required	String enumeration Values are: `commercial` `residential`	The type of location for the importer of record's address
`customsInfo.importerOfRecord .importerAddress .addressLineComponents`	Optional, but preferred for Mexican addresses	String Ex.: `streetName`: "Fovisste Fuentes Brotantes" `primaryAddressNumber`: "12" `secondaryAddressNumber`: "302" `district`: "Iztacalco" `neighborhood`: "Agrícola Pantitlán"	The address line components for the address, used for some international shipments. This is an optional object that can be included in `shipmentParameters`. The `street1` and `street2` fields should not be included if using `addressLineComponents`, or an error will be returned. This optional address object is not included in the example JSON request for the API call. You can find out more about Mexican addresses in Non-U.S. Address Formats .
`customsInfo.importerOfRecord .accountNumber`	Required	String	The importer of record's account number
`customsInfo.importerOfRecord .taxIdentificationNumbers .number`	Required	String	The importer of record's tax identification number (TIN)
`customsInfo.importerOfRecord .taxIdentificationNumbers .tinType`	Required	String enumeration Values are: `business_national` `business_state` `business_union` `federal` `personal_national` `personal_state`	The type of the tax identification number for the importer of record
`customsInfo.brokers`		An array of brokers for which you wish to include information	Fields are described in this table.
`customsInfo.brokers .brokerAddress.name`	Optional	String	The name of the broker
`customsInfo.brokers .brokerAddress.phoneNumber`	Optional	String	The broker's phone number
`customsInfo.brokers .brokerAddress .phoneNumberCountryCode`	Optional	String	The broker's phone number country code
`customsInfo.brokers .brokerAddress.emailAddress`	Optional	String	The broker's email address
`customsInfo.brokers .brokerAddress.company`	Optional	String	The broker's company name
`customsInfo.brokers .brokerAddress.street1`	Optional	String	The first address line of the broker
`customsInfo.brokers .brokerAddress.street2`	Optional	String	The second address line of the broker
`customsInfo.brokers .brokerAddress.city`	Optional	String	The name of the city for the broker's address
`customsInfo.brokers .brokerAddress.state`	Optional	String	The postal abbreviation of the state for the broker's address
`customsInfo.brokers .brokerAddress.countryCode`	Required	String	The ISO 3166-1 country code for the broker's address
`customsInfo.brokers .brokerAddress.postalCode`	Required	String	A country-code-appropriate postal code for the broker's address
`customsInfo.brokers .brokerAddress.addressType`	Required	String enumeration Values are: `commercial` `residential`	The type of location for the broker's address
`customsInfo.brokers .brokerAddress .addressLineComponents`	Optional, but preferred for Mexican addresses	String Ex.: `streetName`: "Fovisste Fuentes Brotantes" `primaryAddressNumber`: "12" `secondaryAddressNumber`: "302" `district`: "Iztacalco" `neighborhood`: "Agrícola Pantitlán"	The address line components for the address, used for some international shipments. This is an optional object that can be included in `shipmentParameters`. The `street1` and `street2` fields should not be included if using `addressLineComponents`, or an error will be returned. This optional address object is not included in the example JSON request for the API call. You can find out more about Mexican addresses in Non-U.S. Address Formats .
`customsInfo.brokers .accountNumber`	Required	String	The broker's account number
`customsInfo.brokers .taxIdentificationNumbers .number`	Required	String	The broker's tax identification number (TIN)
`customsInfo.brokers .taxIdentificationNumbers .tinType`	Required	String enumeration Values are: `business_national` `business_state` `business_union` `federal` `personal_national` `personal_state`	The type of the tax identification number for the broker
`customsInfo.brokers .deliveryInstructions`	Optional	String	Special delivery instructions for the broker
`customsInfo.brokers.type`	Required	String enumeration Values are: `import` `export`	The type of broker

Resources

Your Shipium team member is available to help along the way. However, you might find these resources helpful: