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

# Data catalogs and the Vantage API

> List, inspect, update, reindex, and delete data catalog records via the Vantage API.

Manage data catalogs programmatically using the Vantage API — list catalogs, inspect their structure, add records, reindex after changes, and delete records.

## List and inspect data catalogs

* List all available data catalogs:

  ```
  GET https://your-instance.vantage.abbyy.com/api/publicapi/v1/catalogs
  ```

* Get detailed information about a specific data catalog:

  ```
  GET https://your-instance.vantage.abbyy.com/api/publicapi/v1/catalogs/{catalogId}
  ```

* Get the mapping between a skill's fields and a data catalog's columns:

  ```
  GET https://your-instance.vantage.abbyy.com/api/publicapi/v1/{skillId}/catalogsMapping
  ```

## Update a data catalog

Use the following endpoints to update a data catalog with JSON records.

<Steps>
  <Step title="Add records">
    Send a **POST** request to the **records** resource:

    ```
    POST https://your-instance.vantage.abbyy.com/api/publicapi/v1/catalogs/{catalogId}/records
    ```
  </Step>

  <Step title="Reindex">
    Once updates are complete, reindex the catalog so new data becomes searchable:

    ```
    POST https://your-instance.vantage.abbyy.com/api/publicapi/v1/catalogs/{catalogId}/reindex
    ```

    <Warning>
      Without this reindex request, searches return data from the outdated version of the data catalog.
    </Warning>
  </Step>

  <Step title="Check reindex status">
    Use the operation ID returned from the reindex request to check status:

    ```
    POST https://your-instance.vantage.abbyy.com/api/publicapi/v1/catalogs/{catalogId}/reindex/reindexOperationId/download
    ```
  </Step>
</Steps>

After indexing completes, the catalog is ready for use by Document skills.

## Delete all records

Remove every record from a data catalog:

```
POST https://your-instance.vantage.abbyy.com/api/publicapi/v1/catalogs/{catalogId}/records/delete/download
```

## API reference

For the full Vantage API reference, see the [Swagger documentation](https://vantage-us.abbyy.com/api/index.html?urls.primaryName=publicapi%2Fv1).

## Related topics

<CardGroup cols={2}>
  <Card title="Using data catalogs" icon="database" href="/vantage/documentation/skill-designer/document/using-data-catalogs/use">
    Use data catalogs to validate and auto-populate extracted data from a Document skill.
  </Card>

  <Card title="Create data catalogs" icon="plus" href="/vantage/documentation/skill-designer/document/using-data-catalogs/create">
    Create a data catalog from a CSV file or by entering columns manually.
  </Card>

  <Card title="Update data catalogs" icon="arrows-rotate" href="/vantage/documentation/skill-designer/document/using-data-catalogs/update">
    Update a data catalog by uploading a CSV file through the UI or via an SFTP shared folder.
  </Card>

  <Card title="Create data catalog lookup rules" icon="circle-check" href="/vantage/documentation/skill-designer/document/rule-verification/setting-lookup-rules">
    Verify extracted document fields against data catalog records using exact or fuzzy matching.
  </Card>
</CardGroup>
