---
title: "Browse Arby's US store directory by state and city"
method: GET
path: "/arbys/directory"
tags: ["Arbys"]
---

# Browse Arby's US store directory by state and city

`GET /arbys/directory`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/arbys/directory`
- Auth: API key in header `x-api-key`

Returns one level of Arby's US store directory: every state Arby's serves with its store count (no params), one state's cities (state given), or one city's stores (state and city given) -- id, address, and phone only, pair with GET /arbys/location for hours/amenities/status. Unlike GET /arbys/locations, this needs no coordinate; it is a plain browse of the whole ~3,200-store US chain.

## Query parameters

- `state` string
- `city` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- ArbysDirectoryResponseDoc
  - `code` integer: Code is the HTTP status code or a custom code used to indicate the result of the request @example 200
  - `data` ArbysDirectoryResponse
    - `cities` ArbysDirectoryCity[]: Cities lists every city in the requested state (or just the one matching city, when both are given), each with its stores. Populated only when state is given.
      - `city` string
      - `count` integer
      - `display_name` string
      - `stores` ArbysDirectoryStore[]
        - `address` ArbysLocationAddress
          - `city` string
          - `country` string
          - `line1` string
          - `line2` string
          - `postal_code` string
          - `reference_point` string
          - `state` string
        - `phone` string
        - `store_id` string
    - `city` string
    - `count` integer
    - `fetched_at` string
    - `source_url` string
    - `state` string
    - `states` ArbysDirectoryState[]: States lists every state Arby's serves, with its store count. Populated only when neither state nor city is given.
      - `count` integer
      - `name` string
      - `state` 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/afac9b012a27?raw)