API Documentation - NMFC Lookup

Introduction

The NMFC Lookup API provides programmatic access to the National Motor Freight Classification database, Amazon drop point locations, ABF Freight location data, and Central Transport terminal data. All endpoints share a single, consistent REST interface.

Base URL

https://freightapi.dev/api

Response Format

JSON

Authentication

Bearer token

All requests must include a valid API key. Requests without authentication will return 401 Unauthorized.

Authentication

Authenticate by passing your API key in the Authorization header as a Bearer token. API keys are prefixed with nmfc_live_.

Request Header

Authorization: Bearer YOUR_API_KEY

You can generate and manage API keys from your dashboard after signing up. Each key is displayed only once at creation time — store it securely.

curl

curl https://freightapi.dev/api/article/63321 \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

Rate Limits

API usage is metered monthly per account. When you exceed your plan's limit the API returns 429 Too Many Requests. Limits reset on the first day of each calendar month (UTC).

Plan	Requests / Month	Notes
Free	5	Good for prototyping
Starter	1,000	For developers building freight tools
Pro	5,000	Production workloads
Enterprise	Unlimited	SLA + priority support

Every API response includes the following rate-limit headers:

Header	Description
`X-RateLimit-Limit`	Maximum requests allowed in the current period
`X-RateLimit-Remaining`	Requests remaining in the current period

Error Codes

The API uses standard HTTP status codes. Error responses always include a JSON body with an error field containing a human-readable message.

Error response

{
  "error": "Invalid API key"
}

Status	Meaning	Description
200	OK	Request succeeded
400	Bad Request	Invalid parameters or malformed request body
401	Unauthorized	Missing or invalid API key
403	Forbidden	Your current plan does not include access to this endpoint
404	Not Found	The requested resource does not exist
429	Rate Limit Exceeded	You have exceeded your monthly request quota
500	Internal Server Error	An unexpected error occurred on our end

POST /api/search

Search Articles

Full-text search across NMFC articles by keyword, item number, or description fragment. Returns paginated results sorted by relevance.

Request Body

Parameter	Type	Description
`q` required	`string`	Search query. Minimum 3 characters. Matches article number, description, and grouping name.
`page` optional	`number`	Page number for pagination. Defaults to 1.

Response Fields

Field	Type	Description
`results`	`array`	Array of matching article objects
`total`	`number`	Total number of matching articles
`page`	`number`	Current page number
`totalPages`	`number`	Total number of pages
`results[].article_number`	`string`	NMFC article number
`results[].description`	`string`	Article description
`results[].grouping_name`	`string`	Commodity grouping name
`results[].classification`	`string`	Freight classification (e.g., "50", "55", "70")
`results[].is_canceled`	`boolean`	Whether the article has been canceled

Code Examples

curl -X POST https://freightapi.dev/api/search \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"q": "frozen food", "page": 1}'

const response = await fetch('https://freightapi.dev/api/search', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ q: 'frozen food', page: 1 }),
});

const data = await response.json();
// data.results, data.total, data.page, data.totalPages

import requests

response = requests.post(
    'https://freightapi.dev/api/search',
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
    json={'q': 'frozen food', 'page': 1},
)

data = response.json()
# data['results'], data['total'], data['page'], data['totalPages']

{
  "article": {
    "articles": [
      {
        "article_number": "63321",
        "description": "Televisions (TVs) or Video, Computer or Multimedia Monitors or Displays, NOI, see Note, item 63324, in boxes or Packages 829, 979, 2320 or 2396:",
        "grouping_name": "ELECTRICAL EQUIPMENT GROUP",
        "classification": "",
        "is_canceled": 0
      }
    ],
    "totalMatch": 3
  },
  "totalPages": 1,
  "currentPage": 1,
  "success": true
}

GET /api/article/:num

Get Article

Retrieve complete article data for a single NMFC article, including all sub-items, density classifications, hazardous flags, and cross-reference notes.

URL Parameters

Parameter	Type	Description
`num` required	`string`	NMFC article number (e.g., 63321). Include only the base number, not the sub-item suffix.

Response Fields

Field	Type	Description
`article_number`	`string`	NMFC article number
`description`	`string`	Full article description
`grouping_name`	`string`	Commodity grouping name
`classification`	`string`	Freight class when no sub-items are present
`is_hazardous`	`boolean`	Whether the article is classified as hazardous material
`is_special_handling`	`boolean`	Whether the article requires special handling
`is_canceled`	`boolean`	Whether the article has been canceled
`canceled_reference`	`string \| null`	Replacement article number, if canceled
`note_references`	`string[]`	Array of note identifiers that apply to this article
`tariff_issue`	`string`	Tariff issue number that introduced or last modified this article
`supplement`	`string \| null`	Supplement identifier, if applicable
`subItems`	`array`	List of sub-item objects (see below)
`subItems[].item`	`string`	Sub-item suffix (e.g., "00", "01")
`subItems[].description`	`string`	Sub-item description detailing density or packaging conditions
`subItems[].classification`	`string`	Freight class for this sub-item
`subItems[].sort_order`	`number`	Display ordering index

