AuraVMS Supplier Management API
Create, list, and manage your supplier directory.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/auravms-com:auravms-com-supplier-management-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.
OpenAPI Specification
openapi: 3.2.0
info:
title: AuraVMS Supplier Management API
version: 1.1.0
description: Create RFQs, manage suppliers, compare supplier quotations, and place purchase orders. Mutating operations can send supplier email or create business records; obtain user confirmation before calling them.
contact:
name: AuraVMS
url: https://www.auravms.com/contact
license:
name: Proprietary
x-versioning-policy: Stable versions are encoded in URL paths. Deprecated operations identify a replacement and advertise Deprecation and Sunset response headers before removal. See https://www.auravms.com/api-versioning.md.
x-deprecation-policy: https://www.auravms.com/api-versioning.md
servers:
- url: https://api.auravms.com
description: Production API
security:
- BearerAuth: []
tags:
- name: Supplier Management
description: Create, list, and manage your supplier directory.
paths:
/api/create-supplier/:
post:
operationId: post_suppliers_api_create_supplier_1
tags:
- Supplier Management
summary: Add a new supplier to your directory
description: Add a new supplier to your directory. All four fields (company_name, person_of_contact, phone_no, email) are required. Email must be unique within your organization.
parameters:
- name: Idempotency-Key
in: header
required: false
description: Replay key for JSON mutations. Reuse with the same body returns the original response for 24 hours; reuse with a different body returns 409.
schema:
type: string
minLength: 8
maxLength: 255
pattern: ^[A-Za-z0-9._:-]+$
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
company_name:
type: string
person_of_contact:
type: string
phone_no:
type: string
email:
type: string
categories:
type: array
items:
type: string
remark:
type: string
required:
- company_name
- person_of_contact
- phone_no
- email
- categories
- remark
additionalProperties: true
example:
company_name: ABC Steel Co.
person_of_contact: Jane Smith
phone_no: 555-0199
email: contact@abcsteel.com
categories:
- Raw Materials
remark: Primary steel vendor
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: object
properties:
supplier_id:
type: string
required:
- supplier_id
additionalProperties: true
required:
- success
- data
additionalProperties: true
example:
success: true
data:
supplier_id: dffcd0de-e7db-443e-898f-7cfc7b970e6d
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'401':
description: Authentication required or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'403':
description: The token cannot perform this action
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'404':
description: The requested resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'409':
description: The idempotency key is still processing or was reused with a different request body
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
put:
operationId: put_suppliers_api_create_supplier_2
tags:
- Supplier Management
summary: Update an existing supplier
description: Update an existing supplier.
parameters:
- name: Idempotency-Key
in: header
required: false
description: Replay key for JSON mutations. Reuse with the same body returns the original response for 24 hours; reuse with a different body returns 409.
schema:
type: string
minLength: 8
maxLength: 255
pattern: ^[A-Za-z0-9._:-]+$
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
supplier_id:
type: string
company_name:
type: string
person_of_contact:
type: string
phone_no:
type: string
email:
type: string
categories:
type: array
items:
type: string
remark:
type: string
required:
- supplier_id
- company_name
- person_of_contact
- phone_no
- email
- categories
- remark
additionalProperties: true
example:
supplier_id: dffcd0de-e7db-443e-898f-7cfc7b970e6d
company_name: ABC Steel Corporation
person_of_contact: Jane Smith
phone_no: 555-0200
email: contact@abcsteel.com
categories:
- Raw Materials
- Metals
remark: Updated contact
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
required:
- success
additionalProperties: true
example:
success: true
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'401':
description: Authentication required or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'403':
description: The token cannot perform this action
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'404':
description: The requested resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'409':
description: The idempotency key is still processing or was reused with a different request body
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
/api/get-suppliers/:
get:
operationId: get_suppliers_api_get_suppliers_3
tags:
- Supplier Management
summary: List all suppliers in your directory
description: List all suppliers in your directory.
parameters:
- name: search
in: query
required: false
description: Search by company name or email
schema:
type: string
- name: category
in: query
required: false
description: Filter by category name
schema:
type: string
- name: page
in: query
required: false
description: 'Page number (default: 1)'
schema:
type: integer
- name: page_size
in: query
required: false
description: 'Results per page (default: 20)'
schema:
type: integer
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: array
items:
type: object
properties:
supplier_id:
type: string
company:
type: string
person:
type: string
phone:
type: string
email:
type: string
categories:
type: array
items:
type: object
properties:
category_id:
type: integer
category_name:
type: string
required:
- category_id
- category_name
additionalProperties: true
remark:
type: string
required:
- supplier_id
- company
- person
- phone
- email
- categories
- remark
additionalProperties: true
required:
- success
- data
additionalProperties: true
example:
success: true
data:
- supplier_id: dffcd0de-e7db-443e-898f-7cfc7b970e6d
company: ABC Steel Co.
person: Jane Smith
phone: 555-0199
email: contact@abcsteel.com
categories:
- category_id: 1
category_name: Raw Materials
remark: Primary steel vendor
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'401':
description: Authentication required or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'403':
description: The token cannot perform this action
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'404':
description: The requested resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
/api/get-supplier-categories/:
get:
operationId: get_suppliers_api_get_supplier_categories_4
tags:
- Supplier Management
summary: Get all supplier categories in your organization
description: Get all supplier categories in your organization.
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: array
items:
type: object
properties:
label:
type: string
value:
type: string
required:
- label
- value
additionalProperties: true
required:
- success
- data
additionalProperties: true
example:
success: true
data:
- label: Raw Materials
value: Raw Materials
- label: Packaging
value: Packaging
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'401':
description: Authentication required or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'403':
description: The token cannot perform this action
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'404':
description: The requested resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
/api/get-supplier-stats-data/:
get:
operationId: get_suppliers_api_get_supplier_stats_data_5
tags:
- Supplier Management
summary: Get performance statistics for all suppliers
description: Get performance statistics for all suppliers.
responses:
'200':
description: Successful response
content:
application/json:
schema:
type: object
properties:
success:
type: boolean
data:
type: array
items:
type: object
properties:
supplier_id:
type: string
company_name:
type: string
quotes_requested:
type: integer
quotes_received:
type: integer
quotes_value:
type: integer
order_placed:
type: integer
total_order_value:
type: integer
success_percent:
type: string
contribution_percent:
type: string
required:
- supplier_id
- company_name
- quotes_requested
- quotes_received
- quotes_value
- order_placed
- total_order_value
- success_percent
- contribution_percent
additionalProperties: true
required:
- success
- data
additionalProperties: true
example:
success: true
data:
- supplier_id: dffcd0de-...
company_name: ABC Steel Co.
quotes_requested: 10
quotes_received: 8
quotes_value: 45000
order_placed: 3
total_order_value: 15000
success_percent: 37.5%
contribution_percent: 45.0%
'400':
description: Invalid request
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'401':
description: Authentication required or invalid
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'403':
description: The token cannot perform this action
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'404':
description: The requested resource was not found
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
example:
success: false
error:
code: authentication_failed
message: A valid Bearer token is required.
components:
schemas:
ApiError:
type: object
required:
- success
- error
properties:
success:
type: boolean
const: false
error:
type: object
required:
- code
- message
properties:
code:
type: string
message:
type: string
details: {}
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT or avms_ API key
description: Use a JWT access token or an API key created under Settings > API Keys. AuraVMS does not currently expose OAuth authorization.
externalDocs:
description: AuraVMS API and agent guide
url: https://www.auravms.com/docs