Intent

List intent actions

Returns the append-only action history for an intent in the resolved organization, latest action first by default. Pass sort_direction=asc to replay the lineage in the order it was appended, and trading_account_id to require that the intent belongs to that account. If no actions exist for that intent, the response is 200 with an empty data array. Service-account callers must provide x-organization-id and have intent:read; API-key callers need organization intent read permission; user callers need an organization admin, member, or read-only role. Non-service callers can only read their principal organization, and a supplied trading account must belong to the resolved organization.

GET

intents

{intent_id}

actions

List intent actions

curl --request GET \
  --url https://api.anthid.com/v1/intents/{intent_id}/actions \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.anthid.com/v1/intents/{intent_id}/actions', 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.anthid.com/v1/intents/{intent_id}/actions",
  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.anthid.com/v1/intents/{intent_id}/actions"

	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.anthid.com/v1/intents/{intent_id}/actions")

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

{
  "data": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "intent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": "<string>",
      "seq": 123,
      "symbol": "<string>",
      "client_reference_id": "<string>",
      "limit_price": "<string>",
      "stop_price": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

Authorizations

Authorization

string

header

required

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

Headers

x-organization-id

string<uuid> | null

Organization id required when reading with service-account credentials

Path Parameters

intent_id

string<uuid>

required

Intent id whose actions should be listed

Query Parameters

trading_account_id

string<uuid>

Optional trading account the intent must belong to. Omitted reads across the whole organization.

next_cursor

string

Sequence cursor returned by a previous response

limit

integer

Maximum number of actions to return. Values are clamped to the range 1 through 100.

Required range: x >= 0

time_window

enum<string>

Optional relative trailing window. Only actions created inside it are returned. Omitted means the intent's whole history.

Available options:

last_hour,

last_day,

last_week,

last_month,

last_year

sort_direction

enum<string>

Sequence order to return actions in. Defaults to desc, the latest action first. A next_cursor is only valid for the direction that produced it.

Available options:

Asc,

Desc

Response

Intent actions retrieved

data

object[]

required

Show child attributes

next_cursor

string | null

Submit intentAppends a create, replace, or cancel trading intent for the trading account named in the request body. Submission is authorized for API-key callers that belong to the account organization and have organization intent edit permission. Create intents on live accounts additionally require the Trading Live entitlement and must pass controls evaluation before an action and outbox record are written.

List intent actions

curl --request GET \
  --url https://api.anthid.com/v1/intents/{intent_id}/actions \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api.anthid.com/v1/intents/{intent_id}/actions', 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.anthid.com/v1/intents/{intent_id}/actions",
  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.anthid.com/v1/intents/{intent_id}/actions"

	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.anthid.com/v1/intents/{intent_id}/actions")

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

{
  "data": [
    {
      "account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "intent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "quantity": "<string>",
      "seq": 123,
      "symbol": "<string>",
      "client_reference_id": "<string>",
      "limit_price": "<string>",
      "stop_price": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

{
  "EncryptionError": "<string>"
}

Connections

Organizations

Controls

Accounts

Intents

Ledger

Stream

List intent actions

Authorizations

Headers

Path Parameters

Query Parameters

Response