# List articles

Returns a paginated list of articles within your organization's help center.

Articles are the main content pieces that contain documentation, guides, and FAQs.

### Query Parameters

- limit - Number of items to return (1-100, default 10)
- cursor - Cursor for pagination
- state - Filter by article state: "live", "draft", or "all" (default "live")
- parentId - Filter by parent collection ID

### Response Format

Returns a list object with:
- object - Always "list"
- data - Array of article objects
- nextCursor - Cursor for next page (null if no more results)

### Article Object

Each article includes:
- id - Unique identifier
- title - Article title
- description - Article description
- body - Article content (HTML)
- slug - URL slug
- icon - Article icon (emoji or custom)
- parentId - Parent collection ID
- helpCenterId - ID of the help center this article belongs to
- organization - Organization ID
- state - Article state (live or draft)
- defaultLocale - Default locale for content
- locale - Current locale
- availableLocales - Array of available locales
- publishedLocales - Array of locales where article is published
- featurebaseUrl - Featurebase URL for the article
- externalUrl - External URL if custom domain is configured
- author - Author information (name, authorId, avatarUrl)
- order - Display order
- isPublished - Whether the article is published
- isDraftDiffersFromLive - Whether draft differs from live version
- translations - Translations for different locales
- createdAt - ISO 8601 timestamp when created
- updatedAt - ISO 8601 timestamp when last updated
- liveUpdatedAt - ISO 8601 timestamp when live version was last updated

Endpoint: GET /v2/help_center/articles
Version: 2026-01-01.nova
Security: bearerAuth

## Header parameters:

  - `Featurebase-Version` (string)
    API version for this request. Defaults to your organization's configured API version if not specified.
    Example: "2026-01-01.nova"

## Query parameters:

  - `limit` (integer)
    A limit on the number of objects to be returned, between 1 and 100.
    Example: 10

  - `cursor` (string)
    An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page of results.
    Example: "eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9"

  - `state` (string)
    Filter articles by state. Use "all" to get both draft and live articles.
    Enum: "live", "draft", "all"

  - `parentId` (string)
    Filter articles by parent collection ID
    Example: "6474684"