Code Examples

curl https://freightapi.dev/api/article/63321 \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch('https://freightapi.dev/api/article/63321', {
  headers: {
    'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
  },
});

const article = await response.json();
// article.article_number, article.subItems[], ...

import requests

response = requests.get(
    'https://freightapi.dev/api/article/63321',
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

article = response.json()

{
  "success": true,
  "article": {
    "articleNumber": "63321",
    "description": "Televisions (TVs) or Video, Computer or Multimedia Monitors or Displays, NOI, see Note, item 63324, in boxes or Packages 829, 979, 2320 or 2396:",
    "grouping": "ELECTRICAL EQUIPMENT GROUP",
    "subGrouping": null,
    "tariffIssue": "AY",
    "supplement": "1",
    "classification": "",
    "isHazardous": false,
    "isSpecialHandling": true,
    "isCanceled": false,
    "canceledReference": null,
    "noteReferences": ["63324"],
    "articleSubItems": [
      { "item": "Sub 1", "description": "In authorized packages as specified in Note, item 63322, subject to Item 170 and having a density in pounds per cubic foot of:", "classification": "" },
      { "item": "Sub 2", "description": "Less than 4", "classification": "400" },
      { "item": "Sub 3", "description": "4 but less than 8", "classification": "175" },
      { "item": "Sub 4", "description": "8 or greater", "classification": "110" },
      { "item": "Sub 5", "description": "In authorized packages other than as specified in Note, item 63322, subject to Item 170 and having a density in pounds per cubic foot of:", "classification": "" },
      { "item": "Sub 6", "description": "Less than 4", "classification": "300" },
      { "item": "Sub 7", "description": "4 but less than 8", "classification": "150" },
      { "item": "Sub 8", "description": "8 or greater", "classification": "100" }
    ]
  }
}

GET /api/rule/:num

Get Rule

Retrieve the full text of a single NMFC rule by its rule number, including all sub-headings and structured description blocks. Requires a Pro or higher plan.

Pro+ required

URL Parameters

Parameter	Type	Description
`num` required	`string`	NMFC rule number (3–6 characters, e.g., 100). Must match a valid rule in the tariff.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`rule`	`object`	The rule object
`rule.ruleNumber`	`string`	NMFC rule number
`rule.ruleHeader`	`string`	Short title / header of the rule
`rule.ruleSubHeading`	`string`	Secondary heading providing additional context
`rule.ruleDescriptions`	`array`	Ordered list of description blocks
`rule.ruleDescriptions[].type`	`string`	Block type identifier (e.g., "paragraph", "list")
`rule.ruleDescriptions[].title`	`string`	Optional title for the block
`rule.ruleDescriptions[].text`	`string`	Full text content of the block

Code Examples

curl https://freightapi.dev/api/rule/100 \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch('https://freightapi.dev/api/rule/100', {
  headers: {
    'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
  },
});

const data = await response.json();
// data.rule.ruleNumber, data.rule.ruleDescriptions[], ...

import requests

response = requests.get(
    'https://freightapi.dev/api/rule/100',
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

data = response.json()
# data['rule']['ruleNumber'], data['rule']['ruleDescriptions'], ...

{
  "success": true,
  "rule": {
    "ruleNumber": "110",
    "ruleHeader": "",
    "ruleSubHeading": null,
    "ruleDescriptions": [
      {
        "type": "generic",
        "title": "",
        "text": "The following definitions will apply when such terms are used in this Classification..."
      },
      {
        "type": "sec",
        "title": "Sec. 1.",
        "text": "'Carrier,' 'Consignee,' 'Consignor' or 'Shipper' includes the authorized representatives or agents..."
      },
      {
        "type": "sec",
        "title": "Sec. 8. (a)",
        "text": "To determine the density of a handling unit, first determine the cubage..."
      }
    ]
  }
}

GET /api/package/:num

Get Package

Retrieve the full details of a single NMFC package definition by its package number, including the applicable tariff issue and all structured description blocks. Requires a Pro or higher plan.

Pro+ required

URL Parameters

Parameter	Type	Description
`num` required	`string`	NMFC package number (2–6 characters, e.g., 10). Must match a valid package in the tariff.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`package`	`object`	The package object
`package.packageNumber`	`string`	NMFC package number
`package.packageHeader`	`string`	Short title / header of the package definition
`package.tariffIssue`	`string`	Tariff issue number that introduced or last modified this package
`package.packageDescriptions`	`array`	Ordered list of description blocks
`package.packageDescriptions[].type`	`string`	Block type identifier (e.g., "paragraph", "list")
`package.packageDescriptions[].title`	`string`	Optional title for the block
`package.packageDescriptions[].text`	`string`	Full text content of the block

Code Examples

curl https://freightapi.dev/api/package/10 \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch('https://freightapi.dev/api/package/10', {
  headers: {
    'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
  },
});

