@model-match/api 3.17.0 → 3.18.0

package/openapi.json

@@ -5382,6 +5382,35 @@
         },
         "type": "array"
       },
+      "BulkDeliveryBilling": {
+        "description": "`credits` = billed at 1 credit per delivered row. `none` = not billed (push-target deliveries from the ModelMatch web app).",
+        "enum": [
+          "credits",
+          "none"
+        ],
+        "type": "string"
+      },
+      "BulkDeliveryDestination": {
+        "description": "Where the finished delivery goes. Omit for the default — a file you download from the status endpoint. `push-target`: when the job completes, the rows are handed to the named push target, which sends them to its configured HTTPS destination using its own field mapping and signing. The target is checked at submit (it must exist, be enabled, accept this entity, and be usable by you on your plan) — a failed check rejects the submit with the push target's error `code`. `format` is ignored (the handoff is always gzipped NDJSON), and when the target's mapping reads only some fields, only those fields (plus `id`) are delivered. Row limits, entitlements, `limit`, and billing (1 credit / row) are unchanged, except that push-target deliveries submitted from the ModelMatch web app are not billed. Poll the job for `pushBatchId`; a handoff that cannot be completed fails the job with error `push_handoff_failed` and is not billed.",
+        "properties": {
+          "targetId": {
+            "description": "Id of a push target configured on the active workspace (or your own member push targets).",
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": {
+            "enum": [
+              "push-target"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "targetId"
+        ],
+        "type": "object"
+      },
       "BulkDeliveryForbidden": {
         "properties": {
           "entitlementKey": {
@@ -5419,7 +5448,7 @@
         "type": "object"
       },
       "BulkDeliveryFormat": {
-        "description": "Output file format for the delivered dataset. Every format contains the same rows — the entity's list/summary DTO (e.g. `LoanSummary`), one record per row. `ndjson`: gzipped newline-delimited JSON (`application/x-ndjson`, `.ndjson.gz`). `json`: a single JSON array (`application/json`, `.json`). `csv`: RFC 4180 (`text/csv`, `.csv`). `parquet`: typed columnar Apache Parquet — scalar fields keep their DTO types, nested fields are JSON-encoded strings (`application/vnd.apache.parquet`, `.parquet`).",
+        "description": "Output file format for the delivered dataset. Every format contains the same rows — the entity's list/summary DTO (e.g. `LoanSummary`), one record per row. `ndjson`: gzipped newline-delimited JSON (`application/x-ndjson`, `.ndjson.gz`). `json`: a single JSON array (`application/json`, `.json`). `csv`: RFC 4180 (`text/csv`, `.csv`). `parquet`: typed columnar Apache Parquet — scalar fields keep their DTO types, nested fields are JSON-encoded strings (`application/vnd.apache.parquet`, `.parquet`). Required on submit unless `destination` is a push target, which always delivers gzipped NDJSON (a missing `format` on a file delivery is a 400 `format_required`).",
         "enum": [
           "ndjson",
           "json",
@@ -5465,6 +5494,31 @@
         ],
         "type": "object"
       },
+      "BulkDeliveryInsufficientScope": {
+        "properties": {
+          "error": {
+            "enum": [
+              "insufficient_scope"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "requiredScope": {
+            "enum": [
+              "push-targets:send"
+            ],
+            "type": "string"
+          }
+        },
+        "required": [
+          "error",
+          "requiredScope",
+          "message"
+        ],
+        "type": "object"
+      },
       "BulkDeliveryPreflightExceeded": {
         "properties": {
           "error": {
@@ -5490,8 +5544,52 @@
         ],
         "type": "object"
       },
+      "BulkDeliveryPushTargetError": {
+        "description": "The push-target destination was refused: `TARGET_NOT_FOUND` (404), `FORBIDDEN` (403), `PLAN_REQUIRED` (402), `TARGET_DISABLED` (409), `ENTITY_MISMATCH` (400).",
+        "properties": {
+          "code": {
+            "enum": [
+              "TARGET_NOT_FOUND",
+              "FORBIDDEN",
+              "PLAN_REQUIRED",
+              "TARGET_DISABLED",
+              "ENTITY_MISMATCH"
+            ],
+            "type": "string"
+          },
+          "error": {
+            "enum": [
+              "TARGET_NOT_FOUND",
+              "FORBIDDEN",
+              "PLAN_REQUIRED",
+              "TARGET_DISABLED",
+              "ENTITY_MISMATCH"
+            ],
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "error",
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
       "BulkDeliveryStatusResponse": {
         "properties": {
+          "billing": {
+            "$ref": "#/components/schemas/BulkDeliveryBilling"
+          },
+          "billingReason": {
+            "description": "Why `billing` is `none`: `first_party_push_target` = a push-target delivery submitted from the ModelMatch web app.",
+            "enum": [
+              "first_party_push_target"
+            ],
+            "type": "string"
+          },
           "bytes": {
             "minimum": 0,
             "type": "integer"
@@ -5513,6 +5611,9 @@
             "minimum": 0,
             "type": "number"
           },
+          "destination": {
+            "$ref": "#/components/schemas/BulkDeliveryDestination"
+          },
           "downloadUrl": {
             "description": "Stable, shareable download link for the completed dataset. Forces a file download (with a friendly filename) and stays valid for 7 days after completion. Present once `status` is `completed`. This is the link to hand to a user or send by email.",
             "type": "string"
@@ -5521,6 +5622,7 @@
             "type": "string"
           },
           "error": {
+            "description": "Why the job failed. `push_handoff_failed` = the rows were exported but could not be handed to the push target (not billed).",
             "type": "string"
           },
           "estimatedTotal": {
@@ -5537,6 +5639,10 @@
             "minimum": 0,
             "type": "integer"
           },
+          "pushBatchId": {
+            "description": "Push-target deliveries only: the batch the push target is sending, set once the completed file was handed off. Per-record send progress is tracked by the push target, not this job.",
+            "type": "string"
+          },
           "resultsUrl": {
             "description": "Direct download URL for the completed dataset. Long-lived per request but changes on each poll; prefer `downloadUrl` for a stable link to share.",
             "type": "string"
@@ -5563,6 +5669,12 @@
       },
       "BulkDeliverySubmitResponse": {
         "properties": {
+          "billing": {
+            "$ref": "#/components/schemas/BulkDeliveryBilling"
+          },
+          "destination": {
+            "$ref": "#/components/schemas/BulkDeliveryDestination"
+          },
           "entityType": {
             "type": "string"
           },
@@ -32574,9 +32686,9 @@
     }
   },
   "info": {
-    "description": "ModelMatch API — mortgage and real-estate market data.\n\n## Bulk delivery limits\n\nThe `POST /{entity}/bulk-delivery` endpoints export a full result set to\nS3 as NDJSON, JSON, CSV, or Parquet.\n\n- **Up to 1,000 rows per delivery: no entitlement required.** Available to\n  every authenticated caller.\n- **Above 1,000 rows: requires the entity's `bulk-delivery.{entity}`\n  entitlement** (e.g. `bulk-delivery.loans`). The grant's scope sets your\n  row ceiling and may also restrict which rows and fields you receive.\n\nA delivery that would exceed the limit available to you is rejected with\n`403 entitlement_missing`, reporting the matched row count and the ceiling\nthat applied. To stay under the limit, pass `limit` — the job then delivers\n(and bills for) only the first `limit` rows of a broader query.\n\n**Need a higher limit?** Email support@modelmatch.com to request the\nentitlement. Limits are raised per organization and per entity.\n\nBulk delivery is billed at 1 credit per delivered row whether or not\nan entitlement is held.",
+    "description": "ModelMatch API — mortgage and real-estate market data.\n\n## Bulk delivery limits\n\nThe `POST /{entity}/bulk-delivery` endpoints export a full result set to\nS3 as NDJSON, JSON, CSV, or Parquet.\n\n- **Up to 5,000 rows per delivery: no entitlement required.** Available to\n  every authenticated caller.\n- **Above 5,000 rows: requires the entity's `bulk-delivery.{entity}`\n  entitlement** (e.g. `bulk-delivery.loans`). The grant's scope sets your\n  row ceiling and may also restrict which rows and fields you receive.\n\nA delivery that would exceed the limit available to you is rejected with\n`403 entitlement_missing`, reporting the matched row count and the ceiling\nthat applied. To stay under the limit, pass `limit` — the job then delivers\n(and bills for) only the first `limit` rows of a broader query.\n\n**Need a higher limit?** Email support@modelmatch.com to request the\nentitlement. Limits are raised per organization and per entity.\n\nBulk delivery is billed at 1 credit per delivered row whether or not\nan entitlement is held.\n\nInstead of a download, a delivery can be sent to a push target configured\non your workspace: pass `destination: { type: \"push-target\", targetId }`.\nThe same limits and billing apply.",
     "title": "ModelMatch API",
-    "version": "3.63.0"
+    "version": "3.64.0"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -32913,7 +33025,7 @@
     },
     "/agents/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching agents document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/agents/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.agents` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching agents document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/agents/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.agents` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitAgentsBulkDelivery",
         "requestBody": {
           "content": {
@@ -32926,8 +33038,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -32938,16 +33053,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -32976,12 +33088,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -32997,21 +33112,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.agents` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.agents` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -33021,7 +33173,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for agents",
@@ -34662,7 +34814,7 @@
     },
     "/originators/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching originators document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/originators/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.originators` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching originators document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/originators/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.originators` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitOriginatorsBulkDelivery",
         "requestBody": {
           "content": {
@@ -34675,8 +34827,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -34687,16 +34842,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -34725,12 +34877,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -34746,21 +34901,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.originators` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.originators` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -34770,7 +34962,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for originators",
@@ -36959,7 +37151,7 @@
     },
     "/v1/agents/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching agents document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/agents/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.agents` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching agents document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/agents/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.agents` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitAgentsBulkDelivery",
         "requestBody": {
           "content": {
@@ -36972,8 +37164,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -36984,16 +37179,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -37022,12 +37214,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -37043,21 +37238,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.agents` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.agents` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -37067,7 +37299,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for agents",
@@ -40261,7 +40493,7 @@
     },
     "/v1/branches/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching branches document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/branches/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.branches` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching branches document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/branches/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.branches` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitBranchesBulkDelivery",
         "requestBody": {
           "content": {
@@ -40274,8 +40506,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -40286,16 +40521,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -40324,12 +40556,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -40345,21 +40580,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.branches` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.branches` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -40369,7 +40641,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for branches",
@@ -41722,7 +41994,7 @@
     },
     "/v1/companies/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching companies document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/companies/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.companies` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching companies document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/companies/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.companies` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitCompaniesBulkDelivery",
         "requestBody": {
           "content": {
@@ -41735,8 +42007,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -41747,16 +42022,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -41785,12 +42057,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -41806,21 +42081,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.companies` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.companies` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -41830,7 +42142,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for companies",
@@ -57609,7 +57921,7 @@
     },
     "/v1/loans/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching loans document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/loans/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.loans` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching loans document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/loans/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.loans` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitLoansBulkDelivery",
         "requestBody": {
           "content": {
@@ -57622,8 +57934,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -57634,16 +57949,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -57672,12 +57984,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -57693,21 +58008,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.loans` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.loans` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -57717,7 +58069,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for loans",
@@ -61219,7 +61571,7 @@
     },
     "/v1/originators/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching originators document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/originators/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.originators` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching originators document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/originators/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.originators` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitOriginatorsBulkDelivery",
         "requestBody": {
           "content": {
@@ -61232,8 +61584,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -61244,16 +61599,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -61282,12 +61634,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -61303,21 +61658,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.originators` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.originators` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -61327,7 +61719,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for originators",
@@ -63268,7 +63660,7 @@
     },
     "/v1/properties/bulk-delivery": {
       "post": {
-        "description": "Queues an ECS task that dumps every matching properties document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/properties/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 1,000 rows need no entitlement. Above that, the org's `bulk-delivery.properties` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.",
+        "description": "Queues an ECS task that dumps every matching properties document to S3 in the requested format. Returns 202 with a jobId; poll `GET /v1/properties/bulk-delivery/{jobId}` for status + the signed download URL.\n\n**Row limit.** Deliveries of up to 5,000 rows need no entitlement. Above that, the org's `bulk-delivery.properties` entitlement is required and its scope (row ceiling, row filters, allowed fields) governs the delivery; without it the request is rejected with 403 `entitlement_missing`. Pass `limit` at or below the ceiling to deliver a capped subset of a broader query. Email support@modelmatch.com to request a limit increase.\n\nDelivery is billed at 1 credit per row regardless of entitlement.\n\n**Push-target destination.** Pass `destination: { type: \"push-target\", targetId }` to have the finished rows sent to a configured push target instead of downloaded. The target is checked before anything is queued; a refusal returns the push target's status and `code` (`TARGET_NOT_FOUND` 404, `FORBIDDEN` 403, `PLAN_REQUIRED` 402, `TARGET_DISABLED` 409, `ENTITY_MISMATCH` 400). Limits and billing are the same as a file delivery, except that push-target deliveries from the ModelMatch web app are not billed.",
         "operationId": "submitPropertiesBulkDelivery",
         "requestBody": {
           "content": {
@@ -63281,8 +63673,11 @@
                   {
                     "additionalProperties": false,
                     "properties": {
+                      "destination": {
+                        "$ref": "#/components/schemas/BulkDeliveryDestination"
+                      },
                       "fields": {
-                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects.",
+                        "description": "Optional output column projection, named by the response DTO fields (the same camelCase fields the list endpoint returns, e.g. `city`, `interestRate`). Intersected with the entitlement scope's allowedFields and the entity's full column set. If empty after intersection, falls back to all columns. It also SELECTS the opt-in columns, which are not part of the list DTO and are never delivered unless named here: `communityLending` (properties, originators, companies, branches) — the Community Lending neighborhood profile, identical to the block on the entity's detail endpoint; `parties` (properties) — the mortgage parties attributed to the parcel, by attribution scope; and `marketCount` / `countyCount` / `stateCount` / `zipCount` / `lenderCount` (originators) — the market-breadth rollups you can already filter on. In `csv` and `parquet` the two block columns are JSON-encoded cells; in `json` and `ndjson` they are nested objects. Windowed production (originators, agents, companies, branches): name `<field>_<n>mo` for n in 3, 6, 12, 14, 18, 24 to get a production field for that trailing window regardless of `period` — e.g. `volume_3mo`, `units_6mo`, `purchaseVolume_24mo`. Available for originators `volume`, `units`, `avgLoanAmount`, `purchaseVolume`, `purchaseUnits`, `refinanceVolume`, `refinanceUnits`, `conventionalPct`, `fhaPct`, `vaPct`; agents `volume`, `units`, `avgSoldPrice`, `buyerVolume`, `buyerUnits`, `sellerVolume`, `sellerUnits`, `totalOriginatorsWorkedWith`, `totalCompaniesWorkedWith`, `totalLendersWorkedWith`; companies `volume`, `units`, `avgLoanAmount`, `loCount`; branches `volume`, `units`, `avgLoanAmount`, `purchasePct`, `refinancePct`, `loCount`. Numbers (null when the window has no data); an entitlement that allows a field allows every window of it.",
                         "items": {
                           "minLength": 1,
                           "type": "string"
@@ -63293,16 +63688,13 @@
                         "$ref": "#/components/schemas/BulkDeliveryFormat"
                       },
                       "limit": {
-                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 1,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 1,000-row allowance.",
-                        "example": 1000,
+                        "description": "Optional hard cap on the number of rows delivered — and therefore billed (1 credit / row). The job delivers the first `limit` rows in sort order (default newest-first) and bills only for those. If the query matches fewer than `limit`, all matches are delivered. Distinct from the page-size `size` field, which is ignored on this endpoint. The row ceiling still applies — 5,000 without the entity's bulk-delivery entitlement, or the entitlement's `maxRows` with it. A `limit` above the ceiling is rejected, but a `limit` at or below it lets you export a capped top-N even when the full match exceeds the ceiling — which is the intended way to run a broad query under the 5,000-row allowance.",
+                        "example": 5000,
                         "exclusiveMinimum": true,
                         "minimum": 0,
                         "type": "integer"
                       }
                     },
-                    "required": [
-                      "format"
-                    ],
                     "type": "object"
                   }
                 ]
@@ -63331,12 +63723,15 @@
                     },
                     {
                       "$ref": "#/components/schemas/BulkDeliveryPreflightExceeded"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                     }
                   ]
                 }
               }
             },
-            "description": "Validation failure OR delivery would exceed the entitlement's maxRows"
+            "description": "Validation failure (incl. `format_required`: a file delivery needs `format`), delivery would exceed the entitlement's maxRows, OR the push target does not accept this entity (`ENTITY_MISMATCH`)"
           },
           "401": {
             "content": {
@@ -63352,21 +63747,58 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientCredits"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    }
+                  ]
                 }
               }
             },
-            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row)"
+            "description": "Insufficient credits (balance < estimatedTotal, at 1 credit per row), OR the plan does not include push targets (`PLAN_REQUIRED`)"
           },
           "403": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                  "anyOf": [
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryForbidden"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                    },
+                    {
+                      "$ref": "#/components/schemas/BulkDeliveryInsufficientScope"
+                    }
+                  ]
+                }
+              }
+            },
+            "description": "Delivery exceeds the 5,000-row limit available without the `bulk-delivery.properties` entitlement (lower `limit`, narrow the filters, or contact support for a limit increase), OR you may not use the push target (`FORBIDDEN`), OR a scoped token named a push-target destination without `push-targets:send` (`insufficient_scope`)."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
+                }
+              }
+            },
+            "description": "Push target not found (`TARGET_NOT_FOUND`)"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BulkDeliveryPushTargetError"
                 }
               }
             },
-            "description": "Delivery exceeds the 1,000-row limit available without the `bulk-delivery.properties` entitlement. Lower `limit`, narrow the filters, or contact support for a limit increase."
+            "description": "Push target is disabled (`TARGET_DISABLED`)"
           },
           "502": {
             "content": {
@@ -63376,7 +63808,7 @@
                 }
               }
             },
-            "description": "Preflight / S3 / DDB / ECS launch failure"
+            "description": "Preflight / S3 / DDB / ECS launch failure, or the push-target check could not reach the auth server"
           }
         },
         "summary": "Submit a bulk-delivery job for properties",