## Response 200 fields (application/json):

  - `object` (string, required)
    Object type identifier
    Enum: "list"

  - `data` (array, required)
    Array of article objects
    Example: []

  - `data.id` (string, required)
    Article unique identifier
    Example: "1234567"

  - `data.title` (string)
    Article title
    Example: "Getting Started Guide"

  - `data.description` (string)
    Article description
    Example: "Learn how to get started"

  - `data.body` (string)
    Article body content (HTML)
    Example: "<p>Welcome to our guide.</p>"

  - `data.slug` (string)
    URL slug
    Example: "1234567-getting-started-guide"

  - `data.icon` (object,null)
    Article icon

  - `data.icon.type` (string, required)
    Icon type
    Enum: "emoji", "custom"

  - `data.icon.value` (string, required)
    Icon value (emoji or URL)
    Example: "📖"

  - `data.parentId` (string,null)
    Parent collection ID
    Example: "6474684"

  - `data.helpCenterId` (string, required)
    Help Center ID
    Example: "j7c5g8ah3ewxp4lo"

  - `data.organization` (string, required)
    Organization ID
    Example: "6595518396205e06b897ad65"

  - `data.state` (string, required)
    Article state
    Enum: "live", "draft"

  - `data.defaultLocale` (string)
    Default locale
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.locale` (string, required)
    Current locale
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.availableLocales` (array, required)
    Available locales
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.publishedLocales` (array)
    Published locales
    Enum: "bn", "bs", "pt-BR", "bg", "ca", "hr", "cs", "da", "nl", "en", "et", "fi", "fr", "de", "el", "hi", "hu", "id", "it", "ja", "ko", "lv", "lt", "ms", "mn", "nb", "pl", "pt", "ro", "ru", "sr", "zh-CN", "sk", "sl", "es", "sw", "sv", "th", "zh-TW", "tr", "uk", "vi"

  - `data.featurebaseUrl` (string)
    Featurebase URL
    Example: "https://yourorg.featurebase.app/en/help/articles/1234567-getting-started-guide"

  - `data.externalUrl` (string)
    External URL
    Example: "https://help.yourdomain.com/en/articles/1234567-getting-started-guide"

  - `data.author` (object)
    Article author

  - `data.author.name` (string, required)
    Author name
    Example: "John Doe"

  - `data.author.authorId` (string, required)
    Author user ID
    Example: "507f1f77bcf86cd799439011"

  - `data.author.avatarUrl` (string,null)
    Author avatar URL

  - `data.order` (number,null)
    Display order
    Example: 1

  - `data.isPublished` (boolean)
    Whether the article is published
    Example: true

  - `data.isDraftDiffersFromLive` (boolean)
    Whether draft differs from live

  - `data.translations` (object)
    Translations by locale code

  - `data.translations.bn` (object)

  - `data.translations.bn.createdAt` (string)
    ISO 8601 timestamp when translation was created
    Example: "2024-10-18T12:33:09.099Z"

  - `data.translations.bn.updatedAt` (string)
    ISO 8601 timestamp when translation was last updated
    Example: "2024-10-19T14:22:15.123Z"

  - `data.translations.bs` (object)

  - `data.translations.pt-BR` (object)

  - `data.translations.bg` (object)

  - `data.translations.ca` (object)

  - `data.translations.hr` (object)

  - `data.translations.cs` (object)

  - `data.translations.da` (object)

  - `data.translations.nl` (object)

  - `data.translations.en` (object)

  - `data.translations.et` (object)

  - `data.translations.fi` (object)

  - `data.translations.fr` (object)

  - `data.translations.de` (object)

  - `data.translations.el` (object)

  - `data.translations.hi` (object)

  - `data.translations.hu` (object)

  - `data.translations.id` (object)

  - `data.translations.it` (object)

  - `data.translations.ja` (object)

  - `data.translations.ko` (object)

  - `data.translations.lv` (object)

  - `data.translations.lt` (object)

  - `data.translations.ms` (object)

  - `data.translations.mn` (object)

  - `data.translations.nb` (object)

  - `data.translations.pl` (object)

  - `data.translations.pt` (object)

  - `data.translations.ro` (object)

  - `data.translations.ru` (object)

  - `data.translations.sr` (object)

  - `data.translations.zh-CN` (object)

  - `data.translations.sk` (object)

  - `data.translations.sl` (object)

  - `data.translations.es` (object)

  - `data.translations.sw` (object)

  - `data.translations.sv` (object)

  - `data.translations.th` (object)

  - `data.translations.zh-TW` (object)

  - `data.translations.tr` (object)

  - `data.translations.uk` (object)

  - `data.translations.vi` (object)

  - `data.createdAt` (string, required)
    ISO 8601 timestamp when created
    Example: "2024-10-18T12:33:09.099Z"

  - `data.updatedAt` (string, required)
    ISO 8601 timestamp when last updated
    Example: "2024-10-18T13:03:25.921Z"

  - `data.liveUpdatedAt` (string)
    ISO 8601 timestamp when live version was last updated
    Example: "2024-10-18T13:03:25.921Z"

  - `data.path` (string)
    Path to article within help center hierarchy
    Example: "/getting-started"

  - `data.surveyId` (string)
    Associated survey ID
    Example: "6743752ca81ae59d25cf834b"

  - `data.visibleBy` (array)
    Visibility settings
    Example: ["everyone"]

  - `data.translationCreatedAt` (string)
    ISO 8601 timestamp when translation was created
    Example: "2024-10-18T12:33:09.099Z"

  - `data.translationUpdatedAt` (string)
    ISO 8601 timestamp when translation was last updated
    Example: "2024-10-19T14:22:15.123Z"

  - `nextCursor` (string,null, required)
    Cursor for fetching the next page (cursor-based pagination)
    Example: "eyJpZCI6IjY3NDM3NTJjYTgxYWU1OWQyNWNmODM0YiJ9"

## Response 400 fields (application/json):

  - `error` (object, required)

  - `error.type` (string, required)
    The type of error returned
    Enum: "invalid_request_error"

  - `error.code` (string, required)
    Machine-readable error code
    Enum: "invalid_cursor"

  - `error.message` (string, required)
    Human-readable error message
    Example: "An error occurred"

  - `error.param` (string)
    The parameter that caused the error (if applicable)
    Example: "id"

  - `error.status` (number, required)
    HTTP status code
    Enum: 400