Shop-Ware Vendors API

The Vendors API from Shop-Ware — 2 operation(s) for vendors.

Operations 2

GET /api/v1/tenants/{tenant_id}/vendors Get a list of all vendors
GET /api/v1/tenants/{tenant_id}/vendors/{id} Get a vendor by ID

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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/shop-ware-vendors-api"
All apis
curl "https://apis.io/api/v1/apis?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.

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

OpenAPI Specification

shop-ware-vendors-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: V1 API Partners Vendors API
  version: v1
  contact:
    name: API Support
    email: support@shop-ware.com
servers:
- url: https://api.shop-ware.com
  description: Base URL declared by the provider in apis.yml (roadmap#122).
security:
- api_partner_id: []
  api_secret: []
tags:
- name: Vendors
paths:
  /api/v1/tenants/{tenant_id}/vendors:
    parameters:
    - name: tenant_id
      in: path
      required: true
      example: '1'
      schema:
        type: integer
    get:
      summary: Get a list of all vendors
      tags:
      - Vendors
      parameters:
      - name: updated_after
        in: query
        required: false
        format: date-time
        description: Filter response to only include records updated after a given time
        example: 2022-10-24T12%3A00%3A00%2B08%3A00
        schema:
          type: string
      - name: page
        in: query
        required: false
        example: '1'
        schema:
          type: integer
      - name: per_page
        in: query
        required: false
        example: '30'
        schema:
          type: integer
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    results:
                    - id: 1
                      created_at: '2026-06-09T14:26:55Z'
                      updated_at: '2026-06-09T14:26:55Z'
                      name: Vendor 3
                      phone: null
                      account_number: null
                      info: null
                      notes: null
                      website: vendor21.com
                      shop_id: 1
                      active: true
                      preferred: false
                      integrator_tags:
                      - id: 1
                        created_at: '2026-06-09T14:26:55Z'
                        updated_at: '2026-06-09T14:26:55Z'
                        taggable_type: Vendor
                        taggable_id: 1
                        name: tag_name
                        value: tag_value
                    limit: 1
                    limited: false
                    total_count: 1
                    current_page: 1
                    total_pages: 1
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: Unique identifier of this record.
                        created_at:
                          type: string
                          format: date-time
                          description: Date and time when record was created.
                        updated_at:
                          type: string
                          format: date-time
                          description: Date and time when record was last updated.
                        name:
                          type: string
                          description: Vendor name.
                        phone:
                          type:
                          - string
                          - 'null'
                          description: Vendor phone.
                        account_number:
                          type:
                          - string
                          - 'null'
                          description: Account number.
                        info:
                          type:
                          - string
                          - 'null'
                          description: Vendor information.
                        notes:
                          type:
                          - text
                          - 'null'
                          description: Notes.
                        website:
                          type:
                          - string
                          - 'null'
                          description: Vendor website.
                        shop_id:
                          type: integer
                          description: A foreign key that points to the Shop that this Vendor belongs to.
                        active:
                          type: boolean
                          description: True if the vendor is still active and in use, false if the vendor has been archived.
                        preferred:
                          type: boolean
                          description: True if the user has marked this vendor as a frequently-used vendor.
                        integrator_tags:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: integer
                                description: The tag primary key.
                              taggable_type:
                                type: string
                                description: Entity type the tag attached to.
                              taggable_id:
                                type: integer
                                description: Entity identifier the tag attached to.
                              name:
                                type: string
                                description: Tag Name.
                              value:
                                type: string
                                description: Tag Value.
                              created_at:
                                type: string
                                format: date-time
                                description: The date and time when tag was created.
                              updated_at:
                                type: string
                                format: date-time
                                description: The date and time when tag was last updated.
                  limit:
                    type: integer
                  limited:
                    type: boolean
                  total_count:
                    type: integer
                  current_page:
                    type: integer
                  total_pages:
                    type: integer
  /api/v1/tenants/{tenant_id}/vendors/{id}:
    parameters:
    - name: tenant_id
      in: path
      required: true
      example: '1'
      schema:
        type: integer
    - name: id
      in: path
      required: true
      example: '1'
      schema:
        type: integer
    get:
      summary: Get a vendor by ID
      tags:
      - Vendors
      responses:
        '200':
          description: successful
          content:
            application/json:
              examples:
                successful:
                  value:
                    id: 1
                    created_at: '2026-06-09T14:26:58Z'
                    updated_at: '2026-06-09T14:26:58Z'
                    name: Vendor 4
                    phone: null
                    account_number: null
                    info: null
                    notes: null
                    website: vendor22.com
                    shop_id: 1
                    active: true
                    preferred: false
                    integrator_tags:
                    - id: 1
                      created_at: '2026-06-09T14:26:58Z'
                      updated_at: '2026-06-09T14:26:58Z'
                      taggable_type: Vendor
                      taggable_id: 1
                      name: tag_name
                      value: tag_value
              schema:
                type: object
                properties:
                  id:
                    type: integer
                    description: Unique identifier of this record.
                  created_at:
                    type: string
                    format: date-time
                    description: Date and time when record was created.
                  updated_at:
                    type: string
                    format: date-time
                    description: Date and time when record was last updated.
                  name:
                    type: string
                    description: Vendor name.
                  phone:
                    type:
                    - string
                    - 'null'
                    description: Vendor phone.
                  account_number:
                    type:
                    - string
                    - 'null'
                    description: Account number.
                  info:
                    type:
                    - string
                    - 'null'
                    description: Vendor information.
                  notes:
                    type:
                    - text
                    - 'null'
                    description: Notes.
                  website:
                    type:
                    - string
                    - 'null'
                    description: Vendor website.
                  shop_id:
                    type: integer
                    description: A foreign key that points to the Shop that this Vendor belongs to.
                  active:
                    type: boolean
                    description: True if the vendor is still active and in use, false if the vendor has been archived.
                  preferred:
                    type: boolean
                    description: True if the user has marked this vendor as a frequently-used vendor.
                  integrator_tags:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: The tag primary key.
                        taggable_type:
                          type: string
                          description: Entity type the tag attached to.
                        taggable_id:
                          type: integer
                          description: Entity identifier the tag attached to.
                        name:
                          type: string
                          description: Tag Name.
                        value:
                          type: string
                          description: Tag Value.
                        created_at:
                          type: string
                          format: date-time
                          description: The date and time when tag was created.
                        updated_at:
                          type: string
                          format: date-time
                          description: The date and time when tag was last updated.
components:
  securitySchemes:
    api_partner_id:
      type: apiKey
      name: X-Api-Partner-Id
      in: header
    api_secret:
      type: apiKey
      name: X-Api-Secret
      in: header