{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-cards/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Spend controls & MCC","description":"Start today using our public API to power your next project."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"spend-controls--mcc"},"children":["Spend controls & MCC"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Constrain how much, when, how often, and where a card can spend."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every card carries a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["restrictions"]}," object — set at creation, adjustable later via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PATCH /v1/cards/{id}"]},". Four controls compose:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"restrictions\n├── spendLimit            required   caps total spend\n├── activeDateRangeUTC    optional   bounds when the card can transact\n├── maxTransactionCount   optional   caps usage, 1–10\n└── merchantCategory      optional   allow/block merchant category groups\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"spend-limit"},"children":["Spend limit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["spendLimit"]}," is the maximum total amount the card can spend, in the card's local currency, and must be greater than 0. It is the only required restriction."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"active-date-range"},"children":["Active date range"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activeDateRangeUTC.startDate"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["endDate"]}," (UTC timestamps) define the window in which the card can transact. Before ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["startDate"]}," and after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["endDate"]},", authorizations decline. Use it to make a card exist only for the trip, event, or billing period it was issued for."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"activeDateRangeUTC\": {\n    \"startDate\": \"2026-10-01 00:00:00\",\n    \"endDate\": \"2026-10-15 23:59:59\"\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transaction-count"},"children":["Transaction count"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["maxTransactionCount"]}," (1–10) caps how many transactions the card can make. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}," produces a single-use card — the standard pattern for supplier payments and travel VCNs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merchant-category-controls"},"children":["Merchant category controls"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantCategory"]}," restricts where the card works, at the level of Jeeves category groups (each group maps to a set of ISO 18245 MCC codes):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"merchantCategory\": {\n    \"mode\": \"allow\",\n    \"categoryIds\": [\"Airfare\", \"Lodging & Accommodations\"]\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Mode"},"children":["Mode"]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Behavior"},"children":["Behavior"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allow"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Only transactions in the listed categories authorize. Everything else declines."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["block"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Transactions in the listed categories decline. Everything else authorizes normally."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"discovering-categories"},"children":["Discovering categories"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v1/cards/mcc/categories"]}," (scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cards:read"]},") returns every category group with the MCC codes it contains:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://public-sandbox.tryjeeves.com/v1/cards/mcc/categories' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"rows\": [\n    {\n      \"merchantCategoryId\": \"Lodging & Accommodations\",\n      \"merchantCategoryName\": \"Lodging\",\n      \"merchantCategoryCodes\": [\n        { \"code\": \"7011\", \"name\": \"Hotels, Motels, and Resorts\" }\n      ]\n    }\n  ],\n  \"count\": 22\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The 22 category groups:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Accounting"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Airfare"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Conference & Events"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contractor Services"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Equipment Expense"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Freight & Shipping"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Insurance"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Legal Expense"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Lodging & Accommodations"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Marketing"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Meals & Entertainment"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Membership Dues & Subscriptions"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Office Expense"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Other Expense"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Other Miscellaneous"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Postage & Shipping"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rent"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Retail Purchases"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Software Expense"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Taxes and Licensing"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Transportation Services"]}," · ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Utility Services"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantCategoryId"]}," values as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["categoryIds"]}," in the control. These are ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["exact string identifiers"]}," — copy them verbatim from this endpoint (including capitalization, spacing, and the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["&"]},"); they are stable and not localized. Note these are Jeeves ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merchant category groups"]}," (expense-style groupings of ISO 18245 MCC codes), not the raw MCC taxonomy itself."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"changing-controls-later"},"children":["Changing controls later"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All four controls are updatable in place — see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/cards/card-management/managing-cards"},"children":["Updating & deleting"]},". Raising a spend limit or adding a category does not reissue the card; the change applies to the next authorization."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"composition-example-a-conference-card"},"children":["Composition example: a conference card"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Spend up to $2,500, only during the event week, only on lodging and meals, at most 10 transactions:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X POST \\\n  'https://public-sandbox.tryjeeves.com/v1/cards' \\\n  -H \"Authorization: Bearer $JEEVES_ACCESS_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"name\": \"Conference Card\",\n    \"restrictions\": {\n      \"spendLimit\": 2500,\n      \"activeDateRangeUTC\": {\n        \"startDate\": \"2026-11-02 00:00:00\",\n        \"endDate\": \"2026-11-08 23:59:59\"\n      },\n      \"maxTransactionCount\": 10,\n      \"merchantCategory\": {\n        \"mode\": \"allow\",\n        \"categoryIds\": [\"Lodging & Accommodations\", \"Meals & Entertainment\"]\n      }\n    }\n  }'\n","lang":"bash"},"children":[]}]},"headings":[{"value":"Spend controls & MCC","id":"spend-controls--mcc","depth":1},{"value":"Spend limit","id":"spend-limit","depth":2},{"value":"Active date range","id":"active-date-range","depth":2},{"value":"Transaction count","id":"transaction-count","depth":2},{"value":"Merchant category controls","id":"merchant-category-controls","depth":2},{"value":"Discovering categories","id":"discovering-categories","depth":3},{"value":"Changing controls later","id":"changing-controls-later","depth":2},{"value":"Composition example: a conference card","id":"composition-example-a-conference-card","depth":2}],"frontmatter":{"seo":{"title":"Spend controls & MCC"}},"lastModified":"2026-10-28T18:10:31.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/cards/card-management/spend-controls","userData":{"isAuthenticated":false,"teams":["anonymous"]}}