NAV
shell ruby python javascript

Introduction

Welcome to the fda.express API! You can use our API to access fda.express API endpoints and create fda prior notice pdf file.

We have language bindings in Shell, Ruby, Python, and JavaScript! You can view code examples in the dark area to the right, and you can switch the programming language of the examples with the tabs in the top right.

Authentication

To authorize, use this code:

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1")

http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = http.request(request)
puts response.read_body
import requests

url = "https://api.fda.express/api/v1"

payload={}
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
# With shell, you can just pass the correct header with each request
curl --location --request GET 'https://api.fda.express/api/v1' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

Make sure to replace aaaaaaaa-bbbbbbbb-cccccccc-dddddddd with your API key.

api.fda.express uses API keys to allow access to the API. You can register a new API key at our website by signing up as a new user or buy prior notice credit. Our system will automatically send you an API key to your email address.

api.fda.express expects for the API key to be included in all API requests to the server in a header that looks like the following:

api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd

Credit & Voucher code

Get Voucher Code

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/getVoucherCode")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/getVoucherCode", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/getVoucherCode' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/getVoucherCode',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this:

{
    "success": true,
    "voucherCode": "a2bf5a297a52cc46",
    "voucherStatus": "un-use",
    "creditDeduct": 1,
    "creditBalance": 5
}

Or:

{
    "success": false,
    "message": "insufficient credit in your account"
}

This endpoint retrieves voucher Code. You must have at least 1 prior notice credit in your account before you can convert the credit into prior notice voucher code . The voucher code is required when you want to create a fda prior notice file .

1 credit can be converted to 1 voucher code and

1 voucher code can create 1 fda prior notice file.

HTTP Request

GET https://api.fda.express/api/v1/getVoucherCode

Remaining credit

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/credit")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body
import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/credit", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/credit' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/credit',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this:

{
    "success": true,
    "creditBalance": 4
}

HTTP Request

GET https://api.fda.express/api/v1/credit

Voucher list

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/voucher?offset=1&limit=3&status=queued,complete")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body

import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/voucher?offset=1&limit=3&status=queued,complete", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/voucher?offset=1&limit=3&status=queued,complete' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/voucher?offset=1&limit=3&status=queued,complete',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this:

{
    "success": true,
    "total": 9,
    "count": 3,
    "offset": "1",
    "limit": "3",
    "total_voucher_status": [
        {
            "status": "queued",
            "total": 2
        },
        {
            "status": "processing-m",
            "total": 1
        },
        {
            "status": "processing-a",
            "total": 1
        },
        {
            "status": "complete",
            "total": 2
        },
        {
            "status": "notified",
            "total": 2
        },
        {
            "status": "exception",
            "total": 1
        }
    ],
    "items": [
        {
            "id": 37,
            "code": "3316-B157-66FC-BF2F",
            "status": "queued"
        },
        {
            "id": 40,
            "code": "3316-B157-66FC-BF2F",
            "status": "complete"
        },
        {
            "id": 43,
            "code": "3316-B157-66FC-BF2F",
            "status": "complete"
        }
    ]
}

HTTP Request

GET https://api.fda.express/api/v1/voucher

Query Parameters

Parameter Type Description
limit number Maximum number of returned items. Default value: 100
offset number Offset from the beginning of the returned items list (for paging)
status string Comma separated list of voucher statuses to search. Supported values:
  • un-use
  • queued
  • processing-m
  • processing-a
  • complete
  • notified
  • exception

Use the offset parameter to get all voucher. For example, if a you has 452 vouchers, you would need to call the /voucher endpoint 5 times with different offset parameter values:

offset=0 // 0-100 vouchers

offset=100 // 100-200 vouchers

offset=200 // 200-300 vouchers

offset=300 // 300-400 vouchers

offset=400 // 400-452 vouchers

FDA Prior Notice

Create Prior Notice

require "uri"
require "json"
require "net/http"

