Docs menu

JimmyJohns API endpoint

Jimmy John's Modifiers API

Returns one menu product's full customization tree: size, bread, and per-ingredient choices (extra/regular/light/none), each with its real price and calorie delta. Groups nest -- picking a size choice can reveal a bread group, which can reveal one group per ingredient -- so a size step, a bread step, and every "Customize Sandwich" ingredient all live in one recursive tree. product_id comes from GET /jimmy-johns/menu.

GETapiKey1 credit/requestJimmyJohnsjimmyjohns.modifiersResponseDoc/jimmy-johns/modifiers

Endpoint facts

Method: GET
API path: /jimmy-johns/modifiers
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: JimmyJohns
Response schema: #/definitions/jimmyjohns.modifiersResponseDoc

Jimmy John's API Try Jimmy John's Modifiers API in Playground JimmyJohns API documentation

How this endpoint behaves

Returns one menu product's full customization tree — size, bread, and per-ingredient choices (extra/regular/light/none) — using Jimmy John's own Olo-backed ordering API. product_id comes from /jimmy-johns/menu.

Query parameters:

product_id (required) — product id from a /jimmy-johns/menu product.

Response includes product_id, groups[], group_count, source_url, and fetched_at. Each group has group_id, name, mandatory, min_selects, max_selects, and choices[]. Each choice has option_id, chain_option_id, name, cost, is_default, base_calories, max_calories, and its own nested groups[].

Notable response behavior:

Groups nest recursively through a choice's groups: picking a size choice can reveal a bread group, and picking "Customize Sandwich" reveals one group per ingredient (bread, ham, cheese, lettuce, etc.). A sandwich's real per-size price lives here — under "Choose Your Size" — not in /jimmy-johns/menu's cost field.
cost is a price delta relative to the parent choice, not an absolute price. Most ingredient choices are free (the included default); an "Xtra" choice carries a positive cost, and a "No" choice is usually 0 with a negative base_calories.
base_calories can be negative for a "light"/"no" ingredient choice, reflecting the calorie reduction from the default.
min_selects/max_selects are omitted when the upstream places no explicit limit beyond mandatory.

Live monitoring

Monitored request: GET /jimmy-johns/modifiers?product_id=33276056
Checks passed, 7 days to 14 Oct 2026: 98.8%
Median response time: 2.11 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /jimmy-johns/modifiers?product_id=33276056
Items in groups: 1
Fields filled in every checked item: 5

