> ## Documentation Index
> Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cash Loads Direct Store Locations

> Search for retail store locations where a cardholder can load cash directly on their cards.

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-semibold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Use the `/locator/stores` endpoint to search for retail store locations where a cardholder can load cash directly on their cards.

<h2 id="search_store_locations">
  Search store locations
</h2>

**Action:** `GET`
**Endpoint:** `/locator/stores`

Use this endpoint to search for retail store locations that support cash loads.

<h3 id="_url_query_parameters">
  URL query parameters
</h3>

| Fields                                              | Description                                                                                                     |
| --------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |
| start\_index<br /><br />integer<br /><br />Optional | Sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /><br />0 min |
| count<br /><br />integer<br /><br />Optional        | Number of resources to retrieve.<br /><br />**Allowable Values:**<br /><br />1 min<br /><br />1-100             |
| latitude<br /><br />decimal<br /><br />Optional     | Latitude of the geographic coordinates to retrieve.<br /><br />**Allowable Values:**<br /><br />-90–90          |
| longitude<br /><br />decimal<br /><br />Optional    | Longitude of the geographic coordinates to retrieve.<br /><br />**Allowable Values:**<br /><br />-180–180       |
| postal\_code<br /><br />string<br /><br />Optional  | Postal code (zip code) to retrieve.<br /><br />**Allowable Values:**<br /><br />Example: 94612                  |
| radius<br /><br />decimal<br /><br />Optional       | Radius from latitude and longitude provided for the store.<br /><br />**Allowable Values:**<br /><br />0.1–25   |

<h3 id="_response_body">
  Response body
</h3>

| Fields                                                                       | Description                                                                                                                                                                                       |
| ---------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Returned                                 | Number of store locations returned.<br /><br />**Allowable Values:**<br /><br />1-100                                                                                                             |
| start\_index<br /><br />integer<br /><br />Returned                          | Sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                             |
| end\_index<br /><br />integer<br /><br />Returned                            | Sort order index of the last resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer                                                                              |
| is\_more<br /><br />boolean<br /><br />Returned                              | A value of `true` indicates that more unreturned resources exist.<br /><br />**Allowable Values:**<br /><br />`true`, `false`                                                                     |
| data<br /><br />array of objects<br /><br />Returned                         | Array of store location objects.<br /><br />**Allowable Values:**<br /><br />Valid array of one or more store location objects                                                                    |
| data\[].**name**<br /><br />string<br /><br />Conditionally returned         | Name of the store location.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                              |
| data\[].**address**<br /><br />string<br /><br />Conditionally returned      | Street address of the store location.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                    |
| data\[].**city**<br /><br />string<br /><br />Conditionally returned         | City of the store location.<br /><br />**Allowable Values:**<br /><br />40 char max                                                                                                               |
| data\[].**state**<br /><br />string<br /><br />Conditionally returned        | State of the store location.<br /><br />**Allowable Values:**<br /><br />32 char max                                                                                                              |
| data\[].**postal\_code**<br /><br />string<br /><br />Conditionally returned | Postal code (zip code) of the store location.<br /><br />**Allowable Values:**<br /><br />10 char max                                                                                             |
| data\[].**latitude**<br /><br />decimal<br /><br />Conditionally returned    | Latitude of the store location.<br /><br />**Allowable Values:**<br /><br />-90-90                                                                                                                |
| data\[].**longitude**<br /><br />decimal<br /><br />Conditionally returned   | Longitude of the store location.<br /><br />**Allowable Values:**<br /><br />-180-180                                                                                                             |
| data\[].**metadata**<br /><br />object<br /><br />Conditionally returned     | Custom metadata associated with the store location.<br /><br />**Allowable Values:**<br /><br />You can define the names and values of up to 20 fields in the format `"my_name_1": "my_value_1"`. |

<h3 id="_sample_response_body">
  Sample response body
</h3>

```json JSON expandable lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "name": "Marqeta",
      "address": "180 Grand Ave",
      "city": "Oakland",
      "state": "CA",
      "postal_code": "94612",
      "latitude": 37.8085,
      "longitude": -122.2668
    }
  ]
}
```