Operations for a profile

GET/api/v1/profiles/{handle}/operations

Cursor-paginated operations for a profile with completeness metadata. When database is available, exact total is reported; when fallback answered, total is null and cursor stops at cap.

Parameters

Parameters
Name	In	Type	Description
handle	path	string	Handle to look up (case-insensitive).
cursor?	query	string	Opaque pagination cursor from meta.nextCursor.
limit?	query	integer	Number of operations to return (default 25, max 100).

Example request

curl example

curl -s -H "Accept: application/json" "https://signet-web-pearl.vercel.app/api/v1/profiles/alice/operations?limit=25"

@signet/sdk example

import { SignetClient } from '@signet/sdk';

const signet = new SignetClient({ baseUrl: 'https://signet-web-pearl.vercel.app' });
const result = await signet.listOperations('alice', { limit: 25 });

Responses

200 · Paginated list of operations.

Fields of a 200 response
Field	Type	Description
data	Operation[]
contract?	string \| null	Contract address if an invocation, otherwise null.
createdAt	string	ISO-8601 UTC timestamp.
function?	string \| null	Contract function name if an invocation, otherwise null.
id	string	Unique identifier for the operation.
sourceAccount?	string	Account that initiated or authorized the transaction.
successful	boolean	Whether the transaction succeeded on-chain.
txHash	string	Hex transaction hash.
type	string	Operation type (e.g. 'invoke_host_function', 'payment').
meta	object
cap	integer \| null	Cap applied to the read, or null.
nextCursor	string \| null	Opaque cursor for the next page, or null.
source	string	Layer that answered ('database' or 'horizon').
total	integer \| null	Exact total count when database answered, otherwise null.
truncated	boolean	Whether records were capped.

400 · Invalid handle or pagination parameters.

404 · No profile for this handle.

429 · Rate limit exceeded.

500 · Internal server error.

Example response

Generated from the schema; real values differ.

example response

{
  "data": [
    {
      "contract": "CAMYYJCHOQZSTF2KF6WY4UMFXS75VI46NEGKWE6XHWFULYD46BE5EUXZ",
      "createdAt": "2026-09-20T12:00:00.000Z",
      "function": "string",
      "id": "string",
      "sourceAccount": "GA5ZSEJYB37JRC5AVCIA5MOP4RHTM335X2KGX3IHOJAPP5RE34K4KZVN",
      "successful": false,
      "txHash": "string",
      "type": "string"
    }
  ],
  "meta": {
    "cap": 3,
    "nextCursor": "string",
    "source": "string",
    "total": 3,
    "truncated": false
  }
}