> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xquik.com/llms.txt
> Use this file to discover all available pages before exploring further.
# X community notes API for a writer's deleted notes
> List the Community Notes a contributor deleted, with each note's ID, time, rating status, rater tags, and scoring model. 1 credit per note, empty lists free.
For the complete documentation index, see llms.txt.
List the Community Notes 1 contributor deleted, newest first.
Requested result counts are upper bounds for paid authenticated calls. When remaining credits cannot cover the full page, Xquik returns fewer results. If zero paid results are affordable, it returns `402 insufficient_credits`.
**1 credit per note returned** · [All plans](https://xquik.com/#pricing) from \$0.00012/credit · Supports [guest paid reads](/guides/guest-wallets)
```bash cURL theme={null}
curl "https://xquik.com/api/v1/x/community-notes/contributors/ardent-beach-friarbird/deleted-notes" \
-H "x-api-key: xq_your_api_key_here" | jq
```
```javascript Node.js theme={null}
const alias = "ardent-beach-friarbird";
const url = `https://xquik.com/api/v1/x/community-notes/contributors/${alias}/deleted-notes`;
const response = await fetch(url, {
headers: { "x-api-key": "xq_your_api_key_here" },
});
const data = await response.json();
if (!response.ok) throw new Error(JSON.stringify(data));
const nextCursor = data.has_next_page ? data.next_cursor : null;
const noteRows = data.notes.map((note) => ({
contributor_alias: alias,
note_id: note.id,
created_at: note.createdAt ?? null,
rating_status: note.ratingStatus ?? null,
next_cursor: nextCursor,
}));
```
```python Python theme={null}
import requests
alias = "ardent-beach-friarbird"
response = requests.get(
f"https://xquik.com/api/v1/x/community-notes/contributors/{alias}/deleted-notes",
headers={"x-api-key": "xq_your_api_key_here"},
)
data = response.json()
if not response.ok:
raise RuntimeError(data)
next_cursor = data["next_cursor"] if data["has_next_page"] else None
note_rows = [
{
"contributor_alias": alias,
"note_id": note["id"],
"created_at": note.get("createdAt"),
"rating_status": note.get("ratingStatus"),
"next_cursor": next_cursor,
}
for note in data["notes"]
]
```
The Node.js and Python snippets build 1 row per note. Store the rows with the cursor before you request the next page.
## What does X keep of a deleted note?
X keeps each deleted note's ID, time, rating status, rater tags & scoring model. It shows a notice in place of the
note's text, so `text`, `classification` & `post` are left out. `tombstone` holds that notice.
A contributor who deleted no note returns an empty list, which is free.
[Get notes contributor](/api-reference/x/community-notes-contributor) returns the count in `deletedNotesCount`.
## Page through deleted notes
Each page returns `has_next_page` and `next_cursor`. Send `next_cursor` back as `cursor`. Stop when `has_next_page` is
`false`.
A cursor X never issued returns `400 invalid_cursor`, which is free. Start again without `cursor`, then use
`next_cursor`.
## Path parameters
Contributor alias, such as `ardent-beach-friarbird`. The URL-encoded contributor URL also works, such as
`x.com/i/communitynotes/u/ardent-beach-friarbird`. Any letter case works.
## Query parameters
Pagination cursor from a previous response. Omit for the first page.
Notes per page, from `1` to `10`. Defaults to `10`. Also read as `limit`, `count`, `max_results`, `maxItems`,
`max_items` & `per_page`.
### Choose fields
Fields to keep in each row, comma-separated, such as `id,text,author.username`. Use dots for nested fields. Case & underscores do not matter. A row that lacks a field leaves it out. Cursors, counts & diagnostics always stay. An unknown name returns `400 unknown_field` with the valid names, before any read. The price stays the same.
Fields to drop from each row, comma-separated, such as `entities,media`. It takes the same names as `fields`. With `fields`, it drops from the kept fields.
## Headers
Full account key. Sessions and OAuth also work.
`Bearer xq_your_guest_key_here` for `paid_reads`.
## Response
### 200 OK
X leaves out a field that a note lacks. Only `id` is always present.
The contributor's deleted notes, newest first.
**Note object fields.**
Note ID.
When the contributor wrote the note, as ISO 8601.
X's rating of the note, such as `NeedsMoreRatings` or `CurrentlyRatedNotHelpful`.
Why raters called the note helpful.
Why raters called the note not helpful.
The X scoring model that set the rating.
Whether X marks that scoring model as fully visible.
Whether the note scores above X's bar for a possible helpful rating.
Whether the rating is under appeal.
`true` for a deleted note.
X's notice in place of the note, such as `This note has been deleted`.
Whether the note came through X's API.
Whether the note was about a post's media.
Other posts X matched a media note to.
Whether the note was on a link.
Whether more notes follow.
Cursor for the next page. Empty at the end of the list.
### 400 Invalid alias or cursor
```json theme={null}
{
"error": "invalid_contributor_alias",
"message": "Send a Community Notes alias or its x.com/i/communitynotes/u URL."
}
```
A cursor X never issued returns `invalid_cursor`. Start again without `cursor`. Both answers are free.
### 404 Contributor not found
```json theme={null}
{
"error": "contributor_not_found",
"message": "Contributor not found. Check the alias on its x.com/i/communitynotes/u page."
}
```
No contributor holds the alias. This answer is free.
### 401 Unauthenticated
Anonymous requests get `WWW-Authenticate: Bearer` and a guest wallet checkout action. This is not a Payment challenge.
```json theme={null}
{ "error": "unauthenticated" }
```
### 402 Payment required
Account keys get account options. Guest keys get guest top-up only.
No checkout starts automatically. Confirm any payment action.
### 502 X API unavailable
```json theme={null}
{ "error": "x_api_unavailable" }
```
The read service returned an error. Retry after a short delay.
### 429 Rate limit exceeded
```json theme={null}
{ "error": "rate_limit_exceeded", "retryAfter": 60 }
```
You exceeded your tier rate limit. Wait for the `Retry-After` header before retrying.
### 424 Dependency failed
```json theme={null}
{ "error": "x_api_unavailable" }
```
The normalized v1 response contract can return 424 when the read service is unavailable.
**Related.** [Get notes contributor](/api-reference/x/community-notes-contributor) · [Contributor notes](/api-reference/x/community-notes-contributor-notes) · [Get tweet](/api-reference/x/get-tweet)
* Tweets: [Get tweet](/api-reference/x/get-tweet) · [Tweet insights](/api-reference/x/tweet-engagement-insights) · [Batch tweets](/api-reference/x/batch-tweets) · [Tweet thread](/api-reference/x/tweet-thread) · [Hidden replies](/api-reference/x/tweet-hidden-replies) · [Translate tweet](/api-reference/x/tweet-translation) · [Embed tweet](/api-reference/x/tweet-embed) · [Resolve links](/api-reference/x/resolve-links) · [Tweet subtitles](/api-reference/x/tweet-subtitles) · [X Article](/api-reference/x/get-article)
* Analysis: [Sentiment analysis](/api-reference/x/sentiment-analysis) · [Brand mentions](/api-reference/x/brand-monitoring) · [News classification](/api-reference/x/news-classification) · [Market signals](/api-reference/x/market-signals) · [Viral score](/api-reference/x/viral-score) · [Classify posts](/api-reference/x/classify-tweets)
* Engagement: [Tweet replies](/api-reference/x/tweet-replies) · [Quote tweets](/api-reference/x/tweet-quotes) · [Likers](/api-reference/x/favoriters) · [Reposters](/api-reference/x/retweeters) · [Reposter IDs](/api-reference/x/retweeter-ids) · [Check repost](/api-reference/x/tweet-repost-check)
* Profiles: [User tweets](/api-reference/x/user-tweets) · [Batch user tweets](/api-reference/x/batch-user-tweets) · [User replies](/api-reference/x/user-replies) · [User likes](/api-reference/x/user-likes) · [User media](/api-reference/x/user-media) · [User highlights](/api-reference/x/user-highlights) · [User articles](/api-reference/x/user-articles)
* Feeds: [List tweets](/api-reference/x/list-tweets) · [Trends](/api-reference/x/trends) · [Trends history](/api-reference/x/trends-history) · [Top tweets](/api-reference/x/top-tweets) · [Trend locations](/api-reference/x/trend-locations) · [Search Spaces](/api-reference/x/search-spaces) · [Get Space](/api-reference/x/get-space) · [Space replay](/api-reference/x/space-replay) · [Get broadcast](/api-reference/x/get-broadcast) · [User live status](/api-reference/x/user-live-status) · [Notes contributor](/api-reference/x/community-notes-contributor) · [Contributor notes](/api-reference/x/community-notes-contributor-notes) · [Deleted notes](/api-reference/x/community-notes-contributor-deleted-notes) · [Hashflags](/api-reference/x/hashflags) · [Search places](/api-reference/x/search-places) · [Download media](/api-reference/x/download-media)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.