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

# Quickstart

> From API key to your first submitted proposal in four requests.

This walkthrough takes you through one full turn of the [pipeline](/enrichment/pipeline). You'll need
an [API key](/authentication/request-api-key) with both `catalog:read` and `catalog:submit` scopes.

<Steps>
  <Step title="Set your key">
    ```bash theme={null}
    export VERZLA_ENRICHMENT_KEY="sk_live_your_key_here"
    export VERZLA_BASE="https://api.verzla.com/api/enrichment"
    ```
  </Step>

  <Step title="Fetch the attribute templates">
    Learn the schema you're enriching against.

    ```bash theme={null}
    curl "$VERZLA_BASE/attribute-templates" \
      -H "X-Api-Client-Key: $VERZLA_ENRICHMENT_KEY"
    ```

    Note the `id`, `attribute`, `unit`, and `dataType` of each option — your proposals should
    line up with these.
  </Step>

  <Step title="Fetch a page of products">
    Pull the first 25 active products to enrich.

    ```bash theme={null}
    curl "$VERZLA_BASE/products?page=0&pageSize=25" \
      -H "X-Api-Client-Key: $VERZLA_ENRICHMENT_KEY"
    ```

    Or target specific SKUs (up to 50):

    ```bash theme={null}
    curl "$VERZLA_BASE/products/skus" \
      -H "X-Api-Client-Key: $VERZLA_ENRICHMENT_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "skus": ["ABC-123", "ABC-124"] }'
    ```
  </Step>

  <Step title="Generate and submit proposals">
    Run your model over the products, then submit — with a `confidence` score per item.

    ```bash theme={null}
    curl "$VERZLA_BASE/products/submissions" \
      -H "X-Api-Client-Key: $VERZLA_ENRICHMENT_KEY" \
      -H "Content-Type: application/json" \
      -d '{
        "externalSubmissionId": "quickstart-001",
        "items": [
          {
            "sku": "ABC-123",
            "confidence": 88,
            "description": "An 18V brushless impact driver with 180 Nm of torque...",
            "attributes": [
              { "attribute": "Voltage", "detail": "18", "option": { "optionId": 880, "unit": "V", "priority": 1, "dataType": "NUMBER", "showOnWebsite": true } }
            ]
          }
        ]
      }'
    ```

    A `CREATED` status with a `revisionId` means your proposal is queued for review.
  </Step>

  <Step title="Watch your acceptance rate">
    Once reviewers work through the queue, check how you're doing.

    ```bash theme={null}
    curl "$VERZLA_BASE/acceptance-rate" \
      -H "X-Api-Client-Key: $VERZLA_ENRICHMENT_KEY"
    ```

    <Note>See [tracking your acceptance rate](/enrichment/acceptance-rate) for the full breakdown.</Note>
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Attribute templates" icon="table-list" href="/enrichment/attribute-templates">
    Align your proposals to the merchant's schema.
  </Card>

  <Card title="Submitting proposals" icon="wand-magic-sparkles" href="/enrichment/submitting-proposals">
    Confidence scoring, batching, and result handling in depth.
  </Card>
</CardGroup>