---
title: "CVS store locator"
method: GET
path: "/cvs/store-locator"
tags: ["CVS"]
---

# CVS store locator

`GET /cvs/store-locator`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/cvs/store-locator`
- Auth: API key in header `x-api-key`

Returns nearby CVS store locations for a ZIP code, a free-text address/city/state, or a latitude/longitude pair: address, phone, fax, distance, and retail store hours, plus a has_pharmacy existence flag and a list of general service indicators (e.g. photo, ATM, same-day delivery). Covers general store info only -- this does not return pharmacy hours, pharmacy phone, prescription data, or any patient-specific information. zip is a 5-digit US ZIP code; alternatively supply address (a free-text location such as a city, state, or street address) or latitude and longitude together. When more than one is supplied, zip wins, then address, then latitude/longitude. Optionally narrow results to stores carrying one specific service via the service param (the same code vocabulary the response's services field uses); only one service value is accepted per request. CVS.com is only available from US/US-territory egress; a request from an unsupported region returns an upstream error rather than an empty result.

## Query parameters

- `zip` string
- `address` string
- `latitude` number
- `longitude` number
- `service` 'HH_HealthHub_Ind' | 'MC_MinuteClinic_Ind' | 'HS_OakStreetHealth_Ind' | 'IM_Immunization_Ind' | 'RX_OTCH_Ind' | 'IM_Covax_Ind' | 'CL_CovidTest_Ind' | 'RX_24Hours_Ind' | 'RX_DriveThru_Ind' | 'RX_Pharmacy_Ind' | 'RX_DrugDisposal_Ind' | 'RS_24Hours_Ind' | 'PH_Photo_Ind' | 'RS_AcceptsWic_Ind' | 'RS_AcceptsSnap_Ind' | 'GN_UPSAccessPoint_Ind' | 'RS_BOPIS_Ind' | 'GN_YMas_Ind' | 'BT_BeautyIRL_Ind' | 'GN_SmileDirectClub_Ind'

## Headers

- `x-api-key` string, required

## Response `200`

OK

- CvsStoresResponseDoc
  - `code` integer
  - `data` CvsStoresResponse
    - `stores` CvsStore[]
      - `address_line1` string
      - `city` string
      - `distance_miles` number
      - `fax` string
      - `has_pharmacy` boolean: HasPharmacy reflects only whether this location has a pharmacy counter -- a fact-of-existence flag, not pharmacy hours, phone, or any prescription-specific data. See the package doc comment.
      - `latitude` number
      - `longitude` number
      - `phone` string
      - `services` string[]: Services is the raw list of upstream service-indicator codes for this store (e.g. "PH_Photo_Ind", "atmInd", "RS_BOPIS_Ind"), passed through as-is rather than translated to friendly names.
      - `state` string
      - `store_hours` CvsDayHours[]: StoreHours is the retail (front-of-store) weekly schedule only.
        - `close_time` string
        - `open_time` string
        - `weekday` string
      - `store_id` string
      - `time_zone` string
      - `zip` string
    - `total_count` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `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/0497899e2016?raw)