United States Postal Service · Schema
Create OD Container Response for `multipart/form-data`.
GovernmentPostal ServiceShippingLogisticsAddress ValidationPackage Tracking
Properties
| Name | Type | Description |
|---|---|---|
| pmodContainerMetadata | object | |
| labelImage | string | Contains the Base64-encoded file contents of the IMpb label image. Provided only when `imageInfo.imageType` is not `NONE`. |
| imcbImage | string | Contains the Base64-encoded file contents of the 99M IMcb image. Provided only when `imageInfo.imageType` is not `NONE`. |
| receiptImage | string | Contains the Base64-encoded file contents of the label receipt image. Provided only when `imageInfo.receiptOption` is `SEPARATE_PAGE`. Note: - When `imageInfo.imageType` is `ZPL203DPI` or `ZPL300DPI` |
| warnings | array |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/usps/json-schema/usps-create-odcontainer-response-schema.json",
"title": "Create OD Container Response for `multipart/form-data`.",
"x-generated": "2026-11-11",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/usps-pmod-openapi.yml#/components/schemas/CreateODContainerResponse",
"type": "object",
"properties": {
"pmodContainerMetadata": {
"$ref": "#/$defs/PmodContainerMetadata"
},
"labelImage": {
"type": "string",
"description": "Contains the Base64-encoded file contents of the IMpb label image. Provided only when `imageInfo.imageType` is not `NONE`.\n",
"format": "byte"
},
"imcbImage": {
"type": "string",
"description": "Contains the Base64-encoded file contents of the 99M IMcb image. Provided only when `imageInfo.imageType` is not `NONE`.\n",
"format": "byte"
},
"receiptImage": {
"type": "string",
"description": "Contains the Base64-encoded file contents of the label receipt image. Provided only when `imageInfo.receiptOption` is `SEPARATE_PAGE`.\n\nNote:\n- When `imageInfo.imageType` is `ZPL203DPI` or `ZPL300DPI` and `imageInfo.receiptOption` is `SEPARATE_PAGE`, the receipt will be returned as an additional label segment within the single ZPL payload in `labelImage`. In this case, `receiptImage` will not be populated.\n",
"format": "byte"
},
"warnings": {
"type": "array",
"items": {
"$ref": "#/$defs/Container_warnings"
}
}
},
"additionalProperties": false,
"$defs": {
"Commitment": {
"title": "Commitment",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Commitment name such as 1-days, 2-days, 3-days, Military, DPO"
},
"scheduleDeliveryDate": {
"type": "string",
"description": "Date in the `YYYY-MM-DD` format. 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",
"deprecated": true
},
"expectedDeliveryDate": {
"type": "string",
"description": "Date in the YYYY-MM-DD format."
}
},
"additionalProperties": false,
"description": "The commitment and scheduled delivery date of the package."
},
"Container_warnings": {
"type": "object",
"properties": {
"warningCode": {
"type": "string",
"description": "Warning code in response to the request."
},
"warningDescription": {
"description": "A human-readable message describing the warning.",
"type": "string"
}
}
},
"ExtraServices": {
"title": "ExtraServices",
"description": "Extra services requested on the container",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the extra service."
},
"SKU": {
"type": "string",
"description": "SKU of the extra service."
},
"price": {
"type": "number",
"description": "The price for the extra service.",
"format": "float"
},
"warnings": {
"type": "array",
"description": "Warnings and additional details around the Extra Services.",
"minItems": 0,
"items": {
"type": "object",
"properties": {
"warningCode": {
"type": "string",
"description": "Code corresponding to the warning"
},
"warningDescription": {
"type": "string",
"description": "Warning or additional information regarding the Extra Service."
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"FacilityInfo": {
"title": "Facility Info",
"description": "Address of the destination entry facility the container will be brought to.",
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The name of the facility as it appears on the label"
},
"supportedZips": {
"type": "string",
"description": "A list of zip codes supported by the facility"
},
"address": {
"type": "string",
"description": "The address of the facility"
},
"city": {
"type": "string",
"description": "The city the facility is located in"
},
"state": {
"type": "string",
"description": "The state the facility is located in"
},
"ZIPCode": {
"type": "string",
"description": "The 5 digit zip code the facility is located in"
},
"ZIPPlus4": {
"type": "string",
"description": "The 4-digit component of the ZIP+4 code the facility is located in"
}
},
"additionalProperties": false
},
"Fees": {
"title": "Fees",
"description": "Fees associated with the container",
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Name of the fee"
},
"SKU": {
"type": "string",
"description": "Pricing SKU"
},
"price": {
"type": "number",
"format": "float",
"description": "Price of the fee"
}
},
"additionalProperties": false
},
"PmodContainerMetadata": {
"title": "Create Open and Distribute Container Metadata",
"type": "object",
"properties": {
"containerID": {
"maxLength": 34,
"type": "string",
"description": "The 99M IMcb number for the created container."
},
"trackingNumber": {
"type": "string",
"description": "The IMpb tracking number associated with the container."
},
"commitment": {
"$ref": "#/$defs/Commitment"
},
"facilityInfo": {
"$ref": "#/$defs/FacilityInfo"
},
"constructCode": {
"type": "string",
"description": "The barcode construct code associated with the tracking number"
},
"retailDistributionCode": {
"type": "string",
"description": "Retail Description Code associated with label"
},
"postage": {
"type": "number",
"description": "Amount of postage required, does not include insurance or other extra service fees"
},
"fees": {
"type": "array",
"items": {
"$ref": "#/$defs/Fees"
}
},
"extraServices": {
"type": "array",
"items": {
"$ref": "#/$defs/ExtraServices"
}
}
},
"additionalProperties": false,
"description": "Create OD Container Response"
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/usps-create-odcontainer-response"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.