VTEX · Schema

Schema

Schema information.

CommerceE-CommerceRetailMarketplacePayments

Properties

Name Type Description
title string Schema title.
type string Schema type.
description string Schema's human readable description.
required array Schema required fields.
properties object Object describing each field in your desired schema. In this object, each property is a new object, describing the field according to: `type` (string); `sensitive` (boolean); `pii` (boolean) and `item
documentTTL integer Document time to live, in days. After this many days from its creation or update, any document cerated from this schema will be deleted.
version integer Schema version.
v-indexed array List of fields to be indexed.
v-unique array List of fields that must be unique.
View JSON Schema on GitHub

JSON Schema

vtex-schema-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/schema",
  "title": "Schema",
  "type": "object",
  "description": "Schema information.",
  "required": [
    "title",
    "type",
    "description",
    "required",
    "properties"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Schema title.",
      "example": "Client profile schema."
    },
    "type": {
      "type": "string",
      "description": "Schema type.",
      "example": "object"
    },
    "description": {
      "type": "string",
      "description": "Schema's human readable description.",
      "example": "This schema describes a b2c customer profile."
    },
    "required": {
      "type": "array",
      "description": "Schema required fields.",
      "items": {
        "type": "string",
        "description": "Key of a field that is required in the schema."
      },
      "example": [
        "firstName",
        "lastName",
        "email",
        "document",
        "documentType"
      ]
    },
    "properties": {
      "type": "object",
      "description": "Object describing each field in your desired schema. In this object, each property is a new object, describing the field according to: `type` (string); `sensitive` (boolean); `pii` (boolean) and `items.type` (if field is array).",
      "properties": {
        "additionalProperties": {
          "type": "object",
          "description": "Schema of any given field described in the `properties` field.",
          "required": [
            "type",
            "sensitive",
            "pii"
          ],
          "properties": {
            "type": {
              "type": "string",
              "description": "Schema property type.",
              "example": "string"
            },
            "sensitive": {
              "type": "boolean",
              "description": "Indicates whether the property is sensitive data. Set to `true` if `pii` is `true` and set to `false` if `pii` is `false`.",
              "example": true
            },
            "pii": {
              "type": "boolean",
              "description": "Indicates whether the property is Personal Identifiable Information (PII).",
              "example": true
            },
            "items": {
              "type": "object",
              "description": "Object containing the type of the items if the field is an array. Typically, arrays will contain strings and will be used for fields such as `email`.",
              "properties": {
                "type": {
                  "type": "string",
                  "description": "Field type.",
                  "example": "string"
                }
              },
              "example": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "documentTTL": {
      "type": "integer",
      "description": "Document time to live, in days. After this many days from its creation or update, any document cerated from this schema will be deleted.",
      "example": 1825
    },
    "version": {
      "type": "integer",
      "description": "Schema version.",
      "example": 1
    },
    "v-indexed": {
      "type": "array",
      "description": "List of fields to be indexed.",
      "example": [
        "email",
        "document"
      ],
      "items": {
        "type": "string",
        "description": "Field to be indexed."
      }
    },
    "v-unique": {
      "type": "array",
      "description": "List of fields that must be unique.",
      "example": [
        "email",
        "document"
      ],
      "items": {
        "type": "string",
        "description": "Field that must be unique."
      }
    }
  }
}

Work with this as data

Every JSON Schema 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 schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • 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 JSON Schema
curl "https://apis.io/api/v1/json-schemas/vtex-schema"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

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