const data = await response.json();
// data.package.packageNumber, data.package.packageDescriptions[], ...

import requests

response = requests.get(
    'https://freightapi.dev/api/package/10',
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

data = response.json()
# data['package']['packageNumber'], data['package']['packageDescriptions'], ...

{
  "success": true,
  "package": {
    "packageNumber": "829",
    "packageHeader": "Package 829",
    "tariffIssue": "AY",
    "packageDescriptions": [
      {
        "type": "description",
        "title": "",
        "text": "In fiberboard boxes complying with Item 222..."
      }
    ]
  }
}

GET /api/history/:num

Get Article Change History

Retrieve the complete change history for a single NMFC article, including every docket, issued date, subject line, and granular change detail records. Requires a Pro or higher plan.

Pro+ required

URL Parameters

Parameter	Type	Description
`num` required	`string`	NMFC article number (3–10 characters, e.g., 63321). Include only the base number, not the sub-item suffix.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`articleNumber`	`string`	The queried NMFC article number
`articleChangeHistoryDetails`	`array`	Ordered list of change history entries
`articleChangeHistoryDetails[].docket`	`string`	Docket identifier associated with this change
`articleChangeHistoryDetails[].issuedDate`	`string`	ISO 8601 date the change was issued
`articleChangeHistoryDetails[].subject`	`string`	Short description of the change subject
`articleChangeHistoryDetails[].quickView`	`string`	One-line summary of the change for display purposes
`articleChangeHistoryDetails[].changeDetails`	`array`	Granular list of individual changes within this entry
`articleChangeHistoryDetails[].changeDetails[].description`	`string`	Narrative description of the individual change
`articleChangeHistoryDetails[].changeDetails[].typeOfProvision`	`string`	Category of provision affected (e.g., "Item", "Note")
`articleChangeHistoryDetails[].changeDetails[].item`	`string`	Primary item identifier affected by the change
`articleChangeHistoryDetails[].changeDetails[].alternateItem`	`string`	Alternate or replacement item number, if applicable
`articleChangeHistoryDetails[].changeDetails[].action`	`string`	Type of action taken (e.g., "Added", "Amended", "Canceled")

Code Examples

curl https://freightapi.dev/api/history/63321 \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch('https://freightapi.dev/api/history/63321', {
  headers: {
    'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
  },
});

const data = await response.json();
// data.articleNumber, data.articleChangeHistoryDetails[], ...

import requests

response = requests.get(
    'https://freightapi.dev/api/history/63321',
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

data = response.json()
# data['articleNumber'], data['articleChangeHistoryDetails'], ...

{
  "success": true,
  "articleNumber": "63321",
  "articleChangeHistoryDetails": [
    {
      "docket": "2024-2",
      "issuedDate": "2024-05-15",
      "subject": "1",
      "quickView": "Classification amended",
      "changeDetails": [
        {
          "description": "Sub-item classifications updated",
          "typeOfProvision": "Article",
          "item": "63321",
          "alternateItem": "",
          "action": "Amend"
        }
      ]
    }
  ]
}

POST /api/density

Density Calculator

Calculate freight density from dimensions and weight. Supports multiple handling units, various dimension units (Inch, Feet, Centimeter, Meter), and weight units (Pound, Kilogram).

Pro plan required

Request Body

Parameter	Type	Required
`dimensionType` required	`string`	Inch, Feet, Centimeter, or Meter
`weightType` required	`string`	Pound or Kilogram
`resultUnitType` required	`string`	PoundsPerCubicFeet or KilogramPerCubicMeter
`unitDimensions` required	`array`	Array of unit dimension objects
`unitDimensions[].HandlingUnitCount` required	`number`	Number of identical handling units
`unitDimensions[].length` required	`number`	Length in specified dimension unit
`unitDimensions[].width` required	`number`	Width in specified dimension unit
`unitDimensions[].height` required	`number`	Height in specified dimension unit
`unitDimensions[].handlingUnitWeight` required	`number`	Total weight of all units combined

Response

Field	Type	Description
`totalHandlingUnitCount`	`number`	Sum of all handling unit counts
`totalHandlingUnitCountVolume`	`number`	Total volume in result units
`totalHandlingUnitWeight`	`number`	Total weight in result units
`totalDensity`	`number`	Overall density (weight / volume)
`unitDimensions[]`	`array`	Per-unit breakdown with volume and density

Examples

curl -X POST https://freightapi.dev/api/density \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "dimensionType": "Inch",
    "weightType": "Pound",
    "resultUnitType": "PoundsPerCubicFeet",
    "unitDimensions": [{
      "HandlingUnitCount": 1,
      "length": 48, "width": 40, "height": 36,
      "handlingUnitWeight": 500
    }]
  }'

const response = await fetch('https://freightapi.dev/api/density', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    dimensionType: 'Inch',
    weightType: 'Pound',
    resultUnitType: 'PoundsPerCubicFeet',
    unitDimensions: [{
      HandlingUnitCount: 1,
      length: 48, width: 40, height: 36,
      handlingUnitWeight: 500,
    }],
  }),
});

