{
  "opencollection": "1.0.0",
  "info": {
    "name": "Chariot FDX Accounts Mailbox API",
    "version": "6.0"
  },
  "request": {
    "auth": {
      "type": "oauth2",
      "flow": "authorization_code",
      "authorizationUrl": "https://dashboard.givechariot.com/oauth/authorize",
      "accessTokenUrl": "https://api.givechariot.com/auth/oauth/token",
      "credentials": {
        "clientId": "{{clientId}}",
        "clientSecret": "{{clientSecret}}"
      }
    }
  },
  "items": [
    {
      "info": {
        "name": "mailbox",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get a Batch Upload URL",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.givechariot.com/fdx/v6/v1/mailbox/upload_url",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Returns a presigned URL for uploading a mailbox batch.\n\nA batch is a ZIP file containing TIFF images and a CSV index file.\nThe CSV must conform to the [Batch Format](/v2026-01-15/guides/lockbox-providers/batch-format) specification.\n\nThe `location_id` must match the format `po_<number>` (e.g., `po_543`).\nThe returned URL is a presigned S3 URL valid for 15 minutes. Upload the batch ZIP file using an HTTP PUT request to this URL.\n\nSee the [Mail Uploads guide](/v2026-01-15/guides/lockbox-providers/"
        },
        {
          "info": {
            "name": "Fulfill a Lockbox Request",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.givechariot.com/fdx/v6/v1/lockboxes/fulfill_request",
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Notifies Chariot that a new PO box has been provisioned by the lockbox provider.\n\nThe `request_id` is a one-time unique value generated by Chariot for each PO box request.\n\nSee the [Provisioning guide](/v2026-01-15/guides/lockbox-providers/provisioning) for the full provisioning flow."
        }
      ]
    }
  ],
  "bundled": true
}