Standards

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/usps/json-schema/usps-standards-schema.json",
  "title": "Standards",
  "description": "A list of service standards for each unique combination of Mail Class, Acceptance Location, and Delivery Location.",
  "x-generated": "2026-11-11",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/usps-service-standards-openapi.yml#/components/schemas/Standards",
  "type": "array",
  "additionalProperties": false,
  "items": {
    "$ref": "#/$defs/Standard"
  },
  "$defs": {
    "Standard": {
      "title": "Standard",
      "type": "object",
      "properties": {
        "mailClass": {
          "type": "string",
          "description": "The requested mail class."
        },
        "notes": {
          "type": "string",
          "description": "When a mailClass will be returned with more than one standard the notes will be returned with information on what differentiates the two standards.",
          "enum": [
            "WEIGHT_LESS_THAN_1_POUND",
            "WEIGHT_GREATER_THAN_OR_EQUAL_TO_1_POUND"
          ]
        },
        "originZIPCode": {
          "type": "string",
          "description": "The ZIP Code™ of the origin address."
        },
        "destinationZIPCode": {
          "type": "string",
          "description": "The ZIP Code™ of the destination address."
        },
        "days": {
          "type": "number",
          "description": "The number of days it will take for the package or mail piece will be delivered."
        },
        "effectiveAcceptanceDate": {
          "type": "string",
          "description": "This is the effective acceptance date of the package or mail piece.",
          "format": "date"
        },
        "scheduledDeliveryDate": {
          "type": "string",
          "description": "Date USPS expects that the package or mailpiece will be delivered based on the origin, destination, and drop-off time and date in the request. Actual delivery date may vary based on when the package or mailpiece is entered or other conditions.\n\nNote: This field has been deprecated in favor of `expectedDeliveryDate` and will be removed in a future release. Please transition to using `expectedDeliveryDate`.\n",
          "format": "date",
          "deprecated": true
        },
        "expectedDeliveryDate": {
          "type": "string",
          "description": "This is the expected delivery date of the package or mail piece.",
          "format": "date"
        },
        "presort": {
          "description": "Indicates whether the service standard information is for Presort mail.",
          "type": "boolean"
        },
        "isPriorityMailNextDay": {
          "type": "boolean",
          "description": "Indicates if the standard is for Priority Mail Next Day service."
        }
      },
      "additionalProperties": false,
      "description": "A Service standard for a unique Mail Class, Acceptance Location, and Delivery Location."
    }
  }
}