const data = await response.json();
// data.totalDensity, data.unitDimensions[], ...

import requests

response = requests.post(
    'https://freightapi.dev/api/density',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'dimensionType': 'Inch',
        'weightType': 'Pound',
        'resultUnitType': 'PoundsPerCubicFeet',
        'unitDimensions': [{
            'HandlingUnitCount': 1,
            'length': 48, 'width': 40, 'height': 36,
            'handlingUnitWeight': 500,
        }],
    },
)

data = response.json()
# data['totalDensity'], data['unitDimensions'], ...

{
  "success": true,
  "unitDimensions": [
    {
      "handlingUnitCount": 1,
      "length": 48, "width": 40, "height": 36,
      "handlingUnitCountVolume": 40,
      "handlingUnitWeight": 500,
      "density": 12.5
    }
  ],
  "totalHandlingUnitCount": 1,
  "totalHandlingUnitCountVolume": 40,
  "totalHandlingUnitWeight": 500,
  "totalDensity": 12.5
}

POST /api/item680/:type

Item 680 Calculator

NMFC Item 680 Note calculators for determining freight class by volume, area, or dimension ratio. Three calculator types available: 2a (Volume), 2b (Area), 2c (Ratio).

Pro plan required

URL Parameter

Type	Endpoint	Description
2a	POST /api/item680/2a	Volume: commodity vs package volume comparison
2b	POST /api/item680/2b	Area: commodity vs handling platform area comparison
2c	POST /api/item680/2c	Ratio: height to shortest dimension ratio calculation

Note 2A Request Body (Volume)

Parameter	Type	Description
`commodity.length` required	`number`	Commodity length
`commodity.width` required	`number`	Commodity width
`commodity.height` required	`number`	Commodity height
`package.length` required	`number`	Package length
`package.width` required	`number`	Package width
`package.height` required	`number`	Package height

Response: commodityVolume, packageVolume, percentageVolumeOccupiedByCommodity, isBelowThreshold

Note 2B Request Body (Area)

Parameter	Type	Description
`commodity.length` required	`number`	Commodity length
`commodity.width` required	`number`	Commodity width
`handlingPlatformType.length` required	`number`	Platform length
`handlingPlatformType.width` required	`number`	Platform width

Response: commodityArea, liftArea, percentageSurfaceAreaOccupiedByCommodity, isBelowThreshold

Note 2C Request Body (Ratio)

Parameter	Type	Description
`length` required	`number`	Commodity length
`width` required	`number`	Commodity width (shortest dimension)
`height` required	`number`	Commodity height
`liftLength` required	`number`	Lift platform length
`liftWidth` required	`number`	Lift platform width

Response: ratio, isAboveThreshold, maximumAllowableCalculations

Examples

# Note 2A — Volume comparison
curl -X POST https://freightapi.dev/api/item680/2a \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "commodity": {"length": 46, "width": 40, "height": 330},
    "package": {"length": 48, "width": 40, "height": 35}
  }'

# Note 2B — Area comparison
curl -X POST https://freightapi.dev/api/item680/2b \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "commodity": {"length": 38, "width": 32},
    "handlingPlatformType": {"length": 40, "width": 40}
  }'

# Note 2C — Dimension ratio
curl -X POST https://freightapi.dev/api/item680/2c \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"length":50,"width":42,"height":62,"liftLength":52,"liftWidth":45}'

// Note 2A — Volume comparison
const res2a = await fetch('https://freightapi.dev/api/item680/2a', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    commodity: { length: 46, width: 40, height: 330 },
    package: { length: 48, width: 40, height: 35 },
  }),
});

// Note 2B — Area comparison
const res2b = await fetch('https://freightapi.dev/api/item680/2b', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    commodity: { length: 38, width: 32 },
    handlingPlatformType: { length: 40, width: 40 },
  }),
});

// Note 2C — Dimension ratio
const res2c = await fetch('https://freightapi.dev/api/item680/2c', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ length: 50, width: 42, height: 62, liftLength: 52, liftWidth: 45 }),
});

import requests

headers = {'Authorization': 'Bearer YOUR_API_KEY'}

# Note 2A — Volume comparison
res2a = requests.post('https://freightapi.dev/api/item680/2a', headers=headers, json={
    'commodity': {'length': 46, 'width': 40, 'height': 330},
    'package': {'length': 48, 'width': 40, 'height': 35},
})

# Note 2B — Area comparison
res2b = requests.post('https://freightapi.dev/api/item680/2b', headers=headers, json={
    'commodity': {'length': 38, 'width': 32},
    'handlingPlatformType': {'length': 40, 'width': 40},
})

# Note 2C — Dimension ratio
res2c = requests.post('https://freightapi.dev/api/item680/2c', headers=headers, json={
    'length': 50, 'width': 42, 'height': 62, 'liftLength': 52, 'liftWidth': 45,
})

