Message list - AiToEarn Open Platform

GET

/

api

/

ai

/

agent

/

sessions

/

{sessionId}

/

messages

Message list

curl --request GET \
  --url https://aitoearn.cn/api/ai/agent/sessions/{sessionId}/messages \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://aitoearn.cn/api/ai/agent/sessions/{sessionId}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://aitoearn.cn/api/ai/agent/sessions/{sessionId}/messages"

	req, _ := http.NewRequest("GET", url, nil)

	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))

}

{
  "code": 0,
  "message": "Request succeeded",
  "data": [
    {
      "id": "string",
      "sessionId": "string",
      "message": {
        "id": "string",
        "role": "system",
        "parts": [
          {}
        ]
      },
      "createdAt": "2026-07-02T12:00:00.000Z",
      "runId": "string",
      "stepNumber": 1
    }
  ]
}

Authorizations

X-Api-Key

string

header

required

Need to get API Key from AiToEarn. Click to go to "API Key Obtaining Tutorial".

Path Parameters

sessionId

string

required

Session ID.

Response

200 - application/json

The request has been processed by the service. Business success is determined by whether the response body has code === 0.

code

integer

required

Business status code. 0 means success; non-zero means a business error.

message

string

required

Response message.

data

object[]

Session message list.

Hide child attributes

data.id

string

required

Message ID.

data.sessionId

string

required

Owning session ID.

data.message

object

required

AI SDK UI Message。

Hide child attributes

data.message.id

string

required

UI message ID.

data.message.role

enum<string>

required

Message role.

Available options:

system,

user,

assistant

data.message.parts

object[]

required

Message parts. Fields vary by part type.

data.createdAt

string<date-time>

required

Created at.

data.runId

string

Associated run ID.

data.stepNumber

integer

Associated step number, starting at 0.

requestId

string

Request ID.

timestamp

integer

Error response timestamp in Unix milliseconds.

Message list

curl --request GET \
  --url https://aitoearn.cn/api/ai/agent/sessions/{sessionId}/messages \
  --header 'X-Api-Key: <api-key>'

const options = {method: 'GET', headers: {'X-Api-Key': '<api-key>'}};

fetch('https://aitoearn.cn/api/ai/agent/sessions/{sessionId}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://aitoearn.cn/api/ai/agent/sessions/{sessionId}/messages"

	req, _ := http.NewRequest("GET", url, nil)

	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))

}

{
  "code": 0,
  "message": "Request succeeded",
  "data": [
    {
      "id": "string",
      "sessionId": "string",
      "message": {
        "id": "string",
        "role": "system",
        "parts": [
          {}
        ]
      },
      "createdAt": "2026-07-02T12:00:00.000Z",
      "runId": "string",
      "stepNumber": 1
    }
  ]
}