> ## Documentation Index
> Fetch the complete documentation index at: https://spreecommerce.org/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve a Vendor

> Returns the details of a specified Vendor. Only available in [Enterprise Edition](https://spreecommerce.org/pricing)



## OpenAPI

````yaml /api-reference/storefront.yaml get /api/v2/storefront/vendors/{vendor_slug}
openapi: 3.0.3
info:
  version: 2.0.0
  title: Storefront API
  description: >-
    Storefront API is a modern REST API based on the [JSON API
    spec](https://jsonapi.org/) which provides you with all the necessary
    endpoints to build amazing user interfaces either in JavaScript frameworks
    or native mobile libraries.


    Import to
    [Postman](https://raw.githubusercontent.com/spree/spree/main/docs/api-reference/storefront.yaml)
  contact:
    name: Vendo Connect Inc.
    url: https://spreecommerce.org
    email: hello@spreecommerce.org
  license:
    name: BSD-3-Clause
    url: https://github.com/spree/spree/blob/main/LICENSE.md
servers:
  - url: https://demo.spreecommerce.org
    description: demo
  - url: http://localhost:3000
    description: localhost
security: []
tags:
  - name: Account
  - name: Account / Address
  - name: Account / Credit Cards
  - name: Account / Orders
  - name: Cart
  - name: Cart / Line Items
  - name: Cart / Coupons
  - name: Cart / Other
  - name: Checkout
  - name: Checkout / State
  - name: Checkout / Shipments
  - name: Checkout / Payments
  - name: Checkout / Store Credit
  - name: Stripe
  - name: Adyen
  - name: Countries
  - name: Digital Downloads
  - name: Order Status
  - name: Products
  - name: Variants
  - name: Stores
  - name: Policies
  - name: Taxons
  - name: Vendors
  - name: Wishlists
  - name: Wishlists / Wished Items
paths:
  /api/v2/storefront/vendors/{vendor_slug}:
    get:
      tags:
        - Vendors
      summary: Retrieve a Vendor
      description: >-
        Returns the details of a specified Vendor. Only available in [Enterprise
        Edition](https://spreecommerce.org/pricing)
      operationId: show-vendor
      parameters:
        - $ref: '#/components/parameters/VendorSlug'
        - $ref: '#/components/parameters/SparseFieldsVendor'
      responses:
        '200':
          $ref: '#/components/responses/Vendor'
        '404':
          $ref: '#/components/responses/404NotFound'
components:
  parameters:
    VendorSlug:
      name: vendor_slug
      in: path
      required: true
      description: Look for Vendor by ID or their slug
      schema:
        type: string
      example: acme-co
    SparseFieldsVendor:
      name: fields[vendor]
      in: query
      description: >-
        Specify the fields you would like returned in the response body. [More
        information](https://jsonapi.org/format/#fetching-sparse-fieldsets).
      schema:
        type: string
      example: name,slug,about_us,facebook
  responses:
    Vendor:
      description: 200 Success - Returns the `vendor` object.
      content:
        application/vnd.api+json:
          schema:
            type: object
            properties:
              data:
                $ref: '#/components/schemas/Vendor'
            required:
              - data
          examples:
            Single Vendor:
              value:
                data:
                  id: e1171601-a4ce-47d2-a795-c96fbdf20029
                  type: vendor
                  attributes:
                    name: Best Shoes
                    email: contact@example.com
                    slug: best-shoes
                    about_us: |-
                      <p>We are your #1 shoe store.</p>
                      <p>Follow us on social media.</p>
                    logo_url: https://assets.com/images/logo_name
                    cover_photo_url: https://assets.com/images/wide_tree_wzxgak
    404NotFound:
      description: 404 Not Found - Resource not found.
      content:
        application/vnd.api+json:
          schema:
            properties:
              error:
                type: string
                example: The resource you were looking for could not be found.
                default: The resource you were looking for could not be found.
          examples:
            404 Example:
              value:
                error: The resource you were looking for could not be found.
  schemas:
    Vendor:
      title: Vendor
      description: Vendors are Sellers in the marketplace.
      type: object
      x-internal: true
      properties:
        id:
          type: string
          example: 980a80d5-f51b-4065-b3a0-622fc5cb6bf6
        type:
          type: string
          default: vendor
        attributes:
          type: object
          properties:
            name:
              type: string
              example: Shoes For Everyone
            email:
              type: string
              example: contact@example.com
            slug:
              type: string
              example: shoes-for-everyone
            about_us:
              type: string
              example: >-
                <p>We are the #1 shoe store for you.</p>\n<p>Located in 20
                countries.</p>
              description: Information about the Vendor stored as HTML
            logo_url:
              type: string
              example: https://somewebsite.com/our-logo
              description: URL of the Logo
            cover_photo_url:
              type: string
              example: https://somewebsite.com/our-cover-photo
              description: URL of the Cover Photo
        relationships:
          type: object
          properties:
            products:
              type: object
              description: List of active and available products from this vendor
              properties:
                data:
                  type: array
                  items:
                    $ref: '#/components/schemas/Relation'
      required:
        - id
        - type
        - attributes
        - relationships
    Relation:
      type: object
      nullable: true
      properties:
        id:
          type: string
        type:
          type: string
      required:
        - id
        - type
      x-internal: false
      description: ''

````