API reference
Base URL https://stellar-split-sooty.vercel.app/v1. JSON in, JSON out. Amounts are decimal strings. Errors are { "error": { "code", "message", "details"? } }. Examples use $TOKEN for your session token.
There are no /v1/approvals or /v1/agents/:id policy routes. Approvals and per-agent policies are planned. See Agents.
Meta
GET /v1/health
Liveness check.
Auth: None
| Status | Code | When |
|---|---|---|
200 | API is up |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/health"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/health', {
method: 'GET',
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/health",
timeout=15,
)
print(res.status_code, res.json()){
"status": "ok",
"network": "testnet"
}
Auth
POST /v1/auth/challenge
Issues a SEP-53 sign-in message for an address. Valid 5 minutes, single use.
Auth: None
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | body | string | Yes | Stellar G address |
| Status | Code | When |
|---|---|---|
200 | Challenge issued | |
400 | INVALID_ADDRESS | Not a valid G address |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/auth/challenge" \
-H "Content-Type: application/json" \
-d '{"address":"GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/auth/challenge', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/auth/challenge",
json={
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI"
},
timeout=15,
)
print(res.status_code, res.json()){
"challenge": "Stellar-Split sign-in\nAddress: G...\nNonce: ...\nExpires: 2026-10-26T08:05:00.000Z",
"expiresAt": "2026-10-26T08:05:00.000Z"
}
POST /v1/auth/verify
Exchanges a signed challenge for a 12-hour session.
Auth: None
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | body | string | Yes | Same address as the challenge |
challenge | body | string | Yes | The exact challenge text |
signature | body | string | Yes | SEP-53 signature, base64 or hex |
| Status | Code | When |
|---|---|---|
200 | Session issued | |
401 | UNAUTHORIZED | Bad signature, address or challenge, expired, or already used |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/auth/verify" \
-H "Content-Type: application/json" \
-d '{"address":"GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI","challenge":"<challenge>","signature":"<base64>"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/auth/verify', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"challenge": "<challenge>",
"signature": "<base64>"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/auth/verify",
json={
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"challenge": "<challenge>",
"signature": "<base64>"
},
timeout=15,
)
print(res.status_code, res.json()){
"session": {
"token": "<token>",
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"expiresAt": "2026-10-26T20:00:00.000Z"
}
}
Profile
GET /v1/me
Your profile. Defaults when you have not saved one.
Auth: Bearer session or agent token
| Status | Code | When |
|---|---|---|
200 | Profile | |
401 | UNAUTHORIZED | No or expired token |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/me" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/me', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/me",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"displayName": null,
"homeCurrency": "USD",
"email": null
}
PATCH /v1/me
Updates your profile. Send only the fields you change.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
displayName | body | string | No | Up to 60 characters |
homeCurrency | body | string | No | 3-letter code, for example EUR |
email | body | string | null | No | Email or null |
| Status | Code | When |
|---|---|---|
200 | Updated profile | |
400 | VALIDATION | A field is invalid |
curl -sS -X PATCH "https://stellar-split-sooty.vercel.app/v1/me" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"displayName":"Ana","homeCurrency":"EUR"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/me', {
method: 'PATCH',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"displayName": "Ana",
"homeCurrency": "EUR"
}),
});
const data = await res.json();import requests
res = requests.patch(
"https://stellar-split-sooty.vercel.app/v1/me",
headers={"Authorization": f"Bearer {token}"},
json={
"displayName": "Ana",
"homeCurrency": "EUR"
},
timeout=15,
)
print(res.status_code, res.json()){
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"displayName": "Ana",
"homeCurrency": "EUR",
"email": null
}
Groups and members
GET /v1/groups
Your groups with your net in each. totals covers USDC groups; otherTotals lists other assets separately, because dollars and euros never add up.
Auth: Bearer session or agent token
| Status | Code | When |
|---|---|---|
200 | List |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/groups" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/groups",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"groups": [
{
"id": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"name": "Lisbon trip",
"type": "trip",
"asset": "USDC",
"memberCount": 3,
"myNet": "-21.00",
"updatedAt": "2026-10-26T07:55:00.000Z"
}
],
"totals": {
"youOwe": "21.00",
"youAreOwed": "0.00"
},
"otherTotals": []
}
POST /v1/groups
Creates a group. You join as the first member.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
name | body | string | Yes | Up to 80 characters |
type | body | string | No | flat, trip or other (default) |
asset | body | string | No | USDC (default) or EURC when enabled |
displayName | body | string | No | Your name in this group |
| Status | Code | When |
|---|---|---|
201 | Group detail | |
400 | VALIDATION | Bad name or field |
400 | ASSET_NOT_SUPPORTED | Asset not configured on this server |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name":"Lisbon trip","type":"trip"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"name": "Lisbon trip",
"type": "trip"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups",
headers={"Authorization": f"Bearer {token}"},
json={
"name": "Lisbon trip",
"type": "trip"
},
timeout=15,
)
print(res.status_code, res.json()){
"group": {
"id": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"name": "Lisbon trip",
"type": "trip",
"asset": {
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
},
"network": "testnet",
"createdAt": "2026-10-26T07:40:00.000Z"
},
"members": [
{
"id": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"kind": "human",
"displayName": "GAAQ…OBQ2",
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"homeCurrency": "EUR"
}
],
"me": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"balances": [
{
"memberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"net": "0.00"
}
],
"myPosition": {
"net": "0.00",
"owes": [],
"owed": []
},
"expenseCount": 0
}
GET /v1/groups/:id
Group, members, balances and your suggested transfers.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
| Status | Code | When |
|---|---|---|
200 | Group detail | |
404 | NOT_FOUND | Missing group or you are not a member |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"group": {
"id": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"name": "Lisbon trip",
"type": "trip",
"asset": {
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
},
"network": "testnet",
"createdAt": "2026-10-26T07:40:00.000Z"
},
"members": [
{
"id": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"kind": "human",
"displayName": "GAAQ…OBQ2",
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"homeCurrency": "EUR"
}
],
"me": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"balances": [
{
"memberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"net": "0.00"
}
],
"myPosition": {
"net": "0.00",
"owes": [],
"owed": []
},
"expenseCount": 0
}
POST /v1/groups/:id/members
Adds a member by Stellar address.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
address | body | string | Yes | G address |
displayName | body | string | No | Defaults to the short address |
kind | body | string | No | human (default) or agent |
| Status | Code | When |
|---|---|---|
201 | Member added | |
400 | INVALID_ADDRESS | Bad address |
400 | VALIDATION | Group already has 50 members |
409 | ALREADY_MEMBER | Address is already in the group |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/members" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"address":"GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC","displayName":"Rui"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/members', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"address": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"displayName": "Rui"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/members",
headers={"Authorization": f"Bearer {token}"},
json={
"address": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"displayName": "Rui"
},
timeout=15,
)
print(res.status_code, res.json()){
"member": {
"id": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"kind": "human",
"displayName": "Rui",
"address": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"homeCurrency": "USD",
"createdAt": "2026-10-26T07:45:00.000Z"
}
}
POST /v1/groups/:id/invites
Creates an invite link. With address, only that wallet can accept it.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
address | body | string | No | Bind the invite to one G address |
| Status | Code | When |
|---|---|---|
201 | Invite created | |
400 | INVALID_ADDRESS | Bad address |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/invites" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/invites', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/invites",
headers={"Authorization": f"Bearer {token}"},
json={},
timeout=15,
)
print(res.status_code, res.json()){
"inviteUrl": "https://stellar-split-sooty.vercel.app/invite/Zk3pQ9xR2mTa",
"code": "Zk3pQ9xR2mTa"
}
POST /v1/invites/:code/accept
Joins the group of an invite. Safe to call twice.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
code | path | string | Yes | Invite code |
| Status | Code | When |
|---|---|---|
200 | Joined, or already a member | |
404 | NOT_FOUND | Unknown invite, or bound to another address |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/invites/Zk3pQ9xR2mTa/accept" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/invites/Zk3pQ9xR2mTa/accept', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/invites/Zk3pQ9xR2mTa/accept",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"alreadyMember": false
}
Expenses and balances
GET /v1/groups/:id/expenses
Expenses, newest first.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
| Status | Code | When |
|---|---|---|
200 | List | |
404 | NOT_FOUND | Not a member |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/expenses" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/expenses', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/expenses",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"expenses": [
{
"id": "e7c1...",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"description": "Dinner",
"amount": "42.00",
"paidBy": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"split": {
"type": "equal",
"participants": [
"a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f"
]
},
"shares": [
{
"memberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"amount": "21.00"
},
{
"memberId": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00"
}
],
"source": "manual",
"createdBy": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"createdAt": "2026-10-26T07:50:00.000Z"
}
]
}
POST /v1/groups/:id/expenses
Records an expense with an equal or exact split. Repeating a request with the same Idempotency-Key in the group returns the first expense instead of a duplicate.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
Idempotency-Key | header | string | No | 8 to 64 of A-Z a-z 0-9 - _ |
description | body | string | Yes | Up to 200 characters |
amount | body | string | Yes | Positive, at most 7 decimals |
paidBy | body | string | Yes | Member id |
split | body | object | Yes | { type: "equal", participants } or { type: "exact", shares: [{ memberId, amount }] } |
source | body | string | No | manual or scan; agents always get agent |
| Status | Code | When |
|---|---|---|
201 | Expense created | |
400 | VALIDATION | Bad field or Idempotency-Key |
422 | SPLIT_MISMATCH | Exact shares do not add up; see details.difference |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/expenses" \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: dinner-2026-10-26" \
-H "Content-Type: application/json" \
-d '{"description":"Dinner","amount":"42.00","paidBy":"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f","split":{"type":"equal","participants":["a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c","c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f"]}}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/expenses', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Idempotency-Key': 'dinner-2026-10-26', 'Content-Type': 'application/json' },
body: JSON.stringify({
"description": "Dinner",
"amount": "42.00",
"paidBy": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"split": {
"type": "equal",
"participants": [
"a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f"
]
}
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/expenses",
headers={"Authorization": f"Bearer {token}", "Idempotency-Key": "dinner-2026-10-26"},
json={
"description": "Dinner",
"amount": "42.00",
"paidBy": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"split": {
"type": "equal",
"participants": [
"a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f"
]
}
},
timeout=15,
)
print(res.status_code, res.json()){
"expense": {
"id": "e7c1...",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"description": "Dinner",
"amount": "42.00",
"paidBy": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"split": {
"type": "equal",
"participants": [
"a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f"
]
},
"shares": [
{
"memberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"amount": "21.00"
},
{
"memberId": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00"
}
],
"source": "manual",
"createdBy": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"createdAt": "2026-10-26T07:50:00.000Z"
}
}
GET /v1/groups/:id/balances
Net per member with address and kind.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
| Status | Code | When |
|---|---|---|
200 | Balances |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/balances" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/balances', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/balances",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"balances": [
{
"memberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"displayName": "Ana",
"address": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"kind": "human",
"net": "-21.00"
},
{
"memberId": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"displayName": "Rui",
"address": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"kind": "human",
"net": "21.00"
}
]
}
GET /v1/groups/:id/activity
Expenses and settlements together, newest first. Settlements include an explorerUrl.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
| Status | Code | When |
|---|---|---|
200 | Items |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/activity" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/activity', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/activity",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"items": [
{
"id": "f2a1...",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"from": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00",
"txHash": "3c9e...a1",
"intentId": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"createdAt": "2026-10-26T08:01:12.000Z",
"type": "settlement",
"explorerUrl": "https://stellar.expert/explorer/testnet/tx/3c9e...a1"
}
]
}
POST /v1/groups/:id/receipts/scan
Demo. Reads a receipt photo into a draft expense. Creates nothing. The photo and the reading are not stored. Use sample receipts only.
Auth: Bearer session or agent token, checked before the body is read
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
imageBase64 | body | string | Yes | JPEG, PNG or WebP, at most 1.4 million base64 characters |
mimeType | body | string | Yes | image/jpeg, image/png or image/webp |
| Status | Code | When |
|---|---|---|
200 | Draft | |
401 | UNAUTHORIZED | No token |
413 | VALIDATION | Photo too large |
422 | NOT_A_RECEIPT | Not a receipt |
422 | SCAN_UNREADABLE | Total could not be read |
429 | RATE_LIMITED | More than 10 scans in 10 minutes |
503 | SCAN_UNAVAILABLE | Reader not set up, down or out of quota |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/receipts/scan" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"imageBase64":"<base64>","mimeType":"image/jpeg"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/receipts/scan', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"imageBase64": "<base64>",
"mimeType": "image/jpeg"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/receipts/scan",
headers={"Authorization": f"Bearer {token}"},
json={
"imageBase64": "<base64>",
"mimeType": "image/jpeg"
},
timeout=15,
)
print(res.status_code, res.json()){
"draft": {
"merchant": "Cervejaria",
"date": "2026-10-25",
"currency": "USD",
"total": "42.00",
"usdc": "42.00",
"items": [
{
"name": "Dinner",
"amount": "42.00"
}
],
"warnings": []
}
}
Settlements
POST /v1/groups/:id/settlements?dry_run=true
Payment terms for paying to, without reserving or recording anything. Agent caps apply.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
dry_run | query | string | Yes | true |
to | body | string | Yes | Creditor member id |
amount | body | string | Yes | Amount to pay |
| Status | Code | When |
|---|---|---|
200 | Terms | |
403 | AGENT_CAP_PER_PAYMENT | Or _PER_DAY, _PER_MONTH |
422 | OVERPAY | More than you owe |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements?dry_run=true" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"to":"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f","amount":"21.00"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements?dry_run=true', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements?dry_run=true",
headers={"Authorization": f"Bearer {token}"},
json={
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00"
},
timeout=15,
)
print(res.status_code, res.json()){
"intent": {
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"from": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00",
"asset": {
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
},
"network": "stellar:testnet",
"payFrom": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"payTo": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC"
}
}
POST /v1/groups/:id/settlements/intents
Step 1: reserves a settlement intent for 10 minutes. An agent token may send onBehalfOf (its linked owner's member id) to pay the owner's debt from the agent account.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
to | body | string | Yes | Creditor member id |
amount | body | string | Yes | Amount |
onBehalfOf | body | string | No | Agent only: owner member id |
| Status | Code | When |
|---|---|---|
201 | Intent reserved | |
403 | NOT_LINKED | Agent not linked to that member |
403 | AGENT_CAP_PER_PAYMENT | Or _PER_DAY, _PER_MONTH |
409 | INTENT_IN_PROGRESS | Payer or creditor has another reserved intent |
422 | OVERPAY | More than you owe |
503 | ASSET_UNAVAILABLE | Group asset not configured |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"to":"c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f","amount":"21.00"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents",
headers={"Authorization": f"Bearer {token}"},
json={
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00"
},
timeout=15,
)
print(res.status_code, res.json()){
"intent": {
"id": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"from": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00",
"asset": {
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
},
"network": "stellar:testnet",
"payFrom": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"payer": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"debtorMemberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"payTo": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"memo": {
"type": "hash",
"value": "9b1f...e4"
},
"status": "reserved",
"reservedAt": "2026-10-26T08:00:00.000Z",
"expiresAt": "2026-10-26T08:10:00.000Z"
}
}
POST /v1/groups/:id/settlements
Step 2: records the payment once Horizon confirms it. to and amount may be sent and must match the intent.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
intentId | body | string | Yes | Reserved intent id |
txHash | body | string | Yes | Testnet transaction hash |
| Status | Code | When |
|---|---|---|
201 | Settlement recorded | |
404 | INTENT_NOT_FOUND | No such intent for you |
409 | DUPLICATE_TX | Hash already recorded |
409 | INTENT_NOT_OPEN | Intent settled or in review |
409 | NEEDS_REVIEW | Paid, but no longer matches an open debt |
422 | PAYMENT_MISMATCH | And the other verification codes in Errors |
502 | UPSTREAM_UNAVAILABLE | Horizon or the database did not answer; retry |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"intentId":"0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e","txHash":"3c9e...a1"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"intentId": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"txHash": "3c9e...a1"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements",
headers={"Authorization": f"Bearer {token}"},
json={
"intentId": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"txHash": "3c9e...a1"
},
timeout=15,
)
print(res.status_code, res.json()){
"settlement": {
"id": "f2a1...",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"from": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00",
"txHash": "3c9e...a1",
"intentId": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"createdAt": "2026-10-26T08:01:12.000Z"
}
}
POST /v1/groups/:id/settlements/intents/:intentId/cancel
Cancels a reserved intent. Only its payer can cancel.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
intentId | path | string | Yes | Intent id |
| Status | Code | When |
|---|---|---|
200 | Cancelled intent | |
404 | INTENT_NOT_FOUND | Not yours or missing |
409 | INTENT_NOT_OPEN | Not reserved any more |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/cancel" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/cancel', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/cancel",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"intent": {
"id": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"groupId": "6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88",
"from": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"to": "c9d8e7f6-5a4b-4c3d-9e2f-1a0b9c8d7e6f",
"amount": "21.00",
"asset": {
"code": "USDC",
"issuer": "GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5"
},
"network": "stellar:testnet",
"payFrom": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"payer": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"debtorMemberId": "a3e1b7c2-0d4f-4e5a-8b9c-1d2e3f4a5b6c",
"payTo": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"memo": {
"type": "hash",
"value": "9b1f...e4"
},
"status": "cancelled",
"reservedAt": "2026-10-26T08:00:00.000Z",
"expiresAt": "2026-10-26T08:10:00.000Z"
}
}
POST /v1/groups/:id/settlements/intents/:intentId/x402
x402-style handshake for the intent payer, self-verified (no facilitator). Without PAYMENT-SIGNATURE: 402 with the terms in the body and, base64, in the PAYMENT-REQUIRED header. With it (base64 JSON { x402Version: 1, scheme: "exact", network: "stellar:testnet", payload: { txHash } }): the same Horizon check as step 2, then 200 with a PAYMENT-RESPONSE header. A payment that fails the check answers 402 again with error set.
Auth: Bearer session or agent token
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | Yes | Group id |
intentId | path | string | Yes | Intent id |
PAYMENT-SIGNATURE | header | string | No | Base64 JSON with the transaction hash |
| Status | Code | When |
|---|---|---|
402 | Terms, or a failed check | |
200 | Settlement recorded | |
404 | INTENT_NOT_FOUND | Not the payer |
409 | INTENT_NOT_OPEN | Expired or closed |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/x402" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/x402', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/x402",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"x402Version": 1,
"error": null,
"accepts": [
{
"scheme": "exact",
"network": "stellar:testnet",
"asset": "USDC:GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5",
"payTo": "GAVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUKRKFIVCUPVC",
"amount": "21.00",
"maxTimeoutSeconds": 540,
"resource": "https://stellar-split-sooty.vercel.app/v1/groups/6f1c2a90-3b1e-4d7a-9a51-2f0c7e1d4b88/settlements/intents/0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e/x402",
"extra": {
"intentId": "0b6f7c1e-2d3a-4b5c-9d8e-7f6a5b4c3d2e",
"memoType": "hash",
"memo": "9b1f...e4",
"expiresAt": "2026-10-26T08:10:00.000Z"
}
}
]
}
Agent links
POST /v1/agents/link/challenge
Issues a link message for one of the operator's registered agent addresses. You sign it with SEP-53. Valid 5 minutes, single use.
Auth: Bearer session of a person (agent tokens get 403)
| Name | In | Type | Required | Description |
|---|---|---|---|---|
agentAddress | body | string | Yes | Agent G address, listed in AGENT_TOKENS |
| Status | Code | When |
|---|---|---|
200 | Link message | |
400 | INVALID_ADDRESS | Bad address |
400 | VALIDATION | Your own address |
400 | AGENT_NOT_REGISTERED | Not a registered agent |
403 | FORBIDDEN | Called with an agent token |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/agents/link/challenge" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"agentAddress":"GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/agents/link/challenge', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"agentAddress": "GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/agents/link/challenge",
headers={"Authorization": f"Bearer {token}"},
json={
"agentAddress": "GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2"
},
timeout=15,
)
print(res.status_code, res.json()){
"message": "Stellar Split agent link\nOwner: GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI\nAgent: GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2\nNonce: ...\nExpires: 2026-10-26T08:05:00.000Z",
"nonce": "...",
"expiresAt": "2026-10-26T08:05:00.000Z"
}
POST /v1/agents/link
Links the agent to you with the signed message.
Auth: Bearer session of a person (agent tokens get 403)
| Name | In | Type | Required | Description |
|---|---|---|---|---|
agentAddress | body | string | Yes | Agent address |
message | body | string | Yes | The exact link message |
signature | body | string | Yes | SEP-53 signature |
| Status | Code | When |
|---|---|---|
201 | Linked | |
400 | LINK_INVALID | Bad, expired or reused signature |
409 | AGENT_ALREADY_LINKED | Another owner has an active link |
curl -sS -X POST "https://stellar-split-sooty.vercel.app/v1/agents/link" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"agentAddress":"GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2","message":"<message>","signature":"<base64>"}'const res = await fetch('https://stellar-split-sooty.vercel.app/v1/agents/link', {
method: 'POST',
headers: { Authorization: 'Bearer ' + token, 'Content-Type': 'application/json' },
body: JSON.stringify({
"agentAddress": "GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2",
"message": "<message>",
"signature": "<base64>"
}),
});
const data = await res.json();import requests
res = requests.post(
"https://stellar-split-sooty.vercel.app/v1/agents/link",
headers={"Authorization": f"Bearer {token}"},
json={
"agentAddress": "GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2",
"message": "<message>",
"signature": "<base64>"
},
timeout=15,
)
print(res.status_code, res.json()){
"agent": {
"address": "GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2",
"ownerAddress": "GADQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOBYHA4DQOZPI",
"linkedAt": "2026-10-26T08:02:00.000Z"
}
}
GET /v1/me/agents
Your linked agents, including revoked ones.
Auth: Bearer session of a person (agent tokens get 403)
| Status | Code | When |
|---|---|---|
200 | List | |
403 | FORBIDDEN | Agent token |
curl -sS -X GET "https://stellar-split-sooty.vercel.app/v1/me/agents" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/me/agents', {
method: 'GET',
headers: { Authorization: 'Bearer ' + token },
});
const data = await res.json();import requests
res = requests.get(
"https://stellar-split-sooty.vercel.app/v1/me/agents",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code, res.json()){
"agents": [
{
"address": "GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2",
"linkedAt": "2026-10-26T08:02:00.000Z",
"revokedAt": null
}
]
}
DELETE /v1/me/agents/:address
Revokes a link.
Auth: Bearer session of a person (agent tokens get 403)
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | path | string | Yes | Agent G address |
| Status | Code | When |
|---|---|---|
204 | Revoked, no body | |
404 | NOT_FOUND | No active link |
curl -sS -X DELETE "https://stellar-split-sooty.vercel.app/v1/me/agents/GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2" \
-H "Authorization: Bearer $TOKEN"const res = await fetch('https://stellar-split-sooty.vercel.app/v1/me/agents/GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2', {
method: 'DELETE',
headers: { Authorization: 'Bearer ' + token },
});
const data = res.status // 204, no body;import requests
res = requests.delete(
"https://stellar-split-sooty.vercel.app/v1/me/agents/GBRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWGY3DMNRWHOI2",
headers={"Authorization": f"Bearer {token}"},
timeout=15,
)
print(res.status_code) # 204// 204 No Content