TheCarApi · OAuth Scopes

TheCarApi OAuth Scopes

OAuth 2.0 searched

TheCarApi publishes 10 OAuth 2.0 scopes. Scopes are the fine-grained permissions an application requests at authorization time to act against the TheCarApi API on a user’s behalf.

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 CDNEuropeSouth KoreaJapan Auctions

Scopes: 10 Flows: Method: searched

Scopes (10)

Scope	Description	Flows
search	Inventory search, filter facets (individually or combined via /api/facets), sources, and the full model catalog.
catalog	Manufacturer and model-group catalog.
seo	Popular searches and brand/model slug resolution.
auctions	Auction detail, images, price history, and VIN history.
details	Full vehicle details, including upstream fetches.
top-offers	Auctions priced below their market reference.
theparking	European classifieds feed, facets, and models.
market	Cars.bg and auction market price snapshots.
calculator	Import cost calculator and supported countries.
ops	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.

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

Source

OAuth Scopes

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 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.