---
title: "List your charts"
method: GET
path: "/v1/charts"
---

# List your charts

`GET /v1/charts`

## Request

- Base URL: `https://api.typesearch.ai`
- URL: `https://api.typesearch.ai/v1/charts`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-api-key`

## Query parameters

- `limit` integer
- `before` string

## Response `200`

A page of charts, newest first.

- ChartList
  - `object` 'list', required
  - `data` object[], required
    - `id` string, required
    - `type` string, required
    - `title` string, required
    - `theme` string, required
    - `locale` string, required
    - `created_at` string, required
    - `expires_at` string, nullable, required
    - `embed_url` string, required
    - `image_url` string, required
    - `svg_url` string, required
  - `has_more` boolean, required
  - `next_before` string, nullable, required: Pass it as `before` for the next page.

## Other responses

- `402`: Payment required: `insufficient_credits` (no credit left), `spend_limit_reached` (the key hit its monthly limit) or `budget_too_small`.
- `default`: Error (RFC 9457). In English unless the request sends `Accept-Language: es`.

---

[API](https://skmtc.dev/typesearch/apis/typesearch-news-search-api.md) · [All operations](https://skmtc.dev/typesearch/apis/typesearch-news-search-api/llms.txt) · [OpenAPI document](https://skmtc.dev/typesearch/apis/typesearch-news-search-api/revisions/b270b9a9c6a5?raw)