// 2A — Volume response
{
  "success": true,
  "commodityVolume": 607200,
  "packageVolume": 67200,
  "percentageVolumeOccupiedByCommodity": 903.57,
  "isBelowThreshold": false
}

GET /api/drop-points?zip=:zip

Get Drop Points by Zip Code

Retrieve Amazon drop-off / pickup locations near a given US zip code, sorted by proximity. Results are paginated (25 per page).

Query Parameters

Parameter	Type	Description
`zip` required	`string`	5-digit US zip code (e.g., 90001)
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`zip`	`string`	The queried zip code
`dropPoints`	`array`	List of nearby drop point locations
`dropPoints[].accessPointId`	`string`	Unique UUID identifier for the drop point
`dropPoints[].name`	`string`	Store name (e.g., "Staples-Torrance")
`dropPoints[].chainStoreId`	`string`	Chain store identifier (e.g., CC0090)
`dropPoints[].address`	`object`	Address with line1, city, state, zipCode, country
`dropPoints[].phone`	`string`	Store phone number
`dropPoints[].location`	`object`	Geocode with latitude and longitude
`dropPoints[].timezone`	`string`	IANA timezone (e.g., US/Pacific)
`dropPoints[].operatingHours`	`object`	Weekly operating hours keyed by day name
`dropPoints[].email`	`string`	Store contact email
`dropPoints[].type`	`string`	Access point type (e.g., HELIX)
`dropPoints[].isStaffAssisted`	`boolean`	Whether staff assistance is available
`dropPoints[].tags`	`array`	Tags (e.g., ["Store"])
`total`	`integer`	Total number of matching drop points
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapi.dev/api/drop-points?zip=90001" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch(
  'https://freightapi.dev/api/drop-points?zip=90001',
  {
    headers: {
      'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
    },
  }
);

const data = await response.json();
// data.dropPoints[], data.total, data.currentPage

import requests