Field	Filled in, of 1 checked	Values in the sample
group_id	1
chain_modifier_id	1
name	1	“Make it a Combo!”
mandatory	1	true in 1 of 1
choices	1	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
product_id	integer	Yes		Product id from a /jimmy-johns/menu product	33276056
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/jimmy-johns/modifiers?product_id=33276056" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "product_id": 33276056,
    "groups": [
      {
        "group_id": 1176353985,
        "name": "Make it a Combo!",
        "mandatory": true,
        "choices": [
          {
            "option_id": 5265915593,
            "name": "No",
            "cost": 0,
            "is_default": true,
            "groups": [
              {
                "group_id": 1176354037,
                "name": "Choose Your Size",
                "mandatory": true,
                "choices": [
                  {
                    "option_id": 5265915696,
                    "chain_option_id": 2476875,
                    "name": "REGULAR",
                    "cost": 8.69,
                    "is_default": true,
                    "groups": [
                      {
                        "group_id": 1176355033,
                        "name": "Smoked Ham",
                        "mandatory": true,
                        "choices": [
                          {
                            "option_id": 5265919605,
                            "name": "Xtra Smoked Ham",
                            "cost": 2.29,
                            "base_calories": "70"
                          },
                          {
                            "option_id": 5265919606,
                            "name": "Reg Smoked Ham",
                            "cost": 0,
                            "is_default": true
                          },
                          {
                            "option_id": 5265919608,
                            "name": "No Smoked Ham",
                            "cost": 0,
                            "base_calories": "-70"
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "group_count": 1,
    "source_url": "https://jj.ordering.api.olo.com/v1.1/products/33276056/modifiers",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/jimmyjohns.modifiersResponseDoc

Field	Type	Required	Example	Description
code	integer	No		Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	jimmyjohns.ModifiersResponse	No
data.fetched_at	string	No
data.group_count	integer	No	9
data.groups	array	No
data.groups[].chain_modifier_id	integer	No	480998
data.groups[].choices	array	No
data.groups[].choices[].base_calories	string	No	70	BaseCalories is this choice's calorie delta, which can be negative for a "light"/"no" ingredient choice.
data.groups[].choices[].chain_option_id	integer	No	2476875
data.groups[].choices[].cost	number	No	8.69	Cost is this choice's price delta. Many choices are free (the included default); an upcharge choice (e.g. "Xtra Smoked Ham") or a size step carries a positive cost.
data.groups[].choices[].groups	array	No
data.groups[].choices[].is_default	boolean	No
data.groups[].choices[].max_calories	string	No
data.groups[].choices[].name	string	No	REGULAR
data.groups[].choices[].option_id	integer	No	5265915696
data.groups[].group_id	integer	No	1176354037
data.groups[].mandatory	boolean	No
data.groups[].max_selects	integer	No
data.groups[].min_selects	integer	No
data.groups[].name	string	No	Choose Your Size
data.product_id	integer	No	33276056
data.source_url	string	No
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/jimmy-johns/modifiers?product_id=33276056" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More JimmyJohns endpoint docs Jimmy John's API Jimmy John's Menu API documentation Jimmy John's Nearby API documentation Jimmy John's Sitemap API documentation Jimmy John's Store API documentation

Open in Playground Back to group

Docs menu

JimmyJohns API endpoint

Jimmy John's Modifiers API

GETapiKey1 credit/requestJimmyJohnsjimmyjohns.modifiersResponseDoc/jimmy-johns/modifiers

Endpoint facts

Method: GET
API path: /jimmy-johns/modifiers
Auth: apiKey
Credits: 1 credit/request
Charged on: Successful 2xx responses only
Platform: JimmyJohns
Response schema: #/definitions/jimmyjohns.modifiersResponseDoc

Jimmy John's API Try Jimmy John's Modifiers API in Playground JimmyJohns API documentation

How this endpoint behaves

Query parameters:

product_id (required) — product id from a /jimmy-johns/menu product.

Notable response behavior:

Groups nest recursively through a choice's groups: picking a size choice can reveal a bread group, and picking "Customize Sandwich" reveals one group per ingredient (bread, ham, cheese, lettuce, etc.). A sandwich's real per-size price lives here — under "Choose Your Size" — not in /jimmy-johns/menu's cost field.
cost is a price delta relative to the parent choice, not an absolute price. Most ingredient choices are free (the included default); an "Xtra" choice carries a positive cost, and a "No" choice is usually 0 with a negative base_calories.
base_calories can be negative for a "light"/"no" ingredient choice, reflecting the calorie reduction from the default.
min_selects/max_selects are omitted when the upstream places no explicit limit beyond mandatory.

Live monitoring

Monitored request: GET /jimmy-johns/modifiers?product_id=33276056
Checks passed, 7 days to 14 Oct 2026: 98.8%
Median response time: 2.11 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /jimmy-johns/modifiers?product_id=33276056
Items in groups: 1
Fields filled in every checked item: 5

Field	Filled in, of 1 checked	Values in the sample
group_id	1
chain_modifier_id	1
name	1	“Make it a Combo!”
mandatory	1	true in 1 of 1
choices	1	median 2 entries

Request parameters

Parameter	Type	Required	Default	Description	Example
product_id	integer	Yes		Product id from a /jimmy-johns/menu product	33276056
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/jimmy-johns/modifiers?product_id=33276056" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "product_id": 33276056,
    "groups": [
      {
        "group_id": 1176353985,
        "name": "Make it a Combo!",
        "mandatory": true,
        "choices": [
          {
            "option_id": 5265915593,
            "name": "No",
            "cost": 0,
            "is_default": true,
            "groups": [
              {
                "group_id": 1176354037,
                "name": "Choose Your Size",
                "mandatory": true,
                "choices": [
                  {
                    "option_id": 5265915696,
                    "chain_option_id": 2476875,
                    "name": "REGULAR",
                    "cost": 8.69,
                    "is_default": true,
                    "groups": [
                      {
                        "group_id": 1176355033,
                        "name": "Smoked Ham",
                        "mandatory": true,
                        "choices": [
                          {
                            "option_id": 5265919605,
                            "name": "Xtra Smoked Ham",
                            "cost": 2.29,
                            "base_calories": "70"
                          },
                          {
                            "option_id": 5265919606,
                            "name": "Reg Smoked Ham",
                            "cost": 0,
                            "is_default": true
                          },
                          {
                            "option_id": 5265919608,
                            "name": "No Smoked Ham",
                            "cost": 0,
                            "base_calories": "-70"
                          }
                        ]
                      }
                    ]
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "group_count": 1,
    "source_url": "https://jj.ordering.api.olo.com/v1.1/products/33276056/modifiers",
    "fetched_at": "2026-09-03T00:00:00Z"
  }
}

Request schema

No body schema

Response schema

#/definitions/jimmyjohns.modifiersResponseDoc

Field	Type	Required	Example	Description
code	integer	No		Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
data	jimmyjohns.ModifiersResponse	No
data.fetched_at	string	No
data.group_count	integer	No	9
data.groups	array	No
data.groups[].chain_modifier_id	integer	No	480998
data.groups[].choices	array	No
data.groups[].choices[].base_calories	string	No	70	BaseCalories is this choice's calorie delta, which can be negative for a "light"/"no" ingredient choice.
data.groups[].choices[].chain_option_id	integer	No	2476875
data.groups[].choices[].cost	number	No	8.69	Cost is this choice's price delta. Many choices are free (the included default); an upcharge choice (e.g. "Xtra Smoked Ham") or a size step carries a positive cost.
data.groups[].choices[].groups	array	No
data.groups[].choices[].is_default	boolean	No
data.groups[].choices[].max_calories	string	No
data.groups[].choices[].name	string	No	REGULAR
data.groups[].choices[].option_id	integer	No	5265915696
data.groups[].group_id	integer	No	1176354037
data.groups[].mandatory	boolean	No
data.groups[].max_selects	integer	No
data.groups[].min_selects	integer	No
data.groups[].name	string	No	Choose Your Size
data.product_id	integer	No	33276056
data.source_url	string	No
msg	unknown	No		Msg is the message that describes the result of the request @example "Request successful"

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/jimmy-johns/modifiers?product_id=33276056" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More JimmyJohns endpoint docs Jimmy John's API Jimmy John's Menu API documentation Jimmy John's Nearby API documentation Jimmy John's Sitemap API documentation Jimmy John's Store API documentation

Open in Playground Back to group

Jimmy John's Modifiers API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Jimmy John's Modifiers API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related