Skip to main content
GET
/
agent-delegation-invitations
List agent delegation invitations
curl --request GET \
  --url https://api.natural.co/agent-delegation-invitations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "type": "delegation_invitation",
      "id": "din_019cd3444a747fc494656a587201f193",
      "attributes": {
        "customer_email": "customer@example.com",
        "status": "PENDING",
        "permissions": [
          "payments.create",
          "wallets.read"
        ],
        "expires_at": "2026-02-07T00:00:00Z",
        "token": null,
        "magic_link": null,
        "created_at": "2026-01-31T00:00:00Z"
      },
      "relationships": {
        "delegated_party": {
          "data": {
            "type": "party",
            "id": "pty_019cd1798d617f65a79cb965dda9eac3"
          }
        },
        "delegating_party": null
      }
    }
  ],
  "meta": {
    "pagination": {
      "has_more": false,
      "next_cursor": null
    }
  }
}

Authorizations

Authorization
string
header
required

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

Headers

X-Agent-ID
string | null

Agent ID (agt_xxx) identifying which agent is making the request.

X-Instance-ID
string | null

Agent session/conversation ID for observability.

Maximum string length: 1024

Query Parameters

status
string | null

Filter by status

limit
integer
default:50

Maximum results per page

Required range: 1 <= x <= 100
cursor
string | null

Cursor for pagination

Response

Successful Response

List of delegation invitations response.

data
DelegationInvitationResource · object[]
required

List of resources

meta
ResponseMeta · object

Response metadata