Every API here is available over the APIs.io API and to AI agents over MCP.
openapi: 3.0.1
info:
title: OldStoreApi
description: An API to obtain store information.
version: '1.0'
servers:
- url: https://esl.caseys.io/oldstoreapi
paths:
/v1/stores/organizational:
get:
tags:
- store
- v1
- all stores organization hierarchy
summary: v1 Gets all store's organizational hierarchy
description: Gets the organizational data for all stores.
operationId: getAllStoresOrganizationalV1
parameters:
- name: offset
in: query
description: Offsets the data in the list for use in pagination. If you make a request for the first 10
items, then you would need to pass 10 as the offset to get the next set of 10 items. The default value
is 0.
schema:
type: integer
- name: limit
in: query
description: Limits the number of results returned in the list. The default value is 10.
schema:
type: integer
responses:
'200':
description: This resource represents all store's organizational hierarchy.
content:
application/json:
schema:
$ref: '#/components/schemas/allStoresOrganizationalInfoV1'
example:
limit: 0
offset: 0
count: 0
total: 0
data:
- '{"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
/v1/brands:
get:
tags:
- brands
- v1
summary: v1 Gets a list of store branding styles
description: Gets a list of the branding styles available for stores.
operationId: getBrandsV1
responses:
'200':
description: This resource represents a list of branding styles for stores.
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/brandModelV1'
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
/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/districts:
get:
tags:
- organization hierarchy
- v1
summary: v1 Gets a list of districts
description: Gets a list of the data for all districts in the organizational hierarchy.
operationId: getDistrictsV1
responses:
'200':
description: This resource represents a list of data for all districts.
content:
application/json:
schema:
$ref: '#/components/schemas/districtListModelV1'
example:
data:
- '{"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"}]}}'
'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/organizational/divisions:
get:
tags:
- organization hierarchy
- v1
summary: v1 Gets a list of divisions
description: Gets a list of the data for all divisions in the organizational hierarchy.
operationId: getDivisionsV1
responses:
'200':
description: This resource represents a list of data for all divisions.
content:
application/json:
schema:
$ref: '#/components/schemas/divisionListModelV1'
example:
data:
- '{"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"}]}}'
'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
/v1/stores/{storeNumber}/organizational:
get:
tags:
- store
- organization hierarchy
- v1
summary: v1 Gets a store's organizational hierarchy
description: Gets the organizational data for a specific store.
operationId: getStoreOrganizationByIdV1
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/organizationalModelV1'
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
/v1/organizational/regions/{regionId}:
get:
tags:
- organization hierarchy
- region
- v1
summary: v1 Gets a region's data
description: Gets the data for a specific region in the organizational hierarchy.
operationId: getRegionByIdV1
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/regionModelV1'
example:
id: 13
name: Region 13
_links:
parent:
href: /v1/organizational/divisions/9088
children:
- href: /v1/organizational/districts/13
- href: /v1/organizational/districts/14
- href: /v1/organizational/districts/107
- href: /v1/organizational/districts/114
- href: /v1/organizational/districts/115
- href: /v1/organizational/districts/116
- href: /v1/organizational/districts/117
- href: /v1/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
/v1/organizational/regions:
get:
tags:
- organization hierarchy
- v1
summary: v1 Gets a list of regions
description: Gets a list of the data for all regions in the organizational hierarchy.
operationId: getRegionsV1
responses:
'200':
description: This resource represents a list of data for all regions.
content:
application/json:
schema:
$ref: '#/components/schemas/regionListModelV1'
example:
data:
- '{"id":13,"name":"Region 13","_links":{"parent":{"href":"/v1/organizational/divisions/9088"},"children":[{"href":"/v1/organizational/districts/13"},{"href":"/v1/organizational/districts/14"},{"href":"/v1/organizational/districts/107"},{"href":"/v1/organizational/districts/114"},{"href":"/v1/organizational/districts/115"},{"href":"/v1/organizational/districts/116"},{"href":"/v1/organizational/districts/117"},{"href":"/v1/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
/v1/stores/{storeNumber}:
get:
tags:
- store
- v1
summary: v1 Gets a store's data
description: 'Gets the data for a specific store.<br><br>Includes all store classifications<br>Includes new
fields: [AutoAttendantBypassPhoneNumber, CompanyId, Location, CostCenter, Classification]'
operationId: getStoreByIdV1
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/storeInfoV1'
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
autoAttendantBypassPhoneNumber: 5557654328
companyId: 10
location: '00002'
costCenter: '0000'
classification: S
corporateCompany: 505
businessUnit: Casey's Retail Business Unit
storeTruckStop: null
'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/stores/{storeNumber}/hours:
get:
tags:
- hours
- v1
summary: v1 Gets a store's hours
description: Gets the store hours data for a specific store.
operationId: getHoursByStoreV1
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/storeHoursInfoV1'
example:
hoursBlocks:
- type: StoreOpenHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
- type: CarryoutHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
- type: DoorDashHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
- type: PumpHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: 1.00:00:00
- type: CarWashHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: 1.00:00:00
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: 1.00:00:00
- type: CurbSideHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
- type: KitchenHours
hours:
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Sunday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Monday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Tuesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Wednesday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Thursday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Friday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
- dayOfWeek: Saturday
startTime: '2026-09-05'
endTime: '2026-09-05'
storeNumber: 2
'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/stores/hours:
get:
tags:
- hours
- v1
summary: v1 Gets all store hours for a list of paginated stores
description: Gets store hours data for a list of paginated stores.
operationId: getAllStoreHoursV1
parameters:
- name: offset
in: query
description: Offsets the data in the list for use in pagination. If you make a request for the first 10
items, then you would need to pass 10 as the offset to get the next set of 10 items. The default value
is 0.
schema:
type: integer
- name: limit
in: query
description: Limits the number of results returned in the list. The default value is 10.
schema:
type: integer
responses:
'200':
description: This resource represents a list of the store hours data for all stores.
content:
application/json:
schema:
$ref: '#/components/schemas/allStoreHoursInfoV1'
example:
limit: 0
offset: 0
count: 0
total: 0
data:
- '{"hoursBlocks":[{"type":"StoreOpenHours","hours":[{"dayOfWeek":"Sunday","startTime":"05:00:00","endTime":"22:00:00"},{"dayOfWeek":"Monday","startTime":"05:00:00","endTime":"22:00:00"},{"dayOfWeek":"Tuesday","startTime":"05:00:00","endTime":"22:00:00"},{"dayOfWeek":"Wednesday","startTime":"05:00:00","endTime":"22:00:00"},{"dayOfWeek":"Thursday","startTime":"05:00:00","endTime":"22:00:00"},{"dayOfWeek":"Friday","startTime":"05:00:00","endTime":"22:00:00"},{"dayOfWeek":"Saturday","startTime":"05:00:00","endTime":"22:00:00"}]},{"type":"CarryoutHours","hours":[{"dayOfWeek":"Sunday","startTime":"05:00:00","endTime":"22:30:00"},{"dayOfWeek":"Monday","startTime":"05:00:00","endTime":"22:30:00"},{"
# --- truncated at 32 KB (136 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/caseys-general-stores/refs/heads/main/openapi/caseys-general-stores-old-store-api-openapi.yml