response = requests.get(
    'https://freightapi.dev/api/drop-points',
    params={'zip': '90001'},
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

data = response.json()
# data['dropPoints'], data['total']

{
  "success": true,
  "zip": "90001",
  "dropPoints": [
    {
      "accessPointId": "deade3db-2d3a-4ccb-9983-0c695dfbc06a",
      "name": "Staples-Huntington Park",
      "chainStoreId": "CC1367",
      "address": {
        "line1": "3090 E Slauson Ave",
        "city": "Huntington Park",
        "state": "CA",
        "zipCode": "90255",
        "country": "US"
      },
      "phone": "3232773706",
      "location": {
        "latitude": 33.988582,
        "longitude": -118.21314
      },
      "timezone": "US/Pacific",
      "operatingHours": { "MONDAY": { "...": "..." }, "...": "..." },
      "email": "print.marketing1367@Staples.com",
      "type": "HELIX",
      "isStaffAssisted": false,
      "tags": ["Store"]
    }
  ],
  "total": 31,
  "currentPage": 1,
  "totalPages": 2
}

GET /api/drop-points/:id

Get Drop Point Detail

Retrieve full details for a single Amazon drop point by its unique access point ID.

URL Parameters

Parameter	Type	Description
`id` required	`string`	UUID of the access point (e.g., deade3db-2d3a-4ccb-9983-0c695dfbc06a)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`dropPoint`	`object`	Full drop point object (same structure as items in the dropPoints array above)

Code Examples

curl https://freightapi.dev/api/drop-points/deade3db-2d3a-4ccb-9983-0c695dfbc06a \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const id = 'deade3db-2d3a-4ccb-9983-0c695dfbc06a';
const response = await fetch(
  `https://freightapi.dev/api/drop-points/${id}`,
  {
    headers: {
      'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
    },
  }
);

const data = await response.json();
// data.dropPoint.name, data.dropPoint.address, ...

import requests

point_id = 'deade3db-2d3a-4ccb-9983-0c695dfbc06a'
response = requests.get(
    f'https://freightapi.dev/api/drop-points/{point_id}',
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

data = response.json()
# data['dropPoint']['name'], data['dropPoint']['address']

{
  "success": true,
  "dropPoint": {
    "accessPointId": "deade3db-2d3a-4ccb-9983-0c695dfbc06a",
    "name": "Staples-Huntington Park",
    "chainStoreId": "CC1367",
    "address": {
      "line1": "3090 E Slauson Ave",
      "city": "Huntington Park",
      "state": "CA",
      "zipCode": "90255",
      "country": "US"
    },
    "phone": "3232773706",
    "location": { "latitude": 33.988582, "longitude": -118.21314 },
    "timezone": "US/Pacific",
    "operatingHours": {
      "MONDAY": { "openingTime": { "hourOfDay": 8 }, "closingTime": { "hourOfDay": 21 } },
      "SUNDAY": { "openingTime": { "hourOfDay": 10 }, "closingTime": { "hourOfDay": 18 } }
    },
    "email": "print.marketing1367@Staples.com",
    "type": "HELIX",
    "isStaffAssisted": false,
    "isFeatured": false,
    "tags": ["Store"]
  }
}

GET /api/drop-points/search?q=:query

Search Drop Points

Search Amazon drop points by name or city. Returns paginated results matching the keyword. Requires a Pro or higher plan.

Pro+ required

Query Parameters

Parameter	Type	Description
`q` required	`string`	Search keyword (minimum 2 characters). Matches against store name and city.
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`query`	`string`	The search keyword used
`dropPoints`	`array`	Matching drop point objects
`total`	`integer`	Total number of matching results
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapi.dev/api/drop-points/search?q=Torrance" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch(
  'https://freightapi.dev/api/drop-points/search?q=Torrance',
  {
    headers: {
      'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx',
    },
  }
);

const data = await response.json();
// data.dropPoints[], data.total

import requests

response = requests.get(
    'https://freightapi.dev/api/drop-points/search',
    params={'q': 'Torrance'},
    headers={'Authorization': 'Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx'},
)

data = response.json()
# data['dropPoints'], data['total']

{
  "success": true,
  "query": "Torrance",
  "dropPoints": [
    {
      "accessPointId": "85c04198-1c5a-4136-8d6f-b5a5a4b2c6a5",
      "name": "Staples-Torrance",
      "chainStoreId": "CC0090",
      "address": {
        "line1": "2748 Pacific Coast Highway",
        "city": "Torrance",
        "state": "CA",
        "zipCode": "90505",
        "country": "US"
      },
      "phone": "3107842410",
      "location": { "latitude": 33.7928672, "longitude": -118.3349385 },
      "timezone": "US/Pacific",
      "type": "HELIX",
      "isStaffAssisted": false,
      "tags": ["Store"]
    }
  ],
  "total": 1,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/abf-location?zip=:zip&city=:city

ABF Location by ZIP Code

Look up ABF Freight service coverage for a US ZIP code. Returns station info, service type, daily schedule, and transit add-on days.

Query Parameters

Parameter	Type	Description
`zip` required	`string`	5-digit US ZIP code
`city` optional	`string`	City name to disambiguate multi-city ZIPs

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`zip`	`string`	The queried ZIP code
`status`	`string`	served \| multi_city \| not_served
`location`	`object`	Location with station details (when status=served)
`cities`	`array`	Array of candidate cities (when status=multi_city)
`message`	`string`	Human-readable status message

Code Examples

curl "https://freightapi.dev/api/abf-location?zip=00501" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "zip": "00501",
  "status": "served",
  "location": {
    "city": "HOLTSVILLE",
    "state": "NY",
    "zip": "00501",
    "fips": "3635254",
    "isMultiCity": false,
    "station": {
      "number": "219",
      "serviceType": "Direct",
      "scac": null,
      "inboundAddOnDays": 0,
      "outboundAddOnDays": 0,
      "dailyService": {
        "monday": { "pickup": true, "delivery": true },
        "friday": { "pickup": true, "delivery": true }
      }
    }
  }
}

GET /api/abf-location/search?q=:query

Search ABF Locations

Search ABF Freight locations by city or state. Returns paginated results matching the query. Requires a Starter or higher plan.

Starter+ required

Query Parameters

Parameter	Type	Description
`q` required	`string`	Search query (minimum 2 characters). Matches city and state.
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`query`	`string`	The search query used
`locations`	`array`	Matching ABF location objects
`total`	`integer`	Total number of matching results
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapi.dev/api/abf-location/search?q=miami" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "query": "miami",
  "locations": [
    {
      "city": "MIAMI",
      "state": "FL",
      "zip": "33101",
      "station": { "number": "310", "serviceType": "Direct" }
    }
  ],
  "total": 12,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/abf-location/station/:num

Station Lookup

Retrieve all ZIP code locations served by a specific ABF Freight station number. Requires a Pro or higher plan.

Pro+ required

URL Parameters

Parameter	Type	Description
`num` required	`string`	ABF station number
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`stationNumber`	`string`	The queried station number
`locations`	`array`	Array of ABF location objects served by this station
`total`	`integer`	Total number of locations served
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapi.dev/api/abf-location/station/219" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "stationNumber": "219",
  "locations": [
    {
      "city": "HOLTSVILLE",
      "state": "NY",
      "zip": "00501",
      "station": { "number": "219", "serviceType": "Direct" }
    }
  ],
  "total": 84,
  "currentPage": 1,
  "totalPages": 4
}

POST /api/abf-location/batch

Batch ZIP Lookup

Look up ABF Freight coverage for multiple ZIP codes in a single request. Requires a Pro or higher plan.

Pro+ required

Request Body

Parameter	Type	Description
`zips` required	`string[]`	Array of 5-digit ZIP codes. Max 20 for Pro, 50 for Enterprise.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`results`	`object`	Map of ZIP to {status, location}
`summary`	`object`	{served, multi_city, not_served, total}

Code Examples

curl -X POST "https://freightapi.dev/api/abf-location/batch" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"zips": ["00501", "00907", "90001"]}'

