Home
/
REST API Reference
/
Articles
/
List all articles

List all articles

You can fetch a list of all articles by making a GET request to https://api.intercom.io/articles.

📘 How are the articles sorted and ordered?

Articles will be returned in descending order on the updated_at attribute. This means if you need to iterate through results then we'll show the most recently updated articles first.

SecurityHTTP: bearerAuth
Request
header Parameters
Intercom-Version
string (intercom_version)
Default: 2.10

Intercom API version.
By default, it's equal to the version set in the app package.

Enum: "1.0" "1.1" "1.2" "1.3" "1.4" "2.0" "2.1" "2.2" "2.3" "2.4" "2.5" "2.6" "2.7" "2.8" "2.9" "2.10" "Unstable"
Example: 2.10
get
/articles
Request samples
Responses
200
successful
Response Schema: application/json
type
string 
The type of the object - list.
 Value: "list"  
object or null (Cursor based pages)  
Cursor-based pagination is a technique used in the Intercom API to navigate through large amounts of data. A "cursor" or pointer is used to keep track of the current position in the result set, allowing the API to return the data in small chunks or "pages" as needed.
 
total_count
integer 
A count of the total number of articles.
 
Array of objects (Articles)  
An array of Article objects
 
401
Unauthorized
Response samples
application/json
{
"type": "list",
"pages": {
"type": "pages",
"page": 1,
"per_page": 25,
"total_pages": 1
},
"total_count": 1,
"data": [

]
}