The Store API represents key points of information about Casey's stores. Thirty-seven operations cover stores, store hours, amenities, brands, locations, districts, divisions, regions and the wider organizational hierarchy, in both v0 (deprecated) and v1 shapes.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/caseys-storeapi"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.0.1
info:
title: StoreApi
description: The Store API is responsible for representing key points of information around stores.
version: '1.0'
servers:
- url: https://esl.caseys.io/storeapi
paths:
/v1/organizational/districts/{districtId}:
get:
tags:
- organization hierarchy
- v1
summary: v1 Gets a district's data
description: Gets the data for a specific district in the organizational hierarchy.
operationId: getDistrictByIdV1
parameters:
- name: districtId
in: path
description: The unique identifier of the district to get information for.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a district in the organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/districtModelV1'
example:
id: 13
name: District 13
_links:
parent:
href: /v1/organizational/regions/13
children:
- href: /v1/store/1906
- href: /v1/store/1930
- href: /v1/store/1954
- href: /v1/store/1957
- href: /v1/store/1958
- href: /v1/store/2291
- href: /v1/store/2295
- href: /v1/store/2945
- href: /v1/store/2959
- href: /v1/store/2984
- href: /v1/store/3842
- href: /v1/store/3894
- href: /v1/store/2951
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/v1/organizational/divisions/{divisionId}:
get:
tags:
- organization hierarchy
- v1
summary: v1 Gets a division's information
description: Gets the data for a specific division in the organizational hierarchy.
operationId: getDivisionByIdV1
parameters:
- name: divisionId
in: path
description: The unique identifier of the division to get information for.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a division in the organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/divisionModelV1'
example:
id: 9088
name: Division 3
_links:
parent: null
children:
- href: /v1/organizational/regions/13
- href: /v1/organizational/regions/14
- href: /v1/organizational/regions/15
- href: /v1/organizational/regions/16
- href: /v1/organizational/regions/17
- href: /v1/organizational/regions/18
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/v1/heartbeat:
get:
tags:
- v1
summary: v1 Gets the health of the API
description: Interrogates the state of the API and its dependencies to return the API health.
operationId: getHeartbeatV1
responses:
'200':
description: The status of the APIs health. Healthy if all dependency health checks pass. Unhealthy if
any dependency's health check fails, or if an exception occurs.
content:
application/json:
schema:
$ref: '#/components/schemas/heartbeatReportV1'
example:
status: Healthy
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/heartbeatReportV1'
example:
status: Healthy
/brands:
get:
tags:
- brands
- v0
- deprecated
summary: v0 Gets a list of store branding styles [DEPRECATED]
description: Gets a list of the branding styles available for stores.
operationId: getBrandsV0
responses:
'200':
description: This resource represents a list of branding styles for stores.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/brandModelV0'
example:
- id: 1
name: Casey's
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/organizational/districts/{districtId}:
get:
tags:
- organization hierarchy
- v0
- deprecated
summary: v0 Gets a district's data [DEPRECATED]
description: Gets the data for a specific district in the organizational hierarchy.
operationId: getDistrictByIdV0
parameters:
- name: districtId
in: path
description: The unique identifier of the district to get information for.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a district in the organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/districtModelV0'
example:
id: 13
name: District 13
_links:
parent:
href: /organizational/regions/13
children:
- href: /store/1906
- href: /store/1930
- href: /store/1954
- href: /store/1957
- href: /store/1958
- href: /store/2291
- href: /store/2295
- href: /store/2945
- href: /store/2959
- href: /store/2984
- href: /store/3842
- href: /store/3894
- href: /store/2951
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/organizational/districts:
get:
tags:
- organization hierarchy
- v0
- deprecated
summary: v0 Gets a list of districts [DEPRECATED]
description: Gets a list of the data for all districts in the organizational hierarchy.
operationId: getDistrictsV0
responses:
'200':
description: This resource represents a list of data for all districts.
content:
application/json:
schema:
$ref: '#/components/schemas/districtListModelV0'
example:
data:
- id: 13
name: District 13
_links:
parent:
href: /organizational/regions/13
children:
- href: /store/1906
- href: /store/1930
- href: /store/1954
- href: /store/1957
- href: /store/1958
- href: /store/2291
- href: /store/2295
- href: /store/2945
- href: /store/2959
- href: /store/2984
- href: /store/3842
- href: /store/3894
- href: /store/2951
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/organizational/divisions/{divisionId}:
get:
tags:
- organization hierarchy
- v0
- deprecated
summary: v0 Gets a division's information [DEPRECATED]
description: Gets the data for a specific division in the organizational hierarchy.
operationId: getDivisionByIdV0
parameters:
- name: divisionId
in: path
description: The unique identifier of the division to get information for.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a division in the organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/divisionModelV0'
example:
id: 9088
name: Division 3
_links:
parent: null
children:
- href: /organizational/regions/13
- href: /organizational/regions/14
- href: /organizational/regions/15
- href: /organizational/regions/16
- href: /organizational/regions/17
- href: /organizational/regions/18
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/organizational/divisions:
get:
tags:
- organization hierarchy
- v0
- deprecated
summary: v0 Gets a list of divisions [DEPRECATED]
description: Gets a list of the data for all divisions in the organizational hierarchy.
operationId: getDivisionsV0
responses:
'200':
description: This resource represents a list of data for all divisions.
content:
application/json:
schema:
$ref: '#/components/schemas/divisionListModelV0'
example:
data:
- id: 9088
name: Division 3
_links:
parent: null
children:
- href: /organizational/regions/13
- href: /organizational/regions/14
- href: /organizational/regions/15
- href: /organizational/regions/16
- href: /organizational/regions/17
- href: /organizational/regions/18
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/heartbeat:
get:
tags:
- v0
summary: v0 Gets the health of the API [DEPRECATED]
description: Interrogates the state of the API and its dependencies to return the API health.
operationId: getHeartbeatV0
responses:
'200':
description: The status of the APIs health. Healthy if all dependency health checks pass. Unhealthy if
any dependency's health check fails, or if an exception occurs.
content:
application/json:
schema:
$ref: '#/components/schemas/heartbeatReportV0'
example:
status: Healthy
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/heartbeatReportV0'
example:
status: Healthy
/store/{storeNumber}/organizational:
get:
tags:
- store
- organization hierarchy
- v0
- deprecated
summary: v0 Gets a store's organizational hierarchy [DEPRECATED]
description: Gets the organizational data for a specific store.
operationId: getStoreOrganizationByIdV0
parameters:
- name: storeNumber
in: path
description: The unique identifier of the store to get data about.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a store's organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/organizationalModelV0'
example:
storeNumber: 2
districtNumber: 57
districtName: District 57
divisionDirectorNumber: 910714062
divisionDirectorName: DAVE JOHNSON
divisionDirectorEmail: dave.johnson@caseys.com
divisionDirectorExtension: 0
divisionDirectorHomeStore: 9085
regionNumber: 9
regionName: Region 9
regionDirectorNumber: 910714062
regionDirectorName: JOHN GRAVES
regionDirectorEmail: John.Graves@caseys.com
regionDirectorExtension: 0
regionDirectorHomeStore: 2654
divisionNumber: 9085
divisionName: Division 1
districtSupervisorNumber: 910714062
districtSupervisorName: DEBORAH AHRENS
districtSupervisorEmail: DEBORAH.AHRENS@CASEYS.COM
districtSupervisorExtension: 18702
districtSupervisorHomeStore: 24
managerNumber: 910250996
managerName: LAURIE GARRETT
managerEmail: null
regionalMerchandisingManagerName: WILSON WILLIAMS
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/organizational/regions/{regionId}:
get:
tags:
- organization hierarchy
- region
- v0
- deprecated
summary: v0 Gets a region's data [DEPRECATED]
description: Gets the data for a specific region in the organizational hierarchy.
operationId: getRegionByIdV0
parameters:
- name: regionId
in: path
description: The unique identifier of the region to get information about.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a region in the organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/regionModelV0'
example:
id: 13
name: Region 13
_links:
parent:
href: /organizational/divisions/9088
children:
- href: /organizational/districts/13
- href: /organizational/districts/14
- href: /organizational/districts/107
- href: /organizational/districts/114
- href: /organizational/districts/115
- href: /organizational/districts/116
- href: /organizational/districts/117
- href: /organizational/districts/197
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/organizational/regions:
get:
tags:
- organization hierarchy
- v0
- deprecated
summary: v0 Gets a list of regions [DEPRECATED]
description: Gets a list of the data for all regions in the organizational hierarchy.
operationId: getRegionsV0
responses:
'200':
description: This resource represents a list of data for all regions.
content:
application/json:
schema:
$ref: '#/components/schemas/regionListModelV0'
example:
data:
- id: 13
name: Region 13
_links:
parent:
href: /organizational/divisions/9088
children:
- href: /organizational/districts/13
- href: /organizational/districts/14
- href: /organizational/districts/107
- href: /organizational/districts/114
- href: /organizational/districts/115
- href: /organizational/districts/116
- href: /organizational/districts/117
- href: /organizational/districts/197
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/store/{storeNumber}:
get:
tags:
- store
- v0
- deprecated
summary: v0 Gets a store's data [DEPRECATED]
description: 'Gets the data for a specific store.<br><br>Includes stores with the classifications:<br>S: Store<br>T:
Tobacco Only<br>F: Fuel Island<br>G: Digital Store'
operationId: getStoreByIdV0
parameters:
- name: storeNumber
in: path
description: The unique identifier of the store to get data about.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents a store.
content:
application/json:
schema:
$ref: '#/components/schemas/storeInfoV0'
example:
storeNumber: 2
storeName: CASEY'S GENERAL STORES
storeShortName: 'BOONE #1'
timeZone: C
longitude: -93.83917299
latitude: 42.0593372
street: 114 MAMIE EISENHOWER AVE
cityId: 31004
cityName: BOONE
stateId: 994
stateAbbreviation: IA
countyId: 22867
countyName: BOONE
zipCode: '500363424'
poBox: PO BOX 492
status: Open
statusId: 3
phone: 5551234567
orderPhone: 5557654321
hasATM: true
hasBakery: true
sellsAlcohol: true
sellsTobacco: true
sellsDiesel: true
sellsDonuts: true
sellsSoftServeIceCream: true
sellsBreakfastSandwiches: true
sellsPreparedSandwiches: true
sellsSignatureSubs: true
sellsMTOSubs: true
sellsPizza: true
sellsNoonPizza: true
sellsEveningPizza: true
hasPayAtPump: true
hasKitchen: true
hasThirdPartyDelivery: true
hasCurbsidePickup: true
hasInStorePickup: true
style: SE
floorPlan: null
originalOpenDate: '2022-06-14T00:00:00.0000000+00:00'
lastOpenDate: '1991-06-26T00:00:00.0000000+00:00'
acquisitionName: null
isLeftHand: false
shelvingStyle: L
closeDate: null
budgetedHours: 950
subBarDate: '2012-07-20T00:00:00.0000000+00:00'
hasFax: false
pizzaOpenDate: '1986-03-19T00:00:00.0000000+00:00'
deliveryStartDate: '2021-06-28T00:00:00.0000000+00:00'
deliveryEndDate: '2049-12-31T00:00:00.0000000+00:00'
isLeased: false
leaseAmount: null
hasCarWash: true
gasBuddyId: 144554
brandId: 1
brandName: Casey's
is24Hours: false
isFirstPartyDelivery: false
hasOnlineOrdering: true
loyaltyPrograms:
- name: Hyvee
deliveryVendors:
- name: Doordash delivery
carWash:
type: Touch Free in-bay x2
'404':
description: No resource was found for the given identifier.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
'500':
description: An error occurred while processing the request.
content:
application/json:
schema:
$ref: '#/components/schemas/apiError'
example:
code: 0
message: string
/store/{storeNumber}/hours:
get:
tags:
- hours
- v0
- deprecated
summary: v0 Gets a store's hours [DEPRECATED]
description: Gets the store hours data for a specific store.
operationId: getHoursByStoreV0
parameters:
- name: storeNumber
in: path
description: The unique identifier of the store to get data about.
required: true
schema:
type: integer
responses:
'200':
description: This resource represents the different working hours for a store.
content:
application/json:
schema:
$ref: '#/components/schemas/storeHoursInfoV0'
example:
hoursBlocks:
- type: StoreOpenHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Tuesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Wednesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Thursday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Friday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Saturday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- type: CarryoutHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Tuesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Wednesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Thursday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Friday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Saturday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- type: DoorDashHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Tuesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Wednesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Thursday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Friday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- dayOfWeek: Saturday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:30:00.0000000+00:00'
- type: PumpHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Monday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Tuesday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Wednesday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Thursday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Friday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Saturday
startTime: '2026-09-03'
endTime: 1.00:00:00
- type: CarWashHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Monday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Tuesday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Wednesday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Thursday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Friday
startTime: '2026-09-03'
endTime: 1.00:00:00
- dayOfWeek: Saturday
startTime: '2026-09-03'
endTime: 1.00:00:00
- type: CurbSideHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Tuesday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Wednesday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Thursday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Friday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Saturday
startTime: '2026-09-03T06:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- type: KitchenHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Sunday
startTime: '2026-09-03T04:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Sunday
startTime: '2026-09-03T10:00:00.0000000+00:00'
endTime: '2026-09-03T11:00:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T04:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Monday
startTime: '2026-09-03T10:00:00.0000000+00:00'
endTime: '2026-09-03T11:00:00.0000000+00:00'
- dayOfWeek: Tuesday
startTime: '2026-09-03T05:00:00.0000000+00:00'
endTime: '2026-09-03T10:00:00.0000000+00:00'
- dayOfWeek: Tuesday
startTime: '2026-09-03T
# --- truncated at 32 KB (127 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/caseys-general-stores/refs/heads/main/openapi/caseys-general-stores-store-api-openapi.yml