{
  "success": true,
  "results": {
    "00501": { "status": "served", "location": { "city": "HOLTSVILLE", "state": "NY" } },
    "00907": { "status": "served", "location": { "city": "SAN JUAN", "state": "PR" } },
    "90001": { "status": "served", "location": { "city": "LOS ANGELES", "state": "CA" } }
  },
  "summary": { "served": 3, "multi_city": 0, "not_served": 0, "total": 3 }
}

GET /api/abf-location/coverage?state=:state

State Coverage

Retrieve ABF Freight service coverage statistics for a US state. Requires a Pro or higher plan.

Pro+ required

Query Parameters

Parameter	Type	Description
`state` required	`string`	2-letter US state code (e.g., TX)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`state`	`string`	The queried state code
`totalLocations`	`integer`	Total number of served locations in the state
`serviceBreakdown`	`object`	{Direct, DirectViaMarketingPartner, Connect}
`unservedZips`	`integer`	Number of ZIP codes in the state with no ABF service

Code Examples

curl "https://freightapi.dev/api/abf-location/coverage?state=TX" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "state": "TX",
  "totalLocations": 1842,
  "serviceBreakdown": {
    "Direct": 1654,
    "DirectViaMarketingPartner": 121,
    "Connect": 67
  },
  "unservedZips": 38
}

GET /api/abf-location/service-days?zip=:zip

Service Days

Retrieve the pickup and delivery schedule for a specific ZIP code. Requires a Starter or higher plan.

Starter+ required

Query Parameters

Parameter	Type	Description
`zip` required	`string`	5-digit US ZIP code
`city` optional	`string`	City name to disambiguate multi-city ZIPs

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`zip`	`string`	The queried ZIP code
`city`	`string`	City name for this location
`state`	`string`	2-letter state code
`schedule`	`object`	7-day pickup/delivery schedule keyed by day name
`nextPickupDay`	`string`	Next available pickup day
`nextDeliveryDay`	`string`	Next available delivery day

Code Examples

curl "https://freightapi.dev/api/abf-location/service-days?zip=47524" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "zip": "47524",
  "city": "BRANCHVILLE",
  "state": "IN",
  "schedule": {
    "monday": { "pickup": true, "delivery": true },
    "tuesday": { "pickup": true, "delivery": true },
    "wednesday": { "pickup": true, "delivery": true },
    "thursday": { "pickup": true, "delivery": true },
    "friday": { "pickup": true, "delivery": true },
    "saturday": { "pickup": false, "delivery": false },
    "sunday": { "pickup": false, "delivery": false }
  },
  "nextPickupDay": "monday",
  "nextDeliveryDay": "monday"
}

GET /api/abf-location/transit-info?origin_zip=:zip&dest_zip=:zip

Transit Info

Retrieve transit add-on day information between an origin and destination ZIP code pair. Requires a Starter or higher plan.

Starter+ required

Query Parameters

Parameter	Type	Description
`origin_zip` required	`string`	5-digit origin ZIP code
`dest_zip` required	`string`	5-digit destination ZIP code

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`origin`	`object`	Origin location details with station info
`destination`	`object`	Destination location details with station info
`totalAddOnDays`	`integer \| null`	Sum of inbound and outbound add-on days, or null if either ZIP is unserved
`bothServed`	`boolean`	Whether both origin and destination are served by ABF

Code Examples

curl "https://freightapi.dev/api/abf-location/transit-info?origin_zip=00501&dest_zip=87012" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "origin": {
    "city": "HOLTSVILLE",
    "state": "NY",
    "zip": "00501",
    "station": { "number": "219", "outboundAddOnDays": 0 }
  },
  "destination": {
    "city": "COYOTE",
    "state": "NM",
    "zip": "87012",
    "station": { "number": "532", "inboundAddOnDays": 1 }
  },
  "totalAddOnDays": 1,
  "bothServed": true
}

GET /api/abf-location/carriers?zip=:zip

Carrier Info

Retrieve carrier and service type details for a ZIP code, including SCAC code, service classification, and add-on day counts. Requires a Pro or higher plan.

Pro+ required

Query Parameters

Parameter	Type	Description
`zip` required	`string`	5-digit US ZIP code
`city` optional	`string`	City name to disambiguate multi-city ZIPs

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`zip`	`string`	The queried ZIP code
`city`	`string`	City name for this location
`state`	`string`	2-letter state code
`serviceType`	`string`	ABF service type (e.g., Direct, Connect)
`carrier`	`object`	{scac, isDirect, isPartner, isConnect}
`addOnDays`	`object`	{inbound, outbound}
`stationNumber`	`string`	Serving ABF station number

Code Examples

curl "https://freightapi.dev/api/abf-location/carriers?zip=87012" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "zip": "87012",
  "city": "COYOTE",
  "state": "NM",
  "serviceType": "Direct",
  "carrier": {
    "scac": null,
    "isDirect": true,
    "isPartner": false,
    "isConnect": false
  },
  "addOnDays": { "inbound": 1, "outbound": 0 },
  "stationNumber": "532"
}

