FedEx Regulatory API Virtual Sandbox
Validate international trade and regulatory compliance documentation workflows.
The FedEx Regulatory API allows developers to manage trade profiles and regulatory documentation requirements. This service provides endpoints to handle compliance data, ensuring that international shipments meet destination-specific customs and regulatory standards.
Use this hosted sandbox to simulate FedEx Regulatory API APIs without authentication, API keys, or extra dependencies. Point your code or SDK to the Beeceptor base URL, preferably through an environment variable or feature flag, and switch back to the production API when ready.
This keeps your integration code consistent across local development, QA, demos, and production.
Use cases:
Use this sandbox to validate trade profile creation, verify customs documentation requirements, test compliance data structures, and handle regulatory error responses for international shipping workflows.
General
POST
| Header Name | Example |
|---|---|
x-locale | "en_US" |
x-content-type | "application/json" |
x-customer-transaction-id | "0e671149-016f-1000-941f-ef4dbabadd2e" |
authorization* | "Bearer XXX" |
content-type* | "application/json" |
[
{
"regulationCode": "CPSC",
"productId": "KIDUZ-PZ-001",
"productIdType": "SKU",
"countryOfImport": "US",
"details": [
{
"disclaimMessageSet": {
"disclaimCode": "A",
"intendedUseCode": "130.006",
"intendedUseDescription": "string"
},
"referenceMessageSet": {
"productVersion": "PRIV-2026-Q1",
"certifierId": "CERT-ACME-0007",
"registryProductId": "CPSC-2026-001234"
},
"fullMessageSet": {
"productDetails": {
"childrensProduct": true,
"skuProductCode": "KIDUZ-PZ-001",
"gtinUpcCode": "00012345678905",
"gtinUpcQualifierCode": "SRV",
"serialNumber": "string",
"registeredNumber": "string",
"productName": "KIDUZZLE PUZZLE",
"brandName": "KIDUZZLE",
"alternateId": "string",
"previousTestDate": "2026-02-15",
"modelNumber": "KP-2026-A",
"modelColor": "RED/BLUE/YELLOW",
"modelDescription": "48-PIECE WOODEN PUZZLE WITH TRAY",
"modelStyle": "string",
"declarationCode": "CPY"
},
"manufacturerDetails": {
"smallBatchManufacturerRegistryId": "string",
"manufactureDate": "2026-03",
"contact": {
"personName": "Jane Doe",
"emailAddress": "qc@acmetoys.example.com",
"phoneExtension": "000",
"phoneNumber": "755-8888-0001",
"companyName": "ACME TOYS LTD"
},
"address": {
"streetLines": [
"123 INDUSTRIAL PKWY"
],
"city": "SHENZHEN",
"stateOrProvinceCode": "GD",
"postalCode": "518000",
"countryCode": "CN"
}
},
"lotDetails": {
"lotNumber": "L-2026-0342",
"lotNumberQualifier": 1,
"productionStartDate": "2026-02-10",
"productionEndDate": "2026-02-28"
},
"certifierEntity": {
"contact": {
"personName": "Jane Doe",
"emailAddress": "qc@acmetoys.example.com",
"phoneExtension": "000",
"phoneNumber": "755-8888-0001",
"companyName": "ACME TOYS LTD"
},
"address": {
"streetLines": [
"123 INDUSTRIAL PKWY"
],
"city": "SHENZHEN",
"stateOrProvinceCode": "GD",
"postalCode": "518000",
"countryCode": "CN"
}
},
"pointOfContact": {
"contact": {
"personName": "Jane Doe",
"emailAddress": "qc@acmetoys.example.com",
"phoneExtension": "000",
"phoneNumber": "755-8888-0001",
"companyName": "ACME TOYS LTD"
},
"address": {
"streetLines": [
"123 INDUSTRIAL PKWY"
],
"city": "SHENZHEN",
"stateOrProvinceCode": "GD",
"postalCode": "518000",
"countryCode": "CN"
}
},
"citationDetails": [
{
"testingDetails": [
{
"citationCode": [
"16CFR1303",
"16CFR1250",
"ASTMF963"
],
"labType": "ITL",
"labTestDate": "2026-02-15",
"labId": "0112",
"testReportId": "GTL-RPT-2026-00482",
"testReportUrl": "https://reports.intertek.com/ITK-2026-04-88821",
"testReportAccessKey": "ak_38hfj28f9a",
"componentPartDescription": "ak_38hfj28f9a",
"contact": {
"personName": "Jane Doe",
"emailAddress": "qc@acmetoys.example.com",
"phoneExtension": "000",
"phoneNumber": "755-8888-0001",
"companyName": "ACME TOYS LTD"
},
"address": {
"streetLines": [
"123 INDUSTRIAL PKWY"
],
"city": "SHENZHEN",
"stateOrProvinceCode": "GD",
"postalCode": "518000",
"countryCode": "CN"
}
}
]
}
]
},
"nonStandardManufacturerProductId": "SH123456-L",
"standardManufacturerProductId": "GTIN 00000006",
"merchantProductId": "12345"
}
]
}
]{
"customerTransactionId": "7ed582bc-cde9-44e1-b36b-d359650481ee",
"output": {
"message": "Validation successful"
},
"transactionId": "456e44d9-12b1-470d-b254-26585007bd3a"
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "REGULATORYPROFILE.COUNTRYOFIMPORT.REQUIRED",
"message": "Country of import is required. Please provide a valid country code."
},
{
"code": "REGULATORYPROFILE.REGULATIONCODE.REQUIRED",
"message": "Regulation code is required. Please provide CPSC or EU_DE_MINIMIS."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "LOGIN.REAUTHENTICATE.ERROR",
"message": "Re-Login authentication error"
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "FORBIDDEN.ERROR",
"message": "We could not authorize your credentials. Please check your permissions and try again."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "NOT.FOUND.ERROR",
"message": "The resource you requested is no longer available. Please modify your request and try again."
}
]
}{
"transactionId": "624deea6-b709-470c-8c39-4b5511281492",
"errors": [
{
"code": "INTERNAL.SERVER.ERROR",
"message": "We encountered an unexpected error and are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
}
]
}{
"transactionId": "08f37269-2fcf-4a52-8f02-01c8349d143f",
"errors": [
{
"code": "SERVICE.UNAVAILABLE.ERROR",
"message": "The service is currently unavailable and we are working to resolve the issue. We apologize for any inconvenience. Please check back at a later time."
}
]
}Service Homepage: developer.fedex.com/api/en-us/catalog/regulatory/v1/docs.html
fedexlogisticsshippingregulatorycompliancecustoms