Get latest intent action

GET

intents

{intent_id}

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

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

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

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

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

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "action_type": "CREATE",
  "client_reference_id": "order-20260805-001",
  "created_at": "2026-08-05T16:20:00Z",
  "idempotency_key": "order-20260805-001-a3f",
  "intent_id": "550e8400-e29b-41d4-a716-446655440111",
  "limit_price": "215.50",
  "order_side": "BUY",
  "order_type": "LIMIT",
  "organization_id": "550e8400-e29b-41d4-a716-446655440222",
  "principal_id": "an_3Kd91mQ0xVb7LpZs",
  "principal_name": null,
  "principal_type": "API_KEY",
  "quantity": "10",
  "received_at": "2026-08-05T16:20:00Z",
  "request_id": "01930000-0000-7000-8000-000000000000",
  "route_strategy": "SMART",
  "seq": 0,
  "source_ip": "203.0.113.42",
  "state": "SENT",
  "stop_price": null,
  "symbol": "AAPL",
  "time_in_force": "DAY"
}

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

"<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 for service-account credentials

Path Parameters

intent_id

string<uuid>

required

Intent ID

Query Parameters

trading_account_id

string<uuid>

Trading account the intent must belong to

Response

Latest intent action retrieved

An intent action together with how far its dispatch has got.

The action record is the immutable thing that was asked for; the state is the newest entry in its outbox lineage, so it moves as the action is picked up and published. They live in separate tables (the action is appended once, the state is appended per transition) and are joined here rather than leaving callers to correlate two endpoints.

state is None when no outbox row exists yet for the action. That is a real and momentary condition: the action and its first outbox row are written in one transaction, so it only shows up for a read racing that commit, and it is not the same as Pending.

runtime_status is the other half of the answer, and the one callers usually want: state says how far the platform got in handing the order to a broker, and stays SENT forever afterwards. It says nothing about whether the order filled. runtime_status is what the broker reports back.

account_id

string<uuid>

required

action_type

enum<string>

required

Available options:

CREATE,

REPLACE,

CANCEL

created_at

string<date-time>

required

intent_id

string<uuid>

required

order_side

enum<string>

required

Available options:

UNSPECIFIED,

BUY,

SELL,

SELL_SHORT

order_type

enum<string>

required

Available options:

UNSPECIFIED,

LIMIT,

MARKET,

FILL_OR_KILL,

LIMIT_ON_OPEN,

LIMIT_ON_CLOSE,

MARKET_ON_OPEN,

MARKET_ON_CLOSE,

STOP,

STOP_LIMIT,

TRAILING_STOP

organization_id

string<uuid>

required

principal_id

string

required

principal_type

enum<string>

required

Class of credential behind an instruction.

An order placed with an organization's API key, one placed by a person signed in to the dashboard, and one placed by an Anthid service acting on the organization's behalf are three different claims once an order is disputed. Recording only the organization cannot tell them apart.

Available options:

API_KEY,

USER,

SERVICE

quantity

string

required

received_at

string<date-time>

required

request_id

string

required

route_strategy

enum<string>

required

Available options:

UNSPECIFIED,

SMART,

AMEX,

ARCA,

BATS,

BATY,

EDGA,

EDGX,

NSDQ,

NYSE

seq

integer<int64>

required

symbol

string

required

client_reference_id

string | null

idempotency_key

string | null

limit_price

null | string

source_ip

string | null

stop_price

null | string

time_in_force

null | enum<string>

Available options:

UNSPECIFIED,

DAY,

IMMEDIATE_OR_CANCEL,

GOOD_TILL_CANCEL,

AT_OPEN,

AT_CLOSE,

FILL_OR_KILL,

EXT

principal_name

string | null

Who placed it, by name, as it read when the action was taken.

A sibling of the action rather than a field on it, for the same reason state is: IntentActionRecord is the payload dispatched to the broker path, and which person pressed the button is no part of an order. This is the supervisory read, and the only place the name is wanted.

None is the ordinary case for an API key or a service, neither of which has a person to name, and for anything recorded before the name was captured. Callers fall back to the credential class rather than inventing a label.

runtime_status

null | enum<string>

Where the intent stands at the broker.

Per intent rather than per action: an intent has one live order at a time, and a replace does not give the superseded action its own outcome. Every action in a chain therefore reports the same value, which is the truthful rendering of "what became of what I asked for".

None means the broker has not reported on it yet. That covers an order accepted moments ago and still in flight, and it is deliberately not collapsed into PENDING: a null says the platform has heard nothing, where PENDING is the broker saying it has the order and has not worked it. Callers that need one value can treat null as pending; ones that are watching for a stuck order need to tell them apart.

Available options:

PENDING,

OPEN,

PARTIALLY_FILLED,

FILLED,

CANCELLED,

REJECTED

state

null | enum<string>

Latest dispatch state for this action, newest outbox entry first.

Available options:

PENDING,

PROCESSING,

SENT,

FAILED

Get latest intent action

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

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

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

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

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

{
  "account_id": "550e8400-e29b-41d4-a716-446655440000",
  "action_type": "CREATE",
  "client_reference_id": "order-20260805-001",
  "created_at": "2026-08-05T16:20:00Z",
  "idempotency_key": "order-20260805-001-a3f",
  "intent_id": "550e8400-e29b-41d4-a716-446655440111",
  "limit_price": "215.50",
  "order_side": "BUY",
  "order_type": "LIMIT",
  "organization_id": "550e8400-e29b-41d4-a716-446655440222",
  "principal_id": "an_3Kd91mQ0xVb7LpZs",
  "principal_name": null,
  "principal_type": "API_KEY",
  "quantity": "10",
  "received_at": "2026-08-05T16:20:00Z",
  "request_id": "01930000-0000-7000-8000-000000000000",
  "route_strategy": "SMART",
  "seq": 0,
  "source_ip": "203.0.113.42",
  "state": "SENT",
  "stop_price": null,
  "symbol": "AAPL",
  "time_in_force": "DAY"
}

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

"<string>"

Connections

Organizations

Controls

Accounts

Intents

Ledger

Stream

MCP

Get latest intent action

Authorizations

Headers

Path Parameters

Query Parameters

Response