{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/usps/json-schema/usps-drop-shipment-location-schema.json",
  "title": "Parcel Drop Shipment Facility Location",
  "description": "USPS® Destination Entry Drop Shipment Location",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/usps-locations-openapi.yml#/components/schemas/DropShipmentLocation",
  "type": "object",
  "properties": {
    "dropShipmentKey": {
      "type": "string",
      "description": "the unique identifier for the facility."
    },
    "facilityName": {
      "type": "string",
      "description": "The name of the facility."
    },
    "facilityAddress": {
      "type": "object",
      "properties": {
        "address": {
          "$ref": "#/$defs/DomesticAddress"
        }
      }
    },
    "dropSitePhoneNumber": {
      "pattern": "\\d{10}",
      "type": "string",
      "description": "The phone number for the facility."
    },
    "destinationZIPCode": {
      "$ref": "#/$defs/ZIPCode"
    },
    "destinationEntryFacilityType": {
      "type": "string",
      "description": "The destination entry service accepted at the facility.\n\nNote:\n* Effective 01/18/2026: `DESTINATION_NETWORK_DISTRIBUTION_CENTER` with `PARCEL_SELECT` is no longer eligible.\n* Effective 01/18/2026: (NSA Only) `DESTINATION_REGIONAL_PROCESSING_DISTRIBUTION_CENTER` with `PARCEL_SELECT` is available as an option.",
      "enum": [
        "DESTINATION_NETWORK_DISTRIBUTION_CENTER",
        "DESTINATION_SECTIONAL_CENTER_FACILITY",
        "DESTINATION_SERVICE_HUB",
        "DESTINATION_DELIVERY_UNIT",
        "DESTINATION_REGIONAL_PROCESSING_DISTRIBUTION_CENTER"
      ]
    },
    "acceptedPackageTypes": {
      "type": "array",
      "description": "Accepted Package Types at USPS® Destination Entry Drop Shipment Location.",
      "items": {
        "$ref": "#/$defs/AcceptedPackageTypes"
      }
    },
    "dropShipAcceptanceTimes": {
      "type": "array",
      "description": "The available acceptance times and days for drop shipments.",
      "items": {
        "$ref": "#/$defs/HoursOfOperation"
      }
    },
    "dropShipmentFacilityDetails": {
      "$ref": "#/$defs/FacilityDetails"
    },
    "USPSConnectDetails": {
      "$ref": "#/$defs/USPSConnect"
    },
    "timeZone": {
      "type": "string",
      "description": "The time zone returned for a given facility."
    },
    "DSTObserved": {
      "type": "boolean",
      "description": "Indicator for whether Daylight Savings Time is observed for a given facility."
    }
  },
  "additionalProperties": false,
  "$defs": {
    "AcceptedPackageTypes": {
      "title": "Package Types Accepted",
      "type": "object",
      "properties": {
        "mailClass": {
          "maxLength": 25,
          "minLength": 0,
          "type": "string",
          "description": "The mail class accepted at the facility",
          "enum": [
            "PARCEL_SELECT",
            "PARCEL_SELECT_LIGHTWEIGHT",
            "USPS_CONNECT_LOCAL",
            "USPS_CONNECT_MAIL",
            "USPS_CONNECT_REGIONAL",
            "LIBRARY_MAIL",
            "MEDIA_MAIL",
            "BOUND_PRINTED_MATTER"
          ]
        },
        "processingCategory": {
          "maxLength": 25,
          "minLength": 0,
          "type": "string",
          "description": "Designates what shape the facility accepts for packages. For more information on package shapes see the [Physical Standards for Parcels](https://pe.usps.com/text/dmm300/201.htm#ep1097220).\n\n Note:\n - `IRREGULAR` is unsupported as of 2/1/2025 and will no longer return.\n - `NON_MACHINABLE` is unsupported as of 2/1/2025 and will no longer return.\n",
          "enum": [
            "FLATS",
            "MACHINABLE",
            "IRREGULAR",
            "NON_MACHINABLE",
            "NONSTANDARD"
          ]
        },
        "palletized": {
          "maxLength": 25,
          "minLength": 0,
          "type": "string",
          "description": "Designates whether the facility accepts palletized, non-palletized, or both.",
          "enum": [
            "PALLETIZED",
            "NON_PALLETIZED",
            "BOTH"
          ]
        }
      },
      "additionalProperties": false,
      "description": "Accepted Package Types at USPS® Destination Entry Drop Shipment Location."
    },
    "Address": {
      "title": "Address",
      "type": "object",
      "properties": {
        "streetAddress": {
          "maxLength": 50,
          "minLength": 1,
          "type": "string",
          "description": "The number of a building along with the name of the road or street on which it is located."
        },
        "streetAddressAbbreviation": {
          "maxLength": 50,
          "minLength": 0,
          "type": "string",
          "description": "This is the abbreviation of street address line for the address.",
          "readOnly": true
        },
        "secondaryAddress": {
          "maxLength": 50,
          "type": "string",
          "description": "The secondary unit designator, such as apartment(APT) or suite(STE) number, defining the exact location of the address within a building.  For more information please see [Postal Explorer](https://pe.usps.com/text/pub28/28c2_003.htm)."
        },
        "cityAbbreviation": {
          "type": "string",
          "description": "This is the abbreviation of city name for the address.",
          "readOnly": true
        }
      },
      "additionalProperties": true,
      "description": "Address fields standard to all locations."
    },
    "CutOffTimesDropOff": {
      "type": "object",
      "properties": {
        "dayOfWeek": {
          "type": "string",
          "description": "The day of the week for the cut off time.",
          "enum": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY",
            "SATURDAY",
            "SUNDAY",
            "HOLIDAY"
          ]
        },
        "cutOffTime": {
          "type": "string",
          "description": "The cut off time represented in military time."
        }
      },
      "additionalProperties": false,
      "description": "The latest supported drop off times to receive Connect Local® Same/Next Day service."
    },
    "CutOffTimesPickup": {
      "type": "object",
      "properties": {
        "dayOfWeek": {
          "type": "string",
          "description": "The day of the week for the cut off time.",
          "enum": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY",
            "SATURDAY",
            "SUNDAY",
            "HOLIDAY"
          ]
        },
        "cutOffTime": {
          "type": "string",
          "description": "The cut off time represented in military time."
        }
      },
      "additionalProperties": false,
      "description": "The latest supported carrier pickup time to receive Connect Local® Same Day service."
    },
    "DomesticAddress": {
      "title": "Domestic Address",
      "description": "Address fields for US locations",
      "allOf": [
        {
          "$ref": "#/$defs/Address"
        },
        {
          "type": "object",
          "properties": {
            "city": {
              "maxLength": 28,
              "minLength": 1,
              "type": "string",
              "description": "This is the city name of the address."
            },
            "state": {
              "maxLength": 2,
              "minLength": 2,
              "pattern": "^(AA|AE|AL|AK|AP|AS|AZ|AR|CA|CO|CT|DE|DC|FM|FL|GA|GU|HI|ID|IL|IN|IA|KS|KY|LA|ME|MH|MD|MA|MI|MN|MS|MO|MP|MT|NE|NV|NH|NJ|NM|NY|NC|ND|OH|OK|OR|PW|PA|PR|RI|SC|SD|TN|TX|UT|VT|VI|VA|WA|WV|WI|WY)$",
              "type": "string",
              "description": "This is two-character state code of the address."
            },
            "ZIPCode": {
              "pattern": "\\d{5}",
              "type": "string",
              "description": "This is the 5-digit ZIP code."
            },
            "ZIPPlus4": {
              "pattern": "\\d{4}",
              "type": "string",
              "description": "This is the ZIP+4 extension."
            },
            "urbanization": {
              "maxLength": 96,
              "type": "string",
              "description": "An area, sector, or residential development within a geographic area (typically used for addresses in Puerto Rico)"
            }
          },
          "additionalProperties": true
        }
      ]
    },
    "FacilityDetails": {
      "title": "Additional Facility Details",
      "type": "object",
      "properties": {
        "dock": {
          "type": "object",
          "properties": {
            "width": {
              "maximum": 999999,
              "minimum": 0,
              "exclusiveMinimum": true,
              "type": "integer",
              "description": "The width of the dock from one end to the other  (in feet)."
            },
            "depth": {
              "maximum": 999999,
              "minimum": 0,
              "exclusiveMinimum": true,
              "type": "integer",
              "description": "The depth of the dock, or distance from the dock doors to the wall which separates the dock from the other sections of the facility (in feet)."
            },
            "height": {
              "maximum": 999999,
              "minimum": 0,
              "exclusiveMinimum": true,
              "type": "integer",
              "description": "The loading dock height, or distance from the yard surface to the dock surface level (in inches)."
            }
          }
        },
        "canopyClearance": {
          "maximum": 9999,
          "minimum": 0,
          "type": "integer",
          "description": "Clearance between the yard surface and the underside of the loading / unloading area canopy or overhang (in feet)."
        },
        "liftTypes": {
          "type": "object",
          "properties": {
            "manualLift": {
              "type": "boolean",
              "description": "Indicates whether a manual lift is available at the facility."
            },
            "electricGasLift": {
              "type": "boolean",
              "description": "Indicates whether a electric or gas lift is available at the facility."
            },
            "cageStackerLift": {
              "type": "boolean",
              "description": "Indicates whether a cage stacker lift is available at the facility."
            },
            "rollerTableExtenderLift": {
              "type": "boolean",
              "description": "Indicates whether a roller table or extender lift is available at the facility."
            }
          },
          "description": "Types of lifts available at the facility."
        },
        "ramps": {
          "type": "object",
          "properties": {
            "numberOfRamps": {
              "minimum": 0,
              "type": "integer",
              "description": "The number of inclined ramps at the facility."
            },
            "widestRamp": {
              "minimum": 0,
              "type": "integer",
              "description": "The widest inclined ramp available at the facility (in feet)."
            }
          },
          "description": "Details on ramps available at the facility."
        },
        "truckManeuveringArea": {
          "type": "object",
          "properties": {
            "length": {
              "maximum": 999999,
              "minimum": 0,
              "exclusiveMinimum": true,
              "type": "integer",
              "description": "The length of the truck maneuvering area (in feet)."
            },
            "width": {
              "maximum": 999999,
              "minimum": 0,
              "type": "integer",
              "description": "The width of the truck maneuvering area (in feet)."
            },
            "surfaceType": {
              "type": "string",
              "description": "The type of material used to create the truck maneuvering area.",
              "enum": [
                "ASPHALT",
                "DIRT",
                "CONCRETE",
                "GRAVEL",
                "OTHER"
              ]
            }
          },
          "description": "Details on the maneuvering area at the facility."
        },
        "levelers": {
          "type": "object",
          "description": "The amount of levelers, by leveler type, available at a facility.",
          "properties": {
            "manualLevelers": {
              "maximum": 999,
              "minimum": 0,
              "type": "integer",
              "description": "The number of manual levelers available at the facility."
            },
            "hydraulicLevelers": {
              "maximum": 999,
              "minimum": 0,
              "type": "integer",
              "description": "The number of hydraulic levelers available at the facility."
            },
            "scissorLevelers": {
              "maximum": 999,
              "minimum": 0,
              "type": "integer",
              "description": "The number of scissor levelers available at the facility."
            }
          }
        },
        "doorDetails": {
          "type": "object",
          "description": "Information regarding the dock door size and yard surface distance to the loading dock door.",
          "properties": {
            "height": {
              "type": "integer",
              "description": "The height of the tallest dock door (in feet)."
            },
            "width": {
              "type": "integer",
              "description": "The width of the largest dock door (in feet)."
            },
            "numberOfSteps": {
              "type": "integer",
              "description": "The number of steps between the yard surface and the loading dock door."
            }
          }
        },
        "overpassDetails": {
          "type": "object",
          "description": "The number of overpasses and the lowest overpass height between the facility and the highway exit.",
          "properties": {
            "numberOfOverpasses": {
              "type": "integer",
              "description": "the number of overpasses between the facility and the highway exit."
            },
            "lowestOverpass": {
              "type": "integer",
              "description": "The lowest overpass height between the facility and highway exit (in feet)."
            }
          }
        }
      },
      "additionalProperties": false,
      "description": "Information about the drop-off location facility."
    },
    "HoursOfOperation": {
      "type": "object",
      "properties": {
        "dayOfWeek": {
          "type": "string",
          "description": "The day of the week for the set of hours.",
          "enum": [
            "MONDAY",
            "TUESDAY",
            "WEDNESDAY",
            "THURSDAY",
            "FRIDAY",
            "SATURDAY",
            "SUNDAY"
          ]
        },
        "times": {
          "type": "array",
          "description": "Hours",
          "items": {
            "type": "object",
            "properties": {
              "openTime": {
                "type": "string",
                "description": "The time that the facility opens."
              },
              "closeTime": {
                "type": "string",
                "description": "The time that the facility closes."
              }
            }
          }
        }
      },
      "additionalProperties": false,
      "description": "Facility hours of operation intervals of a day."
    },
    "USPSConnect": {
      "title": "USPS Connect™ Services",
      "type": "object",
      "properties": {
        "sameDayDelivery": {
          "type": "boolean",
          "description": "Indicates whether same day delivery service is offered at the given facility."
        },
        "sameDayPickUp": {
          "type": "string",
          "description": "Indicates the latest time same day pick up can be scheduled for the given facility. If no time is given same day pick up service is not supported.",
          "format": "\\d{4}"
        },
        "nextDayPickUp": {
          "type": "string",
          "description": "Indicates the latest time next day pick up can be scheduled for the given facility. If no time is given next day pick up service is not supported.",
          "format": "\\d{4}"
        },
        "SundayDelivery": {
          "type": "boolean",
          "description": "Indicates whether sunday delivery service is offered at the given facility."
        },
        "sameDayDropOffCutOffTimes": {
          "deprecated": true,
          "description": "This field will be removed in Version 4.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/CutOffTimesDropOff"
          }
        },
        "sameDayCarrierPickupCutOffTimes": {
          "deprecated": true,
          "description": "This field will be removed in Version 4.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/CutOffTimesPickup"
          }
        },
        "nextDayDropOffCutOffTimes": {
          "deprecated": true,
          "description": "This field will be removed in Version 4.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/CutOffTimesDropOff"
          }
        }
      },
      "additionalProperties": false,
      "description": "Provides details on USPS Connect® services offered at the facility."
    },
    "ZIPCode": {
      "pattern": "\\d{5}",
      "type": "string",
      "description": "5-digit ZIP code."
    }
  }
}