curl --request GET \
--url https://public-api.frictio.ai/v2/messages \
--header 'X-Api-Key: <api-key>' \
--header 'X-Workspace-Id: <x-workspace-id>'import requests
url = "https://public-api.frictio.ai/v2/messages"
headers = {
"X-Workspace-Id": "<x-workspace-id>",
"X-Api-Key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Workspace-Id': '<x-workspace-id>', 'X-Api-Key': '<api-key>'}
};
fetch('https://public-api.frictio.ai/v2/messages', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public-api.frictio.ai/v2/messages",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Workspace-Id: <x-workspace-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://public-api.frictio.ai/v2/messages"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Workspace-Id", "<x-workspace-id>")
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://public-api.frictio.ai/v2/messages")
.header("X-Workspace-Id", "<x-workspace-id>")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.frictio.ai/v2/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Workspace-Id"] = '<x-workspace-id>'
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "0d2f1b7c-3a44-4c8e-9f10-6b5e2d8a4c31",
"header_message_id": "<CAF=abc123@mail.gmail.com>",
"thread_id": "19821a3c9f0b1d2e",
"subject": "Re: 見積のご確認",
"received_at": "2026-08-27T04:12:33.000Z",
"is_internal": false,
"is_group_email": false,
"participants": [
{
"handle": "sato@example.com",
"display_name": "佐藤 花子",
"role": "FROM",
"contact_id": "7a9c4e51-8b26-4d03-9f18-2e6b5c47d90a"
},
{
"handle": "eigyo@syslea.co.jp",
"display_name": null,
"role": "TO",
"contact_id": null
}
]
}
],
"page_info": {
"end_cursor": "<string>",
"has_next_page": true
}
}List messages
ワークスペースに公開されているメッセージを一覧で取得します。
received_at の降順(新しい順)で返却されます。
本文は含みません。本文が必要な場合は GET /v2/messages/{messageId} を
個別に取得してください。それ以外の項目は詳細と同じです。
取得対象は GET /v2/messages/{messageId} と同じです。公開されていない
メッセージは一覧にも現れません。
ページングの継続判定は page_info.has_next_page だけで行ってください。
page_info.end_cursor は最終ページでも null になりません(差分同期の
checkpoint token として使えるようにするためです)。
curl --request GET \
--url https://public-api.frictio.ai/v2/messages \
--header 'X-Api-Key: <api-key>' \
--header 'X-Workspace-Id: <x-workspace-id>'import requests
url = "https://public-api.frictio.ai/v2/messages"
headers = {
"X-Workspace-Id": "<x-workspace-id>",
"X-Api-Key": "<api-key>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {'X-Workspace-Id': '<x-workspace-id>', 'X-Api-Key': '<api-key>'}
};
fetch('https://public-api.frictio.ai/v2/messages', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://public-api.frictio.ai/v2/messages",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-Api-Key: <api-key>",
"X-Workspace-Id: <x-workspace-id>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://public-api.frictio.ai/v2/messages"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Workspace-Id", "<x-workspace-id>")
req.Header.Add("X-Api-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://public-api.frictio.ai/v2/messages")
.header("X-Workspace-Id", "<x-workspace-id>")
.header("X-Api-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://public-api.frictio.ai/v2/messages")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Workspace-Id"] = '<x-workspace-id>'
request["X-Api-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"data": [
{
"id": "0d2f1b7c-3a44-4c8e-9f10-6b5e2d8a4c31",
"header_message_id": "<CAF=abc123@mail.gmail.com>",
"thread_id": "19821a3c9f0b1d2e",
"subject": "Re: 見積のご確認",
"received_at": "2026-08-27T04:12:33.000Z",
"is_internal": false,
"is_group_email": false,
"participants": [
{
"handle": "sato@example.com",
"display_name": "佐藤 花子",
"role": "FROM",
"contact_id": "7a9c4e51-8b26-4d03-9f18-2e6b5c47d90a"
},
{
"handle": "eigyo@syslea.co.jp",
"display_name": null,
"role": "TO",
"contact_id": null
}
]
}
],
"page_info": {
"end_cursor": "<string>",
"has_next_page": true
}
}Authorizations
Headers
ワークスペースID
Query Parameters
1–100(デフォルト30)
1 <= x <= 100次ページ取得用カーソル
メッセージIDでフィルタ(カンマ区切りで最大100件、OR条件)。
各要素は UUID 形式である必要があり、形式が違う場合は 400 になります。
指定した ID のうち取得可能なものだけが返ります。存在しない ID や
公開されていないメッセージの ID を含めてもエラーにはならず、結果から落ちます。
limit を指定しない場合は既定の 30 件で打ち切られます。100 件をまとめて取得する
場合は limit=100 も指定してください。指定しないときは page_info.has_next_page
を見てページングしてください。
スレッドIDで絞り込みます。同一スレッドのメッセージだけを時系列で取得できます。
空文字を指定した場合は 400 になります(絞り込みを要求しているため、未指定として
全件を返しません)。received_from / received_to も同じ扱いです。
取得範囲の開始日時(以上)。ISO 8601 形式で指定してください。
取得範囲の終了日時(以下)。ISO 8601 形式で指定してください。