url = URI("https://api.fda.express/api/v1/create")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "voucherCode": "aaaabbbbccccdddd",
  "transportation": {
    "transportation": "01",
    "arrival_date": "2021-09-07",
    "arrival_time": "23:03",
    "us_state": "AK",
    "port_code": "3104",
    "transportation_mode": "40",
    "iata": "QR",
    "food_kind": "1",
    "tracking": "15716368844"
  },
  "shipper": {
    "country": "DE",
    "business_name": "continental",
    "address": "Deistrasse",
    "additional_address": "23",
    "city": "Arnstein OT Stangerode",
    "country_subdivision": "DE-HE",
    "zipcode": "06456",
    "firstname": "Jonh",
    "lastname": "Wick",
    "phone": "895255554",
    "email": "[email protected]"
  },
  "receiver": {
    "country": "US",
    "business_name": "continental",
    "address": "Deistrasse",
    "additional_address": "23",
    "city": "New York",
    "country_subdivision": "US-NY",
    "zipcode": "06456"
  },
  "products": [
    {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "2",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "22222",
      "size": "2",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "02AAAAA",
      "common_name": "siamsnack"
    },
    {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "3",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "3333",
      "size": "3",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "03AAAAA",
      "common_name": "siamsnack combo"
    }
  ]
})

response = https.request(request)
puts response.read_body


import requests
import json

url = "https://api.fda.express/api/v1/create"

payload = json.dumps({
  "voucherCode": "aaaabbbbccccdddd",
  "transportation": {
    "transportation": "01",
    "arrival_date": "2021-09-07",
    "arrival_time": "23:03",
    "us_state": "AK",
    "port_code": "3104",
    "transportation_mode": "40",
    "iata": "QR",
    "food_kind": "1",
    "tracking": "15716368844"
  },
  "shipper": {
    "country": "DE",
    "business_name": "continental",
    "address": "Deistrasse",
    "additional_address": "23",
    "city": "Arnstein OT Stangerode",
    "country_subdivision": "DE-HE",
    "zipcode": "06456",
    "firstname": "Jonh",
    "lastname": "Wick",
    "phone": "895255554",
    "email": "[email protected]"
  },
  "receiver": {
    "country": "US",
    "business_name": "continental",
    "address": "Deistrasse",
    "additional_address": "23",
    "city": "New York",
    "country_subdivision": "US-NY",
    "zipcode": "06456"
  },
  "products": [
    {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "2",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "22222",
      "size": "2",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "02AAAAA",
      "common_name": "siamsnack"
    },
    {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "3",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "3333",
      "size": "3",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "03AAAAA",
      "common_name": "siamsnack combo"
    }
  ]
})
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd',
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

curl --location --request POST 'https://api.fda.express/api/v1/create' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd' \
--header 'Content-Type: application/json' \
--data-raw '{
    "voucherCode": "aaaabbbbccccdddd",
    "transportation": {
        "transportation": "01",
        "arrival_date": "2021-09-07",
        "arrival_time": "23:03",
        "us_state": "AK",
        "port_code": "3104",
        "transportation_mode": "40",
        "iata": "QR",
        "food_kind": "1",
        "tracking": "15716368844"
    },
    "shipper": {
        "country": "DE",
        "business_name": "continental",
        "address": "Deistrasse",
        "additional_address": "23",
        "city": "Arnstein OT Stangerode",
        "country_subdivision": "DE-HE",
        "zipcode": "06456",
        "firstname": "Jonh",
        "lastname": "Wick",
        "phone": "895255554",
        "email": "[email protected]"
    },
    "receiver": {
        "country": "US",
        "business_name": "continental",
        "address": "Deistrasse",
        "additional_address": "23",
        "city": "New York",
        "country_subdivision": "US-NY",
        "zipcode": "06456"
    },
    "products": [{
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "2",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "22222",
      "size": "2",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "02AAAAA",
      "common_name": "siamsnack"
    },
    {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "3",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "3333",
      "size": "3",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "03AAAAA",
      "common_name": "siamsnack combo"
    }]
}'

var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://api.fda.express/api/v1/create',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "voucherCode": "aaaabbbbccccdddd",
    "transportation": {
      "transportation": "01",
      "arrival_date": "2021-09-07",
      "arrival_time": "23:03",
      "us_state": "AK",
      "port_code": "3104",
      "transportation_mode": "40",
      "iata": "QR",
      "food_kind": "1",
      "tracking": "15716368844"
    },
    "shipper": {
      "country": "DE",
      "business_name": "continental",
      "address": "Deistrasse",
      "additional_address": "23",
      "city": "Arnstein OT Stangerode",
      "country_subdivision": "DE-HE",
      "zipcode": "06456",
      "firstname": "Jonh",
      "lastname": "Wick",
      "phone": "895255554",
      "email": "[email protected]"
    },
    "receiver": {
      "country": "US",
      "business_name": "continental",
      "address": "Deistrasse",
      "additional_address": "23",
      "city": "New York",
      "country_subdivision": "US-NY",
      "zipcode": "06456"
    },
    "products": [
      {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "2",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "22222",
      "size": "2",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "02AAAAA",
      "common_name": "siamsnack"
    },
    {
      "country": "TH",
      "business_name": "siamsnack",
      "address": "845/1 Bangkok",
      "additional_address": "Lardprao 87",
      "city": "Bangkok",
      "zipcode": "12345",
      "quantity": "3",
      "send_from": "TH",
      "country_subdivision": "TH-10",
      "sku": "3333",
      "size": "3",
      "unit": "BBL",
      "package": "BG",
      "fda_code": "03AAAAA",
      "common_name": "siamsnack combo"
    }
    ]
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this:

{"success":true}

This endpoint retrieves prior notice.

HTTP Request

POST https://api.fda.express/api/v1/create

Query Parameters

Parameter Type Description
voucherCode string voucher code from Get Voucher Code API
transportation <transportationInfo> Information about transportation
shipper <shipperInfo> Information about shipper
receiver <receiverInfo> Information about receiver
products Array<productsInfo> List of products contain in shipment

transportationInfo

Field Type Description
transportation string This field is mandatory.
Specific what kind of transportation type of your shipment. Available value is
Data Description
01 Consumption
01C Consumption via express courier
67 Mail (Commercial)
67G Mail (Non-Commercial Sender)

For example.
-If you send parcel with express courier like Fedex , DHL , UPS , Aramex , this field must be 01C .

-If you send parcel with freight forwarder , this field must be 01

-If you send parcel with local post , this field must be 67 or 67G
arrival_date string This field is mandatory.
Format : YYYY-MM-DD
- If transportation field is 01 , enter estimated arrival date of your shipment .

- If transportation field is 67 or 67G , enter the estimated date of dispatch (date on which the sender puts the package in the post) .

- If transportation field is 01C , enter this field as NULL
arrival_time string This field is mandatory.
Format : HH:MM (24 hour)
- If transportation field is 01 , enter the estimated time of dispatch (date on which the sender puts the package in the post)

- If transportation field is 01C, 67 or 67G , enter this field as NULL
us_state string This field is mandatory.
Specific U.S State code where shipment will enters.
For example
- if transportation field is 01 and your shipment will arrive at Anchorage airport in Alaska state . Then specific this field as “AK”

- If transportation field is 01C or 67 or 67G , enter this field as NULL

Retrieves U.S State code list from U.S. State alpha code API

port_code string This field is mandatory.
Specific U.S. port code where shipment will enters.

For example
- if transportation field is 01 and your shipment will arrive at Anchorage airport inAlaska state. Then specific this field as “3126”

- If transportation field is 01C or 67 or 67G , enter this field as NULL

Retrieves U.S Port code list from U.S. port code API
transportation_mode string This field is mandatory.
- If transportation field is 01 or 01C , specific what kind of transportation mode of your shipment. Available value is
Data Description
40 Air
41 Air container
40C Express Courier - Air

- If transportation field is 67 or 67G , enter this field as NULL
iata string This field is mandatory.
Specific airline IATA code

For example
-If transportation field is 01 and you send shipment with Qatar airways. Then specific this field as “QR”.

- If transportation field is 01C and you send shipment with Fedex Express. Then specific this field as “FX”.

- If transportation field is 67 or 67G , enter this field as NULL .

Frequently IATA code for express courier
Express Courier IATA
Fedex FX
UPS 5X
DHL D0, D5

Retrieves Airline IATA code from Airline IATA code API
food_kind string This field is mandatory.
Specific total kind of food in your shipment
tracking string This field is mandatory.
- If transportation field is 01 , enter Airway bill number.

- If transportation field is 01C , enter tracking number

- If transportation field is 67 or 67G, enter this field as NULL

shipperInfo

Field Type Description
country string This field is mandatory
Enter country iso code of shipper which send parcel from

Retrieves country code from Country Code API
business_name string This field is mandatory
Enter shipper business or company name . If shipper is an individual, please enter shipper firstname and lastname instead of business or company name.
address string This field is mandatory
Enter shipper business or company address . If shipper is an individual, please enter shipper home address instead of business or company address.
additional_address string This field is not mandatory
Enter shipper business or company additional address . If shipper is an individual , please enter shipper home additional address instead of business or company additional address.
city string This field is mandatory
Enter shipper business or company city name. If shipper is an individual, please enter shipper home city name instead of business or company city name.
country_subdivision string This field is mandatory
Enter shipper business or company country sub divisions (iso2 code). If shipper is an individual , please enter shipper home country sub divisions instead of business or company country sub divisions.

