---
title: "Find Jimmy John's restaurants near a coordinate"
method: GET
path: "/jimmy-johns/nearby"
tags: ["JimmyJohns"]
---

# Find Jimmy John's restaurants near a coordinate

`GET /jimmy-johns/nearby`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/jimmy-johns/nearby`
- Auth: API key in header `x-api-key`

Returns Jimmy John's restaurants within a radius of a coordinate, nearest first, using Jimmy John's own Olo-backed ordering API (a separate host from the locator this family's sitemap and store endpoints read). Each result carries restaurant_id -- pass it to GET /jimmy-johns/menu for that restaurant's full menu. The upstream's own radius parameter does not narrow its result set, so distance filtering and sorting happen here.

## Query parameters

- `latitude` number, required
- `longitude` number, required
- `radius` integer
- `limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JimmyjohnsNearbyResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` JimmyjohnsNearbyResponse
    - `count` integer
    - `fetched_at` string
    - `radius_miles` integer
    - `restaurants` JimmyjohnsNearbyRestaurant[]
      - `accepts_delivery` boolean
      - `accepts_pickup` boolean
      - `address` JimmyjohnsStoreAddress
        - `city` string
        - `country` string
        - `postal_code` string
        - `region` string
        - `street` string
      - `distance_miles` number
      - `is_open` boolean
      - `latitude` number
      - `longitude` number
      - `name` string
      - `order_url` string
      - `phone_number` string
      - `restaurant_id` integer
      - `slug` string
      - `timezone` string
    - `source_url` string
  - `msg` unknown

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)