BJ's Wholesale Club · API Governance Rules

BJ's Wholesale Club API Rules

Spectral linting rules defining API design standards and conventions for BJ's Wholesale Club.

5 Rules warn 5
View Rules File View on GitHub

Rule Categories

bjs

Rules

warn
bjs-membership-number-required
Orders and membership verifications must include a membershipNumber
$.paths['/membership/verify'].post.requestBody.content['application/json'].schema
warn
bjs-order-status-enum
Order status must be one of the defined enum values
$.components.schemas.Order.properties.status
warn
bjs-product-price-positive
Product price must be defined as a number type
$.components.schemas.Product.properties.price
warn
bjs-api-key-security
All endpoints must use ApiKeyAuth security scheme
$.paths[*][*]
warn
bjs-operations-have-tags
All operations should have at least one tag
$.paths[*][*]

Spectral Ruleset

Raw ↑
rules:
  bjs-membership-number-required:
    description: Orders and membership verifications must include a membershipNumber
    message: "{{description}}"
    given: "$.paths['/membership/verify'].post.requestBody.content['application/json'].schema"
    then:
      field: required
      function: schema
      functionOptions:
        schema:
          type: array
          contains:
            const: membershipNumber

  bjs-order-status-enum:
    description: Order status must be one of the defined enum values
    message: "Order status field must use defined enum values"
    given: "$.components.schemas.Order.properties.status"
    then:
      field: enum
      function: truthy

  bjs-product-price-positive:
    description: Product price must be defined as a number type
    message: "Product price must be a numeric type"
    given: "$.components.schemas.Product.properties.price"
    then:
      field: type
      function: pattern
      functionOptions:
        match: "^number$"

  bjs-api-key-security:
    description: All endpoints must use ApiKeyAuth security scheme
    message: "Endpoint must specify ApiKeyAuth security"
    given: "$.paths[*][*]"
    then:
      field: security
      function: truthy

  bjs-operations-have-tags:
    description: All operations should have at least one tag
    message: "Operation must include at least one tag"
    given: "$.paths[*][*]"
    then:
      field: tags
      function: truthy

Work with this as data

Every ruleset 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 spectral rules

4 MCP tools reach this
  • find_rulesBrowse and filter every ruleset in the catalog.
  • 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 ruleset
curl "https://apis.io/api/v1/rules/bjs-spectral-rules"
All spectral rules
curl "https://apis.io/api/v1/rules?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.

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