# List export column presets

```http
GET https://secure.yoprint.com/v1/api/store/{team_slug}/data_export/presets
```

- API version: v1
- Operation ID: `v1_public_data_export_presets`
- Section: Imports and exports › [Data exports](https://developer.yoprint.com/reference/data-exports.md)
- Web page: https://developer.yoprint.com/reference/data-exports/v1-data-export-presets/
- Authentication: `Authorization: Bearer YOUR_API_KEY`

Lists the saved column choices (presets) you can use: the team's shared presets, and your own personal ones. Other members' personal presets are not shown. Sorted by type, then name; not paged.

A preset only stores `columns`. To use one, send its `config.columns` as `columns` when you create an export.

## Permission

Any member of the team.

## Path parameters

- `team_slug` (string, required): Your team slug, shown as Team ID next to your API key in Profile. Example `your-team`.

## Request body

This operation takes no request body.

### Example request

```bash
curl 'https://secure.yoprint.com/v1/api/store/your-team/data_export/presets' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Accept: application/json' \
  -H 'X-Yoprint-Decimal-Format: exact-v1'
```

## Response

`200` Successful response.

Fields:

- `data` (array of objects, required)
  - Each item:
    - `config` (object, required)
      - `columns` (array of strings, optional): Column ids, in file order. Send them as `columns` when you create an export.
      - `schema_version` (integer, optional): Version of the column list (1).
    - `id` (string, required): The preset id. Use it to delete the preset.
    - `is_team_default` (boolean, required): The team's default preset for this type. At most one per type.
    - `name` (string, required)
    - `type` (string, required): One of: `"customer_list"`, `"sales_order_list"`, `"invoice_list"`, `"invoice_item_list"`, `"payment_list"`, `"purchase_order_list"`, `"tax_list"`, `"simple_product_list"`, `"variant_product_list"`.
    - `user_id` (string | null, required): Your user id (a hash id) for a personal preset; null for a shared team preset.
- `status` (integer, required)
- `success` (boolean, required)

Example response:

```json
{
  "data": [
    {
      "config": {
        "columns": [
          "invoice_id",
          "customer_name",
          "total",
          "tax"
        ],
        "schema_version": 1
      },
      "id": "ZUFZpcm8jcw4J0",
      "is_team_default": false,
      "name": "Accounting",
      "type": "invoice_list",
      "user_id": "VG7s3tFzyQbO2N"
    },
    {
      "config": {
        "columns": [
          "invoice_id",
          "order_id",
          "total",
          "paid_amount",
          "balance_due"
        ],
        "schema_version": 1
      },
      "id": "cDHnZCTddDiS2c",
      "is_team_default": true,
      "name": "Month end",
      "type": "invoice_list",
      "user_id": null
    }
  ],
  "status": 200,
  "success": true
}
```

## Errors

- `401` The API key is missing or wrong (`unauthenticated`).
- `403` You are not allowed to do this. `api_access_not_in_plan`: your team's plan doesn't include API access (Pro and above, with an active subscription or trial), so every request answers this until the team upgrades. When your role lacks the permission the operation needs, the body is only `{"message": "Insufficient Permission"}`. Other refusals use the error envelope, with `unauthorized` or `user_is_not_authorized`.
- `404` Not found. `page_not_found`: the team slug is unknown, you are not a member of the team, or an id in the path is not one of this team's. `code: null`, with a message that starts "No query results for": there is no record with that id.

## Related

- [Save an export column preset](https://developer.yoprint.com/reference/data-exports/v1-data-export-presets-store.md): `POST /v1/api/store/{team_slug}/data_export/presets`
- [Delete an export column preset](https://developer.yoprint.com/reference/data-exports/v1-data-export-presets-delete.md): `DELETE /v1/api/store/{team_slug}/data_export/presets/{presetId}`