TheCarApi · OAuth Scopes

TheCarApi OAuth Scopes

OAuth 2.0 searched

TheCarApi uses OAuth 2.0 but publishes no discrete scopes — access is governed by the grant itself (e.g. client-credentials or role-based authorization) rather than per-scope consent.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

AutomotiveVehicle DataCar AuctionsUsed CarsVehicle InventoryClassifiedsMarket IntelligencePricingVINImage CDNEuropeKoreaJapan Auctions
Scopes: 0 Flows: Method: searched

Scopes (0)

TheCarApi implements OAuth 2.0 but publishes no discrete scopes — access is governed by the grant itself (client-credentials or role-based authorization) rather than per-scope consent.

TheCarApi publishes a real, named scope reference, but the scopes are attached to an API key rather than issued through an OAuth2 authorization flow. There are no oauth2 securitySchemes in the OpenAPI and no authorization/token endpoints. Scopes are granted per endpoint by the operator; a request to a route the key does not cover returns 403.

📄 Provider scope reference: https://thecarapi.com/docs/authentication

Source

OAuth Scopes

Raw ↑ 
generated: '2026-09-01'
method: searched
source: https://thecarapi.com/docs/authentication
docs: https://thecarapi.com/docs/authentication
model: api-key-scopes
oauth2: false
note: >-
  TheCarApi publishes a real, named scope reference, but the scopes are attached to an API key
  rather than issued through an OAuth2 authorization flow. There are no oauth2 securitySchemes in
  the OpenAPI and no authorization/token endpoints. Scopes are granted per endpoint by the
  operator; a request to a route the key does not cover returns 403.
wildcard: '*'
wildcard_note: '`*` grants every route. A scope may also be a literal URL rule rather than a group.'
scope_count: 10
scopes:
  - name: search
    description: Inventory search, filter facets (individually or combined via /api/facets), sources, and the full model catalog.
  - name: catalog
    description: Manufacturer and model-group catalog.
  - name: seo
    description: Popular searches and brand/model slug resolution.
  - name: auctions
    description: Auction detail, images, price history, and VIN history.
  - name: details
    description: Full vehicle details, including upstream fetches.
  - name: top-offers
    description: Auctions priced below their market reference.
  - name: theparking
    description: European classifieds feed, facets, and models.
  - name: market
    description: Cars.bg and auction market price snapshots.
  - name: calculator
    description: Import cost calculator and supported countries.
  - name: ops
    description: >-
      Service health, the contract, and the API index. The provider warns that this group also
      covers internal routes outside the published contract, which are unversioned and may change
      without a changelog entry.
legacy_scopes:
  - name: public
    status: legacy-compatibility
    description: >-
      Legacy compatibility bundle — search facets, catalog, SEO, auctions, calculator and health —
      preserved for older integrations. New keys are issued against the groups above.
default_grant:
  enabled_by_default:
    - /api/search
    - /api/brands
    - /api/models
    - /api/years
    - /api/fuels
    - /api/countries
    - /api/gearboxes
    - /api/sites
    - /load-models
    - /api/facets
    - /api/catalog/*
    - /api/seo/*
    - /api/auction/*
    - /api/auction-images/*
    - /api/calculator/*
    - /api/top-offers
    - /api/theparking/*
    - /api/car-details
    - /api/contract
    - /api/health
    - /
  granted_on_request:
    - /api/vin/{vin}/history
    - /api/cars-bg-market
    - /api/auction-market
    - /api/listVehicles
    - /listVehicles
    - /api/search/auction-ids
  no_key_required:
    - /api/health/live
    - /api/health/ready
discovery:
  startup_check: GET /api/contract
  guidance: >-
    The provider tells clients to call /api/contract once at process start and fail loudly if the
    surface they depend on is absent — a missing scope is a deployment problem, not a runtime one.

Work with this as data

Every scope set 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 oauth scopes

4 MCP tools reach this
  • find_scopesBrowse and filter every scope set 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 scope set 
curl "https://apis.io/api/v1/scopes/thecarapi-scopes"
All oauth scopes 
curl "https://apis.io/api/v1/scopes?limit=25"

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

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

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