Skip to main content

Get a product​

Retrieve a single product by its Corso ID. Only products created through this API are returned, and deleted ones come back with deletedOn set.

Path Parameters
  • productId number required

    The Corso ID for the product

    Example: 902113
Responses

OK

Schema
  • productId number required

    The Corso ID of the product. Use this for all subsequent reads, updates, and deletes.

  • storeId number required

    The Corso ID of the store that the product belongs to.

  • handle string required

    The handle that identifies the product. Sending the same handle to POST /products updates this product rather than creating a new one.

  • title string

    The title of the product.

  • vendor string

    The vendor of the product.

  • productType string

    The product type.

  • tags string[]

    The tags applied to the product.

  • status string required

    Possible values: [active, archived, draft]

    The status of the product. Only active products are usable in Corso.

  • imageUrl string

    A publicly reachable image URL for the product. Corso stores the URL as given and does not re-host the image.

  • options object[]

    The options defined across the product's variants.

  • Array [
  • name string required

    The name of the option.

  • position number required

    The 1-based position of the option on the product, following the order the options were sent in.

  • values string[] required

    Every value used for this option across all variants.

  • ]
  • variants object[] required

    The variants of the product.

  • Array [
  • variantId number required

    The Corso ID of the variant.

  • options object[] required

    The option values that identify this variant. This combination is the variant's identity, so the variant keeps its variantId across writes for as long as the values are unchanged, no matter what order they are sent in. The order is preserved here and in the product's options, and determines how Corso composes the variant's display name.

  • Array [
  • name string required

    The name of the option.

  • value string required

    This variant's value for the option.

  • ]
  • sku string

    The stock keeping unit (SKU) for the variant.

  • barcode string

    The barcode, UPC, or ISBN for the variant.

  • grams number

    The weight of the variant in grams.

  • price string

    The price of the variant, in the store's currency.

  • compareAtPrice string

    The compare-at (list) price of the variant.

  • unitCost string

    The cost of goods for the variant.

  • imageUrl string

    A publicly reachable image URL for the variant. Corso stores the URL as given and does not re-host the image.

  • title string

    The variant title Corso derives from its option values, or the product title for a single-variant product.

  • displayName string

    The customer-facing name Corso shows for the variant.

  • displayPosition number

    The 1-based position of the variant, following the order the variants were sent in.

  • ]
  • createdOn date-time

    The date/time when the product was created in Corso.

  • updatedOn date-time

    The date/time when the product was last updated in Corso.

  • deletedOn date-time

    The date/time when the product was deleted, if it has been. A deleted product is still retrievable but is excluded from returns, exchanges, and search results.

Loading...