---
title: "List your articles"
method: GET
path: "/api"
tags: ["Publish content"]
---

# List your articles

`GET /api`

## Request

- Base URL: `https://api.opedd.com`
- URL: `https://api.opedd.com/api`
- Auth: HTTP bearer

Your own articles with prices and sales totals, newest first. Up to 100 per page (`limit`, `offset`). `type=ai` shows only articles with an AI price.

## Query parameters

- `action` 'articles', required
- `limit` integer
- `offset` integer
- `type` 'human' | 'ai'

## Response `200`

Paginated list of articles

- object
  - `success` boolean
  - `data` object
    - `articles` ArticleSummary[]
      - `id` string, uuid
      - `title` string
      - `description` string
      - `source_url` string, uri
      - `pricing` object
        - `human` object, nullable
          - `price` number
          - `currency` string
        - `ai` object, nullable
          - `price` number
          - `currency` string
      - `stats` object
        - `human_licenses_sold` integer
        - `ai_licenses_sold` integer
      - `created_at` string, date-time
    - `total` integer: Total number of licensable articles (ignores pagination)
    - `limit` integer
    - `offset` integer

## Other responses

- `401`: Missing or invalid credential

---

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