---
schema_version: "1"
id: d4abfc6de4b7532f2dd69ad8ed89e18393678b9e8dbcdd03e9e6e6ad62c8ca9b
title: sObjects Suggested Articles by ID
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform/api-rest/guides/resources/resources-sobject-suggest-articles-id.md
canonical_url: https://developer.salesforce.com/docs/platform/api-rest/guide/resources-sobject-suggest-articles-id.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: a22cf1ef4efcbbf077d9857b58044d7ae3c8a34e9bb42d22a39f58615d3ddd00
products:
  - REST API Developer Guide
  - Platform Developer Content
---

# sObjects Suggested Articles by ID

When you enter an article ID, you can retrieve records that offer similar information as the ID you entered. This resource is available in REST API version 30.0 and later.

Salesforce Knowledge must be enabled in your organization. The user must have the “View Articles” permission enabled. The articles suggested include only the articles the user can access, based on the data categories and article types the user has permissions to view.

Articles are suggested based on a relevance algorithm. The `suggestedArticles` resource is designed to get the IDs of articles relevant to a case, work order, or work order line item. It’s intended to be used with other services that than use the IDs to get article data for display.

## Syntax

**URI:** `/services/data/vXX.X/sobjects/sObject/ID/suggestedArticles?language=articleLanguage`

**Formats:** JSON, XML

**HTTP methods:** GET

**Authentication:** `Authorization: Bearer token`

**Request body:** None required

**Request parameters**

|Parameter|Description|
|---------|-----------|
|`articleTypes`|Optional. Three-character ID prefixes indicating the desired article types. You can specify multiple values for this parameter in a single REST call, by repeating the parameter name for each value. For example, `articleTypes=ka0&articleTypes=ka1`.|
|`categories`|Optional. The name of the data category group and the data category API name (not category title) for desired articles. The syntax is `categories={"Group":"Category"}`. Characters in the URL might need to be encoded. The same data category group can’t be specified more than one time. However, you can specify multiple data category group and data category pairs. For example, `categories={"Regions":"Asia","Products":"Laptops"}.`|
|`description`|Text of the description. Valid only for new records without an existing ID and required if `subject` is null. Article suggestions are based on common keywords in the subject, description, or both.|
|`language`|Required. Language that the article is written in.|
|`limit`|Optional. Specifies the maximum number of suggested articles to return.|
|`publishStatus`|Optional. The article’s publication status. Valid values: `Draft`–Not published, `Online`–Published in Salesforce Knowledge, or `Archived`.|
|`subject`|Text of the subject. Valid only for new records without an existing ID and required if `description` is null. Article suggestions are based on common keywords in the subject, description, or both.|
|`topics`|Optional. The topic of returned articles. For example:` topics=outlook&topics=email`.|
|`validationStatus`|Optional. The validation status of returned articles.|

Example `categories`:

```nolang
categories=%7B%22Regions%22%3A%22Asia%22%2C%22
Products%22%3A%22Laptops%22%7D
```

## Example

**Example Response Body**

```nolang
[ {
  "attributes" : {
    "type" : "KnowledgeArticleVersion",
    "url" : "/services/data/v68.0/sobjects/KnowledgeArticleVersion/ka0D00000004CcQ"
  "Id" : "ka0D00000004CcQ"
}, {
  "attributes" : {
    "type" : "KnowledgeArticleVersion",
    "url" : "/services/data/v68.0/sobjects/KnowledgeArticleVersion/ka0D00000004CXo"
  },
  "Id" : "ka0D00000004CXo"
} ]
```