Get products

GET/api/v1/getProducts

curl 'https://app.quote.cloud/api/v1/getProducts?client_id=<your client id>' \
  -H 'Authorization: Bearer <your token>'

<your token> and <your client id> are placeholders. Get your own

Inputs

client_idrequiredYou don’t need to enter this here. In your own code, use the Client ID from your OAuth client. How to get one

product_idReturn only this product. Use the id from an earlier response.

skuReturn only products with this SKU.

activeWhich products to return. Leave this out for active products only, or use all for both.

cursorWhere the next page starts. Leave this out for the first page, then send meta.nextCursor from the previous response.

limitHow many results to return per page, up to 100.

Not sure what to enter? Here’s where to find IDs

Example response

{
  "data": [
    {
      "id": "string",
      "name": "string",
      "sku": "string",
      "lineItemName": "string",
      "descriptionNotes": "string",
      "price": 0,
      "cost": 0,
      "defaultQty": 0,
      "term": 0,
      "termBasedPricing": true,
      "status": true,
      "folderName": "string"
    }
  ],
  "pagination": {
    "continueCursor": "string",
    "isDone": true
  }
}

The spec has no example, so this 200 response is generated from the schema. Values are placeholders.

List products or find products by ID or SKU

product_id and sku cannot be combined. The default is active products only.

Permission

An OAuth access token with this scope. How to get a token

products:read

Read products.

Parameters

Not sure what to enter? Here’s where to find IDs.

client_idquery · stringrequired

The Client ID of your OAuth client. It’s public, and goes on every request alongside your access token. Find it in QuoteCloud under Settings → API dashboard → Manage Integrations → OAuth Clients.Length at least 1.

product_idquery · string

Return only this product. Use the id from an earlier response.

skuquery · string

Return only products with this SKU.

activequery · string

Which products to return. Leave this out for active products only, or use all for both.One of active, inactive, true, false, all.

cursorquery · string or null

Where the next page starts. Leave this out for the first page, then send meta.nextCursor from the previous response.

limitquery · integer

How many results to return per page, up to 100.Default 50. Value 1 to 100.

Responses

200Product page.

dataarray of objectrequired

Item fields

idstringrequired

namestringrequired

skustringrequired

lineItemNamestringrequired

descriptionNotesstringrequired

pricenumberrequired

costnumber or nullrequired

defaultQtynumberrequired

termnumberrequired

termBasedPricingboolean

statusbooleanrequired

folderNamestring

paginationobjectrequired

Fields

continueCursorstring or nullrequired

isDonebooleanrequired

400Invalid request or validation failure.

dataobjectrequired

Fields

statusstringrequired

Always error.

messagestringrequired

codestring

documentRefstring

assetGenerationIdstring

errorsarray of object

Item fields

fieldstringrequired

messagestringrequired

401Missing or invalid bearer token or client ID.

errorstringrequired

error_descriptionstring

403Insufficient scope, missing add-on, usage limit, or permission denial.

Exactly one of these:

OAuthError

errorstringrequired

error_descriptionstring

ApiErrorEnvelope

dataobjectrequired

Fields

statusstringrequired

Always error.

messagestringrequired

codestring

documentRefstring

assetGenerationIdstring

errorsarray of object

Item fields

fieldstringrequired

messagestringrequired

Rate limit

120 requests a minute per company, shared across REST, Zapier and MCP. On a 429, wait for Retry-After.