Developer Reference

Amazon Drop Points

Find Amazon pickup and return locations by zip code or keyword. Includes addresses, hours, and coordinates.

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://freightapis.dev/api/drop-points?zip=90001" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch(
  'https://freightapis.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://freightapis.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://freightapis.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://freightapis.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://freightapis.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.

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://freightapis.dev/api/drop-points/search?q=Torrance" \
  -H "Authorization: Bearer nmfc_live_xxxxxxxxxxxxxxxxxxxx"

const response = await fetch(
  'https://freightapis.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://freightapis.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
}