> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vantr.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Vantr Developer API
> Build v2 integrations with products, vendors, locations, and usage reporting.
# Developer API
v2 API
Connect Vantr to your catalog, vendor, location, and reporting workflows with scoped credentials managed from the [developer portal](https://api.vantr.ai/developer).
Manage apps, credentials, scopes, usage activity, webhooks, and API-host developer workflows.
Create an application, choose scopes, and make a verified read request from your server.
Browse generated endpoint pages from the same OpenAPI spec that ships with this docs site.
Manage applications, secrets, and request activity in the API-host developer portal. Use these docs for implementation details, endpoint behavior, and generated clients.
## First-class API host
`api.vantr.ai` is the API endpoint and the developer experience home. API-only users can use the Developer Center for docs, OAuth applications, OpenAPI, SDK starters, request activity, webhooks, and sandbox workflows without moving through the business app.
See how Vantr separates marketing, app, docs, portal, OpenAPI, sandbox, and AI discovery surfaces.
## What you can build
Create and update products, variations, categories, and vendor profiles from your system of record.
Read tenant locations and attach valid `location_id` values to downstream workflows.
Read API usage totals and discover the resources available to a given application.
## First useful call
Use locations as the first smoke test. The request proves authentication, tenant binding, pagination, and JSON parsing without changing data.
```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
"https://api.vantr.ai/v2/locations?limit=25"
```
```javascript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
const credentials = Buffer
.from(`${process.env.CLIENT_ID}:${process.env.CLIENT_SECRET}`)
.toString('base64');
const response = await fetch('https://api.vantr.ai/v2/locations?limit=25', {
headers: {
Authorization: `Basic ${credentials}`,
},
});
const data = await response.json();
```
```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import os
import requests
response = requests.get(
"https://api.vantr.ai/v2/locations",
params={"limit": 25},
auth=(os.environ["CLIENT_ID"], os.environ["CLIENT_SECRET"]),
timeout=20,
)
data = response.json()
```
A successful locations request returns `success`, `locations`, and `pagination` fields.
## Developer workflow
Create an Vantr developer application and save the client secret in your server-side secret manager.
Start with read scopes while developing. Add write scopes only for endpoints your integration calls.
Use confidential client auth for server-to-server calls or exchange OAuth grants for bearer tokens.
Use the committed OpenAPI file at `/openapi/v2.json` to generate typed clients for your stack.
## Guide shortcuts
Learn the base URL, auth headers, pagination parameters, and response envelope patterns.
Follow product, category, and vendor examples with realistic request bodies.
Handle OAuth errors, permission failures, validation responses, and archive conflicts.
Connect the docs MCP server, install the API skill, and give agents the OpenAPI contract.
## Reference shortcuts
Product and variation catalog endpoints.
Category list, tree, create, update, and archive endpoints.
Vendor profile read and write endpoints.