List Messages

curl --request GET \
  --url https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/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://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/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 => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages"

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

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "messages": [
    {
      "inbox_id": "<string>",
      "thread_id": "<string>",
      "message_id": "<string>",
      "labels": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "size": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "cc": [
        "<string>"
      ],
      "bcc": [
        "<string>"
      ],
      "subject": "<string>",
      "preview": "<string>",
      "attachments": [
        {
          "attachment_id": "<string>",
          "size": 123,
          "filename": "<string>",
          "content_type": "<string>",
          "content_disposition": "inline",
          "content_id": "<string>"
        }
      ],
      "in_reply_to": "<string>",
      "references": [
        "<string>"
      ],
      "headers": {}
    }
  ],
  "limit": 123,
  "next_page_token": "<string>"
}

{
  "name": "<string>",
  "message": "<string>"
}

GET

https://api.aisa.one/apis/v1

agentmail

inboxes

{inbox_id}

messages

List Messages

curl --request GET \
  --url https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/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://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/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 => [
    "Authorization: Bearer <token>"
  ],
]);

$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://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages"

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

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "count": 123,
  "messages": [
    {
      "inbox_id": "<string>",
      "thread_id": "<string>",
      "message_id": "<string>",
      "labels": [
        "<string>"
      ],
      "timestamp": "2023-11-07T05:31:56Z",
      "from": "<string>",
      "to": [
        "<string>"
      ],
      "size": 123,
      "updated_at": "2023-11-07T05:31:56Z",
      "created_at": "2023-11-07T05:31:56Z",
      "cc": [
        "<string>"
      ],
      "bcc": [
        "<string>"
      ],
      "subject": "<string>",
      "preview": "<string>",
      "attachments": [
        {
          "attachment_id": "<string>",
          "size": 123,
          "filename": "<string>",
          "content_type": "<string>",
          "content_disposition": "inline",
          "content_id": "<string>"
        }
      ],
      "in_reply_to": "<string>",
      "references": [
        "<string>"
      ],
      "headers": {}
    }
  ],
  "limit": 123,
  "next_page_token": "<string>"
}

{
  "name": "<string>",
  "message": "<string>"
}

Lists messages in one inbox, newest first. Returns count, limit, next_page_token and messages; page with next_page_token. Each message carries message_id, thread_id, labels, timestamp, from, to, cc, bcc, subject and a preview; full bodies come from get_agentmail_inbox_message. To search rather than page, use get_agentmail_inbox_messages_search; to group by conversation, get_agentmail_inbox_threads.

Example

curl -X GET "https://api.aisa.one/apis/v1/agentmail/inboxes/{inbox_id}/messages" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Authorization

string

required

Bearer authentication

Path Parameters

inbox_id

string

required

The ID of the inbox.

Query Parameters

limit

integer

Limit of number of items returned.

page_token

string

Page token for pagination.

labels

string[]

Labels to filter by.

before

string<date-time>

Timestamp before which to filter by.

after

string<date-time>

Timestamp after which to filter by.

ascending

boolean

Sort in ascending temporal order.

include_spam

boolean

Include spam in results.

include_blocked

boolean

Include blocked in results.

include_unauthenticated

boolean

Include unauthenticated in results.

include_trash

boolean

Include trash in results.

Response

Response with status 200

count

integer

required

Number of items returned.

messages

MessageItem · object[]

required

Ordered by timestamp descending.

Show child attributes

limit

integer

Limit of number of items returned.

next_page_token

string

Page token for pagination.

Overview

Chat API

Embeddings & Rerank

Search API

Perplexity API

Financial API

Twitter API

Reddit API

Instagram API

Pinterest API

Scholar API

WaveInflu API

Prediction Market API

CoinGecko

DataForSEO

AgentMail

Apollo

Ahrefs API

Semrush API

Foreplay API

CNPJá API

Open-Meteo API

SimilarWeb API

Essentials

List Messages

Example

Authorizations

Headers

Path Parameters

Query Parameters

Response

​Example

Authorizations

Headers

Path Parameters

Query Parameters

Response

Example