List data items

GET/api/v1/getDataItems

This endpoint isn’t available for live testing.

curl 'https://app.quote.cloud/api/v1/getDataItems?client_id=<your client id>&connection=<connection>' \
  -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

connectionrequiredWhich kind of record to list data items for.

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

Example response

[
  {
    "id": "string",
    "index": 1,
    "key": "string",
    "label": "string",
    "type": "string",
    "connection": "document",
    "mandatory": true,
    "defaultValue": "string",
    "values": "string"
  }
]

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

List custom data-item definitions

Permission

An OAuth access token with any one of these scopes. How to get a token

contacts:create

Create contacts.

products:create

Create or update products.

documents:create

Create documents and read creation metadata.

connection_contact needs contacts:create.

connection_product needs products:create.

connection_document needs documents:create.

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.

connectionquery · stringrequired

Which kind of record to list data items for.One of contact, product, document.

Responses

200Data-item definitions.

An array. Each item has:

idstringrequired

indexintegerrequired

Value at least 1.

keystringrequired

Matches ^customfield\d+$.

labelstringrequired

typestringrequired

One of string, number, date, dateTime, boolean, currency, select, multiselect, check.

connectionstringrequired

One of document, template, user, contact, product, contactDocumentLink.

mandatorybooleanrequired

defaultValuestringrequired

valuesanyrequired

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.