Retrieves country subdivisions from country subdivisions API
zipcode string This field is mandatory
Enter shipper business or company zipcode. If shipper is an individual, please enter shipper zipcode instead of business or company zipcode.
firstname string This field is mandatory
Enter firstname of the shipper
lastname string This field is mandatory
Enter lastname of the shipper
phone string This field is mandatory
Enter contact phone number of the shipper include with country code without anyspace and + sign
For example
US : 12025550144
TH : 6621029200
DE : 4930774615846
email string This field is mandatory
Enter contact email of the shipper

receiverInfo

Field Type Description
country string This field is mandatory
Enter country iso code of receiver . In most case it should be “US” except transit via U.S. case please specific country of destination

Retrieves country code from Country Code API
business_name string This field is mandatory
Enter receiver business or company name . If receiver is an individual, please enter receiver firstname and lastname instead of business or company name.
address string This field is mandatory
Enter receiver business or company address . If receiver is an individual, please enter receiver home address instead of business or company address.
additional_address string This field is not mandatory
Enter receiver business or company additional address . If receiver is an individual , please enter receiver home additional address instead of business or company additional address
city string This field is mandatory
Enter receiver business or company city name. If receiver is an individual, please enter receiver home city name instead of business or company city name.
country_subdivision string This field is mandatory
Enter receiver business or company country sub divisions (iso2 code). If receiver is an individual , please enter receiver home country sub divisions instead of business or company country sub divisions

Retrieves country subdivisions from country subdivisions API
zipcode string This field is mandatory
Enter receiver business or company zipcode. If receiver is an individual, please enter receiver zipcode instead of business or company zipcode.

productsInfo (Array)

Field Type Description
country string This field is mandatory
Enter country iso code of product manufacturer

Retrieves country code from Country Code API
business_name string This field is mandatory
Enter product manufacturer business or company name . If manufacturer is an individual , please enter firstname and lastname instead of business or company name.
address string This field is mandatory
Enter product manufacturer address . If manufacturer is an individual, please enter manufacturer home address instead of business or company address.
additional_address string This field is not mandatory
Enter product manufacturer additional address . If manufacturer is an individual , please enter manufacturer home additional address instead of business or company additional address
city string This field is mandatory
Enter product manufacturer city name. If manufacturer is an individual, please enter manufacturer home city name instead of business or company city name.
country_subdivision string This field is mandatory
Enter product manufacturer country sub divisions (iso2 code). If manufacturer is an individual , please enter manufacturer home country sub divisions instead of business or company country sub divisions.

Retrieves country subdivisions from country subdivisions API
zipcode string This field is mandatory
Enter product manufacturer zipcode. If manufacturer is an individual, please enter manufacturer zipcode instead of business or company zipcode.
sku string This field is not mandatory
Enter product sku number
size string This field is mandatory
Enter product size . Only number will accept
unit string This field is mandatory
Enter product unit . Available product unit value is
Product unitDescription
BBLBarrels (42 Gallons Ea)
CLRCentiliter
DOZDozen
GALGallons (US)
GGrams
KGKilograms
KLKiloliter
LLiters
TMetric Ton
MCGMicrograms
MGMilligrams
MLMilliliters
FOZOunces fluid
OZOunces weight (avdp)
PCSPieces
PTLPints liquid (US)
LBPounds (avdp)
QTLQuarts liquid (US)
package string This field is mandatory
Enter product package . Available product unit value is
Product packageDescription
BGBag
BLBale Compressed
BNBale Non-Compressed
BABarrel (Container)
BKBasket
BIBin
BSBottle Non-Prot Bulbous
BOBottle Non-Protected Cyl
BVBottle Protected Bulbous
BQBottle Protected Cylnd
BXBox
BJBucket
VLBulk Liquid
VYBulk Solid Fine Particle
VRBulk Solid Granular Parti
VOBulkSolidLg Particles
CXCan Cylindrical
CACan Rectangular
CTCarton
CTRCartridge
CSCase
CONContainer
CRCrate
FCCrate Fruit
MCCrate Milk
DRDrum
INGIngot
JRJar
JGJug
KEGKeg
KITKit
PKPackage
PAPacket
PLPail
POPouch
SYSyringe
TNTin
PUTray or Tray Pack
TBTub
TUTube
fda_code string This field is mandatory
Enter U.S. FDA product code . Please note this’s not the same number of local FDA number . You can find your U.S. FDA product code here
common_name string This field is mandatory
Enter product common name , market name or well-known name
quantity string This field is mandatory
Enter product quantity . Only number will accept
send_from string This field is mandatory
Enter the country iso code which product will dispatch from