GET /api/ct-location?zip=:zip&city=:city

CT Location by ZIP Code

Look up Central Transport service coverage for a US ZIP code. Returns terminal info, service type, and timezone data.

Query Parameters

Parameter	Type	Description
`zip` required	`string`	5-digit US ZIP code
`city` optional	`string`	City name to disambiguate multi-city ZIPs

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`zip`	`string`	The queried ZIP code
`status`	`string`	served \| multi_city \| not_served
`location`	`object`	Location with terminal details (when status=served)
`cities`	`array`	Array of candidate cities (when status=multi_city)
`message`	`string`	Human-readable status message

Code Examples

curl "https://freightapi.dev/api/ct-location?zip=08807" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "zip": "08807",
  "status": "served",
  "location": {
    "city": "BRIDGEWATER",
    "state": "NJ",
    "zip": "08807",
    "isDirect": true,
    "terminal": {
      "number": "089",
      "city": "NORTH BRUNSWICK",
      "address": "1305 Livingston Avenue",
      "state": "NJ",
      "postalCode": "08902",
      "mapName": "089-NEW BRUNSWICK - NJ",
      "mapUrl": "https://www.centraltransport.com/servicemaps/2021/089-New Brunswick - NJ.pdf"
    },
    "timezone": 0,
    "differenceFromEst": 0
  }
}

GET /api/ct-location/search?q=:query

Search CT Locations

Search Central Transport locations by city or state. Returns paginated results matching the query. Requires a Starter or higher plan.

Starter+ required

Query Parameters

Parameter	Type	Description
`q` required	`string`	Search query (minimum 2 characters). Matches city and state.
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`query`	`string`	The search query used
`locations`	`array`	Matching CT location objects
`total`	`integer`	Total number of matching results
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapi.dev/api/ct-location/search?q=dallas" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "query": "dallas",
  "locations": [
    {
      "city": "DALLAS",
      "state": "TX",
      "zip": "75201",
      "isDirect": true,
      "terminal": { "number": "042", "city": "DALLAS" }
    }
  ],
  "total": 18,
  "currentPage": 1,
  "totalPages": 1
}

GET /api/ct-location/terminal/:num

Terminal Lookup

Retrieve all ZIP code locations served by a specific Central Transport terminal number. Requires a Pro or higher plan.

Pro+ required

URL Parameters

Parameter	Type	Description
`num` required	`string`	CT terminal number
`page` optional	`integer`	Page number for pagination (default: 1)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`terminalNumber`	`string`	The queried CT terminal number
`locations`	`array`	Array of CT location objects served by this terminal
`total`	`integer`	Total number of locations served
`currentPage`	`integer`	Current page number
`totalPages`	`integer`	Total number of pages

Code Examples

curl "https://freightapi.dev/api/ct-location/terminal/089" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "terminalNumber": "089",
  "locations": [
    {
      "city": "BRIDGEWATER",
      "state": "NJ",
      "zip": "08807",
      "isDirect": true,
      "terminal": { "number": "089", "city": "NORTH BRUNSWICK" }
    }
  ],
  "total": 97,
  "currentPage": 1,
  "totalPages": 5
}

POST /api/ct-location/batch

Batch ZIP Lookup

Look up Central Transport coverage for multiple ZIP codes in a single request. Requires a Pro or higher plan.

Pro+ required

Request Body

Parameter	Type	Description
`zips` required	`string[]`	Array of 5-digit ZIP codes. Max 20 for Pro, 50 for Enterprise.

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`results`	`object`	Map of ZIP to {status, location}
`summary`	`object`	{served, multi_city, not_served, total}

Code Examples

curl -X POST "https://freightapi.dev/api/ct-location/batch" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"zips": ["08807", "75201", "90001"]}'

{
  "success": true,
  "results": {
    "08807": { "status": "served", "location": { "city": "BRIDGEWATER", "state": "NJ" } },
    "75201": { "status": "served", "location": { "city": "DALLAS", "state": "TX" } },
    "90001": { "status": "served", "location": { "city": "LOS ANGELES", "state": "CA" } }
  },
  "summary": { "served": 3, "multi_city": 0, "not_served": 0, "total": 3 }
}

GET /api/ct-location/coverage?state=:state

State Coverage

Retrieve Central Transport service coverage statistics for a US state. Requires a Pro or higher plan.

Pro+ required

Query Parameters

Parameter	Type	Description
`state` required	`string`	2-letter US state code (e.g., NJ)

Response Fields

Field	Type	Description
`success`	`boolean`	Indicates whether the request succeeded
`state`	`string`	The queried state code
`totalZips`	`integer`	Total number of ZIP codes queried in the state
`directService`	`integer`	Number of ZIPs with direct CT service
`indirectService`	`integer`	Number of ZIPs with indirect CT service

Code Examples

curl "https://freightapi.dev/api/ct-location/coverage?state=NJ" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

{
  "success": true,
  "state": "NJ",
  "totalZips": 612,
  "directService": 543,
  "indirectService": 41
}