Puzzle Vendors API
The Vendors API from Puzzle — 2 operation(s) for vendors.
The Vendors API from Puzzle — 2 operation(s) for vendors.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/puzzle-vendors-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Puzzle Vendors API
description: Puzzle Api
version: '0'
servers:
- url: https://staging.southparkdata.com/rest/v0
tags:
- name: Vendors
paths:
/company/{id}/vendors:
get:
operationId: vendors
summary: Get Vendors
description: 'Retrieves a list of all of the company''s vendors.
Required scope: read:company'
tags:
- Vendors
parameters:
- name: id
in: path
required: true
description: The company ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
- name: type
in: query
required: false
schema:
type: string
enum:
- Individual
- Business
- Unknown
- name: status
in: query
required: false
schema:
type: string
enum:
- Active
- Inactive
- Unknown
- name: permaNames
in: query
required: false
schema:
anyOf:
- type: string
- type: array
items:
type: string
- name: is1099Vendor
in: query
required: false
schema:
type: string
description: Boolean flag; "true" enables, any other value disables
- name: count
in: query
required: false
schema:
type: integer
- name: after
in: query
required: false
schema:
type: string
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
items:
type: array
items:
type: object
properties:
id:
type: string
minLength: 1
description: Partner-facing external identifier
permaName:
type: string
name:
type: string
is1099Vendor:
type:
- boolean
- 'null'
description:
type:
- string
- 'null'
type:
type:
- string
- 'null'
enum:
- Individual
- Business
- Unknown
status:
type:
- string
- 'null'
enum:
- Active
- Inactive
- Unknown
required:
- id
- permaName
- name
- is1099Vendor
- description
- type
- status
pageInfo:
type: object
properties:
endCursor:
type:
- string
- 'null'
hasNextPage:
type: boolean
total:
type:
- integer
- 'null'
required:
- endCursor
- hasNextPage
- total
required:
- items
- pageInfo
post:
operationId: createVendorApi
summary: Create Vendor
description: 'Creates a new Vendor for the company.
Required scope: write:vendor'
tags:
- Vendors
parameters:
- name: id
in: path
required: true
description: The company ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
minLength: 1
is1099Vendor:
type: boolean
description:
type: string
type:
type: string
enum:
- Individual
- Business
- Unknown
status:
type: string
enum:
- Active
- Inactive
- Unknown
required:
- name
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
minLength: 1
description: Partner-facing external identifier
permaName:
type: string
name:
type: string
is1099Vendor:
type:
- boolean
- 'null'
description:
type:
- string
- 'null'
type:
type:
- string
- 'null'
enum:
- Individual
- Business
- Unknown
status:
type:
- string
- 'null'
enum:
- Active
- Inactive
- Unknown
required:
- id
- permaName
- name
- is1099Vendor
- description
- type
- status
/company/{id}/vendors/{vendorId}:
patch:
operationId: updateVendorApi
summary: Update Vendor
description: 'Updates an existing Vendor for the company.
Required scope: write:vendor'
tags:
- Vendors
parameters:
- name: id
in: path
required: true
description: The company ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
- name: vendorId
in: path
required: true
description: The vendor ID
schema:
type: string
minLength: 1
description: Partner-facing external identifier
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
name:
type: string
is1099Vendor:
type: boolean
description:
type: string
type:
type: string
enum:
- Individual
- Business
- Unknown
status:
type: string
enum:
- Active
- Inactive
- Unknown
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
id:
type: string
minLength: 1
description: Partner-facing external identifier
permaName:
type: string
name:
type: string
is1099Vendor:
type:
- boolean
- 'null'
description:
type:
- string
- 'null'
type:
type:
- string
- 'null'
enum:
- Individual
- Business
- Unknown
status:
type:
- string
- 'null'
enum:
- Active
- Inactive
- Unknown
required:
- id
- permaName
- name
- is1099Vendor
- description
- type
- status