Casey's General Stores

Casey's FuelPriceApi

Returns fuel price data for Casey's stores. POST a list of store numbers to /fuelprices to retrieve current fuel pricing per store, with a heartbeat health check.

Documentation GitHub OpenAPI

Operations 3

GET /heartbeat Gets the health of the API. #

POST /fuelprices Get a list of fuel prices. #

GET /openapi/V3.json Get OpenApi Specification #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/caseys-fuelpriceapi"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

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.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.0.1
info:
  title: FuelPriceApi
  description: An API to obtain fuel price information.
  version: '1.0'
servers:
- url: https://esl.caseys.io/fuelpriceapi
paths:
  /heartbeat:
    get:
      tags:
      - heartbeat
      summary: Gets the health of the API.
      description: Interrogates the state of the API and its dependencies to return the API health.
      operationId: getHeartbeat
      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/heartbeatReport'
              example:
                status: string
        '500':
          description: An error occurred while processing the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/heartbeatReport'
              example:
                status: string
  /fuelprices:
    post:
      tags:
      - fuelPrices
      summary: Get a list of fuel prices.
      description: Gets a list of fuel price data for stores.
      operationId: getFuelPricesByStoreNumbers
      requestBody:
        description: A list of store numbers to obtain fuel price data for.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/fuelPriceParameterModel'
            example:
              storeId:
              - 0
      responses:
        '200':
          description: This resource represents a list of fuel price data for the given stores.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/fuelPriceModel'
              example:
                storeId: 0
                updateOn: string
                products:
                - fuelDescription: string
                  productCode: string
                  price: 0
                  octane: 0
                  streetFighter: true
        '400':
          description: The request received was in an invalid state or format.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
              example:
                code: 0
                message: string
        '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
  /openapi/V3.json:
    get:
      summary: Get OpenApi Specification
      description: Gets the OpenApi specification in V3.json format with the parameters .
      operationId: getOpenApiSpec
      responses:
        '200':
          description: ''
components:
  schemas:
    apiError:
      type: object
      properties:
        code:
          type: integer
          description: Status code of the error.
          format: int32
        message:
          type: string
          description: Message that describes the error.
    fuelPriceModel:
      type: object
      properties:
        storeId:
          type: integer
          description: The number of the store.
          format: int32
        updateOn:
          type: string
          description: The date the fuel price was updated on.
          format: date-time
        products:
          type: array
          items:
            $ref: '#/components/schemas/fuelProductModel'
          description: A collection of fuel price products.
    fuelPriceParameterModel:
      type: object
      properties:
        storeId:
          type: array
          items:
            type: integer
            format: int32
    fuelProductModel:
      type: object
      properties:
        fuelDescription:
          type: string
          description: The description of the type of fuel.
        productCode:
          type: string
          description: The code of the fuel product.
        price:
          type: number
          description: The price of the fuel.
          format: double
        octane:
          type: number
          description: The octane rating of the fuel.
          format: double
        streetFighter:
          type: boolean
          description: Indicates high selling fuel that is advertised more often.
    heartbeatReport:
      type: object
      properties:
        status:
          type: string
          description: Description of the current status of dependencies of the API.
  securitySchemes:
    apiKeyHeader:
      type: apiKey
      name: Ocp-Apim-Subscription-Key
      in: header
    apiKeyQuery:
      type: apiKey
      name: subscription-key
      in: query
security:
- apiKeyHeader: []
- apiKeyQuery: []