Retrieves country code from Country Code API

Country Code

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/countryCode?country_name=afghanistan")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body

import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/countryCode?country_name=afghanistan", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/countryCode?country_name=afghanistan' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/countryCode?country_name=afghanistan',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this:

{
    "success": true,
    "country": {
        "name": "Afghanistan",
        "code": "AF"
    }
}

HTTP Request

GET https://api.fda.express/api/v1/countryCode

Query Parameters

Parameter Type Description
country_name string Country name (if not set api will return all country)

Country Subdivisions

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/countrySubdivisions?country_code=us")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body


import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/countrySubdivisions?country_code=us", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/countrySubdivisions?country_code=us' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/countrySubdivisions?country_code=us',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});


The above command returns JSON structured like this (example):

{
    "success": true,
    "countrySubdivisions": [
        {
            "name": "Howland Island",
            "code": "US-UM-84"
        },
        {
            "name": "Delaware",
            "code": "US-DE"
        },
        {
            "name": "Alaska",
            "code": "US-AK"
        }
    ]
}

HTTP Request

GET https://api.fda.express/api/v1/countrySubdivisions

Query Parameters

Parameter Type Description
country_code string iso2 country code

U.S. State alpha code

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/usState")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body

import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/usState", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/usState' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/usState',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this (example):

{
    "success": true,
    "state": [
        {
            "name": "Howland Island",
            "code": "UM-84"
        },
        {
            "name": "Delaware",
            "code": "DE"
        },
        {
            "name": "Alaska",
            "code": "AK"
        }
    ]
}

HTTP Request

GET https://api.fda.express/api/v1/usState

U.S. Port code

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/usPortCode")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body

import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/usPortCode", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/usPortCode' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/usPortCode',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this (example):

{
    "success": true,
    "port_code": [
        {
            "port_state": "Addison Airport",
            "port_name": "Texas",
            "port_code": "5584"
        },
        {
            "port_state": "Aguadilla",
            "port_name": "Puerto Rico",
            "port_code": "4901"
        },
        {
            "port_state": "Albany",
            "port_name": "New York",
            "port_code": "1002"
        }
    ]
}

HTTP Request

GET https://api.fda.express/api/v1/usPortCode

Query Parameters

If query parameters is not set api will return all US port code

Parameter Type Description
port_state string state name
port_name string port name

Airline IATA code

require "uri"
require "net/http"

url = URI("https://api.fda.express/api/v1/iata?country=japan")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)
request["api-key"] = "aaaaaaaa-bbbbbbbb-cccccccc-dddddddd"

response = https.request(request)
puts response.read_body

import http.client

conn = http.client.HTTPSConnection("api.fda.express")
payload = ''
headers = {
  'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
}
conn.request("GET", "/api/v1/iata?country=japan", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
curl --location --request GET 'https://api.fda.express/api/v1/iata?country=japan' \
--header 'api-key: aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://api.fda.express/api/v1/iata?country=japan',
  'headers': {
    'api-key': 'aaaaaaaa-bbbbbbbb-cccccccc-dddddddd'
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

The above command returns JSON structured like this (example):

{
    "success": true,
    "iata": [
        {
            "iata": "9N",
            "icao": "AJV",
            "Airline": "ANA & JP Express",
            "Callsign": "AYJAY CARGO",
            "Country": "Japan"
        },
        {
            "iata": "NV",
            "icao": "CRF",
            "Airline": "Air Central",
            "Callsign": "AIR CENTRAL",
            "Country": "Japan"
        },
        {
            "iata": "NQ",
            "icao": "AJX",
            "Airline": "Air Japan",
            "Callsign": "AIR JAPAN",
            "Country": "Japan"
        }
    ]
}

HTTP Request

GET https://api.fda.express/api/v1/iata

Query Parameters

If query parameters is not set api will return all iata

Parameter Type Description
icao string
airline_name